- 版权类型
- 二次开发
- 插件中文名称
- FlChemdahTheme对话
- 插件英文名称
- FlChemdahTheme
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- Paper
- Purpur
- 语言支持
- 中文(简体)
- 前置组件
- Chemdah
BetterHud
PlaceholderAPI
- 适配版本(Java)
- 1.21
- 1.20
- 1.19
插件概述
基础信息
插件名称:FlChemdahTheme 核心特性
- 多主题配置:支持为不同对话绑定独立的 HUD 样式

- 高级打字机效果:支持小数速度调节,搭配光标动画呈现

- 全场景音效自定义:滚动、确认、打字音效可独立控制开关与参数

- 优化的选项交互:支持自动 / 手动翻页,可设置默认槽位切换规则

- 沉浸式体验:对话期间可配置失明、减速等药水效果

- 灵活的跳过控制:标记禁止跳过当前内容

- 拓展占位符:支持显示 NPC 表情、自定义文本及头像

- 完善的调试支持:可开启详细日志,实现行为追踪与问题定位

安装步骤
- +Q2225937164 有对应Wiki教学
支持为不同对话配置独立的 HUD 样式(含字体、颜色、显示位置、背景样式等),轻松实现对话场景差异化展示,让剧情氛围更贴合主题~
配置方式
在插件配置文件中自定义主题(如默认主题 default、任务主题 quest、NPC 专属主题 npc 等)
在对话配置里通过 theme: 主题名 直接指定使用的样式
主题支持继承机制,可基于默认主题仅修改部分参数,减少重复配置工作量
打字机效果
对话文本将逐字缓缓输出,自带真实打字质感~ 支持小数精度速度调节(例:0.1 = 慢节奏沉浸,0.5 = 均衡流畅,1.0 = 快速高效),搭配灵动光标动画,视觉体验更鲜活,仿佛 NPC 在实时与你对话~
音效自定义
支持滚动、确认、打字 3 类音效全自定义,每类音效都能独立控制开关、调节音量大小、设置音调高低,听觉体验可根据喜好精准拿捏~
自动 / 手动翻页
自动翻页:对话文本输出完成后,会按照设置的延迟时间,自动平滑切换到下一页,无需手动操作更省心
手动翻页:按指定按键(如空格、回车)就能切换页面,还支持快速跳过当前页,节奏自己说了算

对话药水效果
对话期间会自动为玩家添加指定药水效果(默认开启失明 + 减速),既能狠狠拉满沉浸式剧情体验,又能防止玩家在对话时随意移动,避免错过关键内容~
跳过控制
支持禁止玩家跳过对话,强制让剧情、任务说明等重要信息被完整阅读,确保每个关键内容都不被遗漏
NPC 表情与自定义文本
npcbq:控制 NPC 表情状态 ——0 = 开心、1 = 不开心、2 = 难过,让 NPC 情绪直观可见
npctx:设置 NPC 自定义文本 / 头像 —— 支持输入任意字符、emoji,还能使用插件自定义头像代码,个性展示不重样
基础占位符
新增拓展占位符
占位符使用示例
hud:title: %ChemEx_title%npcIcon: %ChemEx_npctx%
npcMood: 情绪:% ChemEx_npcbq%
反射字段缓存:仅在插件加载时执行 1 次反射操作,彻底避免重复反射带来的性能开销
延迟加载机制:对话相关资源仅在需要时才加载,不占用额外内存空间
高效事件处理:对话期间只监听必要事件,大幅减少无效事件监听造成的性能消耗
日志分级:调试日志可自由关闭,生产环境下不会产生额外性能损耗
内存安全保障
显式资源释放:对话关闭时,自动清空所有变量(包括 npcbq、npctx 等拓展字段)
无缓存残留:切换对话时,将所有变量重置为 null,避免旧配置残留影响
无内存泄漏:所有实例化对象都有明确生命周期,保证 GC 能正常识别并回收
字符串优化:避免大量重复字符串拼接,采用 StringBuilder 提升字符串处理效率