界面自定义
菜单文件位于：
plugins/KaFurnace/ui/main.yml
plugins/KaFurnace/ui/furnace.yml
plugins/KaFurnace/ui/upgrade.yml
首次启动不会自动释放菜单。管理员执行 /kf ui zh_CN 或 /kf ui en_US 安装缺失模板；已有文件不会被覆盖。修改后执行 /kf reload，插件更新时只补齐缺失键。
Layout 规则#
每行必须正好 9 个字符，可配置 1 到 6 行。每个非空字符都必须有对应的 button.<字符> 定义。
熔炉菜单的 i、f、o 分别表示原料、燃料和产物，每类必须配置 1 到 6 个位置。按 Layout 从左到右、从上到下的顺序映射逻辑槽位，实际可用数量由对应槽位等级决定。
主菜单固定使用：
| 字符 | 用途 |
|---|---|
f |
最多 10 个熔炉列表位置 |
u |
选择要升级的熔炉 |
b |
购买下一座熔炉 |
升级菜单必须包含 n、b、s、r，分别表示普通熔炉、高炉、烟熏炉和返回。以下升级字符每种最多出现一次；自定义布局省略某个字符时，对应购买入口不会显示：
| 字符 | 功能键 |
|---|---|
i / f / o |
input_slot / fuel_slot / output_slot |
e / v |
fuel_efficiency / smelting_speed |
l / a / c |
offline_smelting / auto_output_delivery / completion_notification |
按钮格式#
button:
"P":
dynamic: cook
display:
material: CLOCK
amount: 1
name: "&b熔炼进度"
lore:
- "&7[{cook_progress_bar}&7] &f{cook_progress}% &7剩余 &f{cook_remaining_seconds} 秒"
界面文字直接写在 UI 文件中，不支持 lang: 引用。标题、名称和 Lore 支持 & 颜色代码；安装 PlaceholderAPI 后也支持任意 %变量%，详见 PlaceholderAPI。
熔炉状态变量#
| 变量 | 说明 |
|---|---|
{furnace_index} / {furnace_type} / {furnace_type_name} |
熔炉序号、类型枚举和本地化类型名 |
{state} / {state_id} |
状态文本和状态枚举名 |
{input_amount} / {fuel_amount} / {output_amount} |
全部已解锁对应槽位的数量合计 |
{input_type} / {fuel_type} / {output_type} |
第一个非空已解锁槽位的材质名 |
{completed} |
已完成轮次数 |
{fuel_efficiency_level} / {smelting_speed_level} |
燃料效率和熔炼速度等级 |
{input_slot_level} / {fuel_slot_level} / {output_slot_level} |
三类槽位等级和已解锁数量 |
{offline_smelting_enabled} |
是否允许该炉离线熔炼 |
{auto_output_delivery_enabled} |
是否启用在线产物配送 |
{completion_notification_enabled} |
是否启用完成通知 |
进度与时间变量#
| 变量 | 说明 |
|---|---|
{cook_progress} / {cook_progress_bar} |
本轮百分比和递增的 20 段彩色进度条 |
{cook_elapsed_seconds} / {cook_total_seconds} / {cook_remaining_seconds} |
本轮已用、总计和剩余秒数 |
{cook_all_remaining_seconds} / {estimated_remaining_seconds} |
当前全部有效原料理论剩余秒数 |
{cook_all_finish_time} |
服务器时区中的理论全部完成时间 |
{burn_progress} / {burn_remaining_percent} |
已燃烧和剩余百分比 |
{burn_progress_bar} |
按剩余量递减的 20 段彩色燃料条 |
{burn_elapsed_seconds} / {burn_total_seconds} / {burn_remaining_seconds} |
当前已点燃燃料的时间 |
{fuel_all_remaining_ms} / {fuel_all_remaining_seconds} |
当前余量加全部已解锁燃料槽库存的预计时间 |
{fuel_sufficient_for_all_input} |
当前全部燃料是否足以熔完全部有效原料 |
两个进度条变量自带颜色代码。所有“剩余秒”向上取整为整数；毫秒和已用/总时长秒变量保留实际精度。全部完成估算假定当前配方不变、燃料充足且输出不阻塞，只适合显示。
价格与升级菜单变量#
主菜单提供 {owned}、{max}、{remaining_slots}、{next_furnace_index}，以及：
{furnace_purchase_price}
{furnace_purchase_provider}
{furnace_purchase_provider_available}
五类等级键均提供 {<键>_level}、{<键>_next_level}、{<键>_maxed}、{<键>_price}、{<键>_provider}、{<键>_provider_available}。三类永久解锁提供 {<键>_enabled} 及同样的价格、提供者、可用状态变量。类型切换价格前缀为 type_furnace、type_blast_furnace、type_smoker。