快速开始

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

系统要求#

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

安装步骤#

1. 将 KaFurnace-1.0.0.jar 放入服务器的 plugins 文件夹。
2. 启动服务器，等待 JDBC 依赖下载完成。
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

内置 upgrades.yml 同时包含 Vault 和 PlayerPoints 价格。测试收费购买前需要安装 Vault、一个 Economy 实现和 PlayerPoints，或先把全部收费节点改成服务器已有的提供者并执行 /kf reload。

验证安装#

1. 执行 /kf 打开主菜单。
2. 打开第一座普通熔炉。
3. 放入可熔炼原料和燃料。
4. 确认燃料与熔炼信息约每 5 Tick 刷新。
5. 关闭后重新打开，确认虚拟槽位内容仍然存在。
6. 打开升级菜单，确认价格、提供者可用状态和五类等级均正确显示。

如果插件无法启用，先检查控制台中的 JDBC 下载或数据库连接错误。