快速开始

本页介绍 KaFurnace 的安装、首次菜单初始化和基本验证。

系统要求#

项目	要求
Minecraft	Spigot/Paper 1.16.5+；Folia 1.20.1+
Java	Java 16+；实际版本还必须满足服务端自身要求
数据库	默认 SQLite；可选 MySQL 8.0+
可选插件	PlaceholderAPI、ItemsAdder、Oraxen、CraftEngine；收费项使用 vault 时需要 Vault 和 Economy 实现，使用 playerpoints 时需要 PlayerPoints

安装步骤#

1. 将下载的 KaFurnace JAR 文件放入服务器的 plugins 文件夹。
2. 启动服务器；首次启动可能需要下载数据库驱动，请等待控制台提示插件启用。
3. 管理员玩家执行 /kf。
4. 点击中文或英文菜单按钮，或执行 /kf ui zh_CN、/kf ui en_US。
5. 插件安装三份菜单文件并打开主菜单。

首次启动生成 config.yml、upgrades.yml 和 lang，不会自动创建 ui。选择菜单语言后会生成：

plugins/KaFurnace/ui/main.yml
plugins/KaFurnace/ui/furnace.yml
plugins/KaFurnace/ui/upgrade.yml

默认价格同时使用 Vault 和 PlayerPoints。测试收费购买前，请安装 Vault、一个经济插件和 PlayerPoints；如果只使用其中一种支付方式，按价格配置改好所有收费项目，再执行 /kf reload。

验证安装#

1. 执行 /kf 打开主菜单。
2. 打开第一座普通熔炉；若 initial-furnace-count 为 0，先通过主菜单购买。
3. 放入可熔炼原料和燃料。
4. 确认燃料和熔炼进度会自动刷新。
5. 关闭后重新打开，确认虚拟槽位内容仍然存在。
6. 打开升级菜单，确认价格和升级项目显示正常。

如果插件无法启用，先检查控制台中的数据库驱动下载或连接错误。多服共享熔炉还需在每台子服启用 MySQL 跨服同步；单服不需要。

ItemsAdder、Oraxen 和 CraftEngine 均为 UI 软依赖，未安装时不影响虚拟熔炉。安装或移除这些插件后应完整重启服务器以应用软依赖加载顺序；CraftEngine 字形还需要启用 network.intercept-packets.container: true。