熔炉使用说明
主菜单与购买#
玩家执行 /kf 打开个人熔炉列表,每名玩家最多持有 10 座。第一座普通熔炉免费创建;第 2 到第 10 座按 upgrades.yml 中目标序号的价格购买。
价格提供者可选 vault 或 playerpoints。对应软依赖或其经济服务不可用、余额不足、扣款失败时,购买不会执行。扣款成功但数据库提交失败时,插件恢复购买前状态并尝试原路退款;退款后端也失败时会写入 SEVERE 审计日志,需要管理员人工处理。
设备类型#
| 类型 | 接受的配方 |
|---|---|
| 普通熔炉 | Bukkit 普通熔炼配方 |
| 高炉 | Bukkit 高炉配方 |
| 烟熏炉 | Bukkit 烟熏配方 |
每次切换到目标类型都按 type_switch 收费;点击当前类型不会收费。切换前全部原料、燃料和产物槽必须为空,且已点燃燃料必须耗尽。高炉和烟熏炉不会自动回退到普通熔炉配方。
等级升级#
每座熔炉独立保存五类 1..6 级属性。一级是免费默认状态,价格表示“升级到目标等级”的费用,并且只能逐级购买。
| 属性 | 效果 |
|---|---|
input_slot |
等级等于已解锁原料槽数量 |
fuel_slot |
等级等于已解锁燃料槽数量 |
output_slot |
等级等于已解锁产物槽数量 |
fuel_efficiency |
新点燃燃料时长乘以当前等级倍率 |
smelting_speed |
新开始轮次的基础时长除以当前等级倍率 |
速度升级不会改变已经开始的轮次,燃料效率升级不会改变已经点燃的燃料。多个原料槽按顺序共用一套熔炼进度和燃料,不是六路并行熔炼;产物优先合并到相似物品槽,再使用空输出槽。
永久解锁#
三类能力按熔炉独立购买,成功后不会重复收费:
| 能力 | 效果 |
|---|---|
offline_smelting |
所有者离线时仍按绝对时间继续推进 |
auto_output_delivery |
所有者在线且背包有空间时自动提取产物和对应经验 |
completion_notification |
一批有效原料全部完成后向在线所有者通知一次 |
未解锁 offline_smelting 的熔炉离线暂停,已解锁的熔炉按绝对时间继续熔炼。
升级菜单的操作流程、事务顺序、管理员设置和重载边界见升级系统。价格与倍率格式见 upgrades.yml。
虚拟物品与时间#
原料、燃料和产物完全存入虚拟熔炉。箱子菜单中的显示物不是额外物品副本,不应由其他插件直接修改。
熔炼进度使用系统绝对时间计算,Tick 只负责触发推进和界面刷新,因此服务器卡顿不会按相同比例拖慢理论完成时间。单次推进仍受 max-settlements-per-advance 限制,长时间离线可能分多次引擎刷新完成追赶。
燃料覆盖#
插件接受当前服务端 API 通过 Material.isFuel() 声明的全部燃料,包括木台阶、楼梯、工作台、木制工具和岩浆桶。常见燃料使用原版类别时长;服务端未来新增但 API 不公开精确时长的燃料会使用保守类别基线。岩浆桶燃尽后会返还空桶。