Healthy DietFEATURE GUIDE中文
07 / TITLEPRO & EFFECTS

标题显示与食用效果是两条配置路径。

TitlePro 配置屏幕上的标题、表格及覆盖层;食物编辑器的效果、指令与清除效果则在吃下食物后分别结算。

标题编辑器标题指令食用反馈

01I 键打开标题编辑器

在游戏内按 I 打开 TitlePro 编辑器;屏幕已打开时不按游戏内快捷键响应。编辑器将标题的文字、位置、动画、背景与方案/模板分开编辑。

文本与基础设定编辑内容、排版、坐标、缩放、停留时间及淡入淡出等基础参数。
动画与背景调整进退场动画、背景颜色、透明度、边距及其他样式。
方案与模板方案保存排版而不保存标题文本;模板保存完整标题。复用时先确认选择了哪一种。
方案还是模板?

想复用位置、动画、背景等排版而另写文本时选择方案;想复用包含文字在内的完整标题时保存模板。文件分别位于本机 config/healthy_diet/titlepro/titlepro_schemes/ 和 config/healthy_diet/titlepro/titlepro_templates/;发送模板前要确认执行命令的实例有相应文件。

源码依据:HealthyDietKeys.OPEN_TITLEPRO、TitleTextEditScreen、TitleBasicSettingsScreen、TitleAnimSettingsScreen、TitleBgSettingsScreen。

02服务器标题命令

以下五条命令均要求 OP2;目标可以是玩家名或玩家选择器。参数串由 TitlePro/表格各自解析,详细选项及补全可在游戏内通过 /hdhelp 核对。

命令 (均 OP2)用途及必要参数
/titlepro <targets> <args...>解析标题文本及排版参数并发给目标玩家;启用额外指令时还可能以命令源身份执行。
/titleprosend <targets> <templateName>加载执行实例中已保存的完整标题模板并发送;模板启用额外指令时也可能执行。
/titletable <targets> <args...>解析表格标题参数并发送到目标屏幕。
/titleproclear <targets>清除目标屏幕上的标题、表格与覆盖层。
/titlescreen <targets> <#color> <alpha%> <stay_s> <fadeIn_s> <fadeOut_s>显示覆盖层;透明度 0–100%,三个时间值为非负秒数。
使用示例

/titlepro @s Hello 0 0 1 2 1 1 14 up

其中 @s 是当前命令源,Hello 是文本,后续依次是 X/Y 偏移、缩放、停留秒数、淡入/淡出秒数、行距与堆叠方向。文本含空格时用引号括住;服务器已有保存的模板可用 /titleprosend @s <模板名> 发给自己,需清屏时用 /titleproclear @s。命令中的数字只是语法示例,不是服务器预设的显示效果。

源码依据:TitleProCommand、TitleProSendCommand、TitleTableCommand、TitleClearCommand、ScreenOverlayCommand。

03食用药水效果

在手持物品的 /hdui 编辑器「药水效果」页配置的是食物吃下后的单次效果,可添加固定效果或按保质期新鲜度变化的曲线效果;这与 营养组阶段条件持续生效的独立加成页不是同一处设置。每条效果有药水 ID、等级、持续 tick、粒子显示与概率等字段;效果延迟由物品配置中的 effectDelay 控制。

计量说明:配置内的效果等级从 0 起算,0 对应游戏里的 I 级;持续时间按 tick 存储,20 tick 约为 1 秒。每条效果的 probability=100 表示必定尝试触发;未配置新鲜度曲线时使用固定等级和持续时间,已配置的曲线只在该物品具备所需保质期状态时才改变等级/时长。

物品的 effectDelay 默认是 10 tick (约半秒);它不控制进食指令或「清除效果」页的延迟,别把它当成整次进食的统一延时。

源码依据:ItemConfig.EffectEntry、EffectFreshnessCurve、ItemConfigEditScreenV2。

04进食指令、提示与效果清除

「指令」页管理 onEatCommands;现行界面保留新增普通指令和 Tellraw 构建入口,不提供旧式生成 TitlePro 标题按钮。营养变化提示有独立的逐组开关,不应把旧 onEatTitles 当作正在运行的物品配置。

「清除效果」页管理 suppressEffects,用于食用后移除指定的物品自带效果;也可扫描已有可清除效果。指令、施加药水、清除自带效果具有各自的延迟设置,实际执行在服务器侧。

三个延迟不要混淆

onEatCommandDelay 作用于进食指令,effectDelay 作用于配置的药水效果,suppressEffectDelay 作用于物品固有效果的移除;三者在新建物品配置中的默认值都是 10 tick。suppressEffects 填的是要移除的效果 ID,不是「移除玩家身上所有效果」的全局开关。

源码依据:ItemConfig.onEatCommands、suppressEffects、nutritionTitleEnabledByGroup,以及 ItemConfigEditScreenV2 的指令/清除效果页。
要设置营养条件指令?单次进食的条件结算在营养值章节单独说明。
查看条件规则 →