- 版权类型
- 原创
- 插件中文名称
- KaFurnace
- 插件英文名称
- KaFurnace
- 支持的核心(服务端)
- Spigot
- Paper
- Folia
- Purpur
- PufferFish
- 语言支持
- 中文(简体)
- 前置组件
- PlaceholderAPI
Vault
PlayerPoints
ItemsAdder
Oraxen
CraftEngine
(前置插件均为可选)
- 适配版本(Java)
- 最新版本
- 26.x
- 1.21
- 1.20
- 1.19
- 1.18
- 1.17
- 1.16
[MD]
# KaFurnace - 支持后台熔炼、升级与自定义箱子界面的个人虚拟熔炉
KaFurnace 为每名玩家提供独立的虚拟熔炉。原料、燃料和产物完整保存在插件数据库中,不依赖世界里的熔炉方块;玩家通过可自定义的箱子 GUI 管理自己的熔炉。
[/MD]
[MD] ## 玩家可以做什么 - 在主菜单管理多座独立熔炉,并用 `/kf open <序号>` 快捷打开; - 使用普通熔炉、高炉和烟熏炉对应的服务端配方; - 升级原料槽、燃料槽、产物槽、燃料效率和熔炼速度; - 按熔炉解锁离线熔炼、自动产物配送和完成通知; - 查看实时熔炼/燃料进度条、剩余时间、全部原料预计耗时和预计完成时刻; - 安全地在熔炼途中放入或取出原料与燃料,产物只在一轮完成时结算。 多槽位共享一条熔炼流程,并不是多路并行加工。已点燃燃料已经从燃料槽消费,取走剩余燃料不会取消当前燃烧时间。 ## 图片预览 [/MD]
提示:上方展示截图采用ItemsAdder插件及贴图协助完成,你可以加入QQ群下载贴图文件。若未使用贴图,游戏内的显示界面与上方展示截图有所差异。
[MD] ## 服主功能 - SQLite 默认存储,也可使用 MySQL; - 购买、升级、解锁和炉型切换支持 Vault 或 PlayerPoints; - 扣款、状态修改和数据库写入组成事务,提交失败时恢复状态并尝试退款; - 绝对时间熔炼模型不依赖 Tick 精度,服务器卡顿不会按比例延长理论耗时; - 原生兼容 Spigot/Paper,并通过专用调度层兼容 Folia; - 支持中文和英文语言文件,缺失语言键会自动补齐且不会覆盖已有翻译; - `config.yml`、`upgrades.yml` 和 UI 文件均支持安全增量更新; - 箱子菜单支持字符矩阵布局、动态按钮、颜色代码和 PlaceholderAPI; - UI 可使用 ItemsAdder、Oraxen、CraftEngine 的字形与自定义物品; - 不依赖 NMS 或 ProtocolLib。 ## 精细权限 服主可以为不同玩家组分别设置: ```text kafurnace.limit.furnaces.<1-10> kafurnace.limit.upgrade.<属性>.<1-6> kafurnace.unlock.<能力> kafurnace.type.<炉型> ``` 权限在事务扣款前检查。降低上限不会删除已有熔炉、回退等级或撤销已经购买的能力。默认行为保持为最多 10 座熔炉、五项属性最高 6 级,并允许全部能力和炉型。 ## 界面与变量 三份外部菜单分别控制熔炉列表、详细熔炉和升级界面。标题、物品名称和 Lore 支持内置 `{变量}` 及其他插件提供的 `%PAPI变量%`。 内置变量包括物品数量、等级、状态、彩色进度条、燃料是否充足、数字毫秒/秒数,以及由 `time_format` 和 `countdown_format` 控制的可读时间。布尔值和经济提供者名称支持 i18n;条件判断可使用对应 `_raw` 原始变量。 安装 PlaceholderAPI 后,KaFurnace 会直接注册 `%kafurnace_<熔炉序号>_<字段>%`,无需另外下载 expansion。 ## 兼容与依赖 | 项目 | 要求 | |---|---| | 服务端 | Spigot/Paper 1.16.5+;Folia 1.20.1+ | | Java | Java 16+,同时满足服务端自身要求 | | 数据库 | SQLite 或 MySQL 8.0+ | | 可选依赖 | PlaceholderAPI、Vault、PlayerPoints、ItemsAdder、Oraxen、CraftEngine | 使用 Vault 收费还需要一个 Economy 实现。使用 PlayerPoints 收费需要安装 PlayerPoints。插件首次启动会按数据库类型下载并校验对应 JDBC 驱动。 ## 安装 1. 将 KaFurnace JAR 放入服务器 `plugins` 目录并启动服务器。 2. 管理员玩家执行 `/kf`。 3. 选择释放中文或英文菜单模板。 4. 检查 `upgrades.yml`,把所有收费项目调整为服务器实际安装的经济提供者。 5. 执行 `/kf reload` 应用配置。 首次启动不会自动释放 UI,选择模板后才会创建: ```text plugins/KaFurnace/ui/main.yml plugins/KaFurnace/ui/furnace.yml plugins/KaFurnace/ui/upgrade.yml ``` 已有 UI 值不会被覆盖;模板新增的缺失键可能在后续加载时自动补齐。 ## 常用命令 | 命令 | 用途 | |---|---| | `/kf` | 打开个人熔炉列表 | | `/kf open <1-10>` | 快捷打开自己的指定熔炉 | | `/kf help` | 查看帮助 | | `/kf reload` | 重载配置、语言和 UI | | `/kf lang <zh_CN\|en_US>` | 切换消息语言 | | `/kf ui <zh_CN\|en_US>` | 安装缺失的菜单模板 | | `/kf admin <玩家\|UUID> <序号> open` | 管理员打开指定玩家熔炉 | | `/kf admin furnace ...` | 查看或强制设置等级与解锁状态 | [/MD]
[MD] ## 玩家可以做什么 - 在主菜单管理多座独立熔炉,并用 `/kf open <序号>` 快捷打开; - 使用普通熔炉、高炉和烟熏炉对应的服务端配方; - 升级原料槽、燃料槽、产物槽、燃料效率和熔炼速度; - 按熔炉解锁离线熔炼、自动产物配送和完成通知; - 查看实时熔炼/燃料进度条、剩余时间、全部原料预计耗时和预计完成时刻; - 安全地在熔炼途中放入或取出原料与燃料,产物只在一轮完成时结算。 多槽位共享一条熔炼流程,并不是多路并行加工。已点燃燃料已经从燃料槽消费,取走剩余燃料不会取消当前燃烧时间。 ## 图片预览 [/MD]
提示:上方展示截图采用ItemsAdder插件及贴图协助完成,你可以加入QQ群下载贴图文件。若未使用贴图,游戏内的显示界面与上方展示截图有所差异。
[MD] ## 服主功能 - SQLite 默认存储,也可使用 MySQL; - 购买、升级、解锁和炉型切换支持 Vault 或 PlayerPoints; - 扣款、状态修改和数据库写入组成事务,提交失败时恢复状态并尝试退款; - 绝对时间熔炼模型不依赖 Tick 精度,服务器卡顿不会按比例延长理论耗时; - 原生兼容 Spigot/Paper,并通过专用调度层兼容 Folia; - 支持中文和英文语言文件,缺失语言键会自动补齐且不会覆盖已有翻译; - `config.yml`、`upgrades.yml` 和 UI 文件均支持安全增量更新; - 箱子菜单支持字符矩阵布局、动态按钮、颜色代码和 PlaceholderAPI; - UI 可使用 ItemsAdder、Oraxen、CraftEngine 的字形与自定义物品; - 不依赖 NMS 或 ProtocolLib。 ## 精细权限 服主可以为不同玩家组分别设置: ```text kafurnace.limit.furnaces.<1-10> kafurnace.limit.upgrade.<属性>.<1-6> kafurnace.unlock.<能力> kafurnace.type.<炉型> ``` 权限在事务扣款前检查。降低上限不会删除已有熔炉、回退等级或撤销已经购买的能力。默认行为保持为最多 10 座熔炉、五项属性最高 6 级,并允许全部能力和炉型。 ## 界面与变量 三份外部菜单分别控制熔炉列表、详细熔炉和升级界面。标题、物品名称和 Lore 支持内置 `{变量}` 及其他插件提供的 `%PAPI变量%`。 内置变量包括物品数量、等级、状态、彩色进度条、燃料是否充足、数字毫秒/秒数,以及由 `time_format` 和 `countdown_format` 控制的可读时间。布尔值和经济提供者名称支持 i18n;条件判断可使用对应 `_raw` 原始变量。 安装 PlaceholderAPI 后,KaFurnace 会直接注册 `%kafurnace_<熔炉序号>_<字段>%`,无需另外下载 expansion。 ## 兼容与依赖 | 项目 | 要求 | |---|---| | 服务端 | Spigot/Paper 1.16.5+;Folia 1.20.1+ | | Java | Java 16+,同时满足服务端自身要求 | | 数据库 | SQLite 或 MySQL 8.0+ | | 可选依赖 | PlaceholderAPI、Vault、PlayerPoints、ItemsAdder、Oraxen、CraftEngine | 使用 Vault 收费还需要一个 Economy 实现。使用 PlayerPoints 收费需要安装 PlayerPoints。插件首次启动会按数据库类型下载并校验对应 JDBC 驱动。 ## 安装 1. 将 KaFurnace JAR 放入服务器 `plugins` 目录并启动服务器。 2. 管理员玩家执行 `/kf`。 3. 选择释放中文或英文菜单模板。 4. 检查 `upgrades.yml`,把所有收费项目调整为服务器实际安装的经济提供者。 5. 执行 `/kf reload` 应用配置。 首次启动不会自动释放 UI,选择模板后才会创建: ```text plugins/KaFurnace/ui/main.yml plugins/KaFurnace/ui/furnace.yml plugins/KaFurnace/ui/upgrade.yml ``` 已有 UI 值不会被覆盖;模板新增的缺失键可能在后续加载时自动补齐。 ## 常用命令 | 命令 | 用途 | |---|---| | `/kf` | 打开个人熔炉列表 | | `/kf open <1-10>` | 快捷打开自己的指定熔炉 | | `/kf help` | 查看帮助 | | `/kf reload` | 重载配置、语言和 UI | | `/kf lang <zh_CN\|en_US>` | 切换消息语言 | | `/kf ui <zh_CN\|en_US>` | 安装缺失的菜单模板 | | `/kf admin <玩家\|UUID> <序号> open` | 管理员打开指定玩家熔炉 | | `/kf admin furnace ...` | 查看或强制设置等级与解锁状态 | [/MD]