KTools - 高级插件工具集

KTools 是一款先进且现代化的 Minecraft 插件，旨在帮助开发者更便捷地创建插件。它集成了命令、监听器、配方、物品、消息、库存、用户界面、资源包、数据库和更新器等核心功能模块，为插件开发提供了强大的基础框架。

💡安装方法

安装过程非常简单

• 下载最新版本（或特定版本）的 KTools。
• 将下载的 .JAR 文件放入服务器的 plugins 文件夹中。
• 重启服务器即可。

🎮配置

你可以通过配置文件对 KTools 进行详细设置。

主配置文件

• 路径：./plugins/KTools/config.yml
• 在此文件中，你可以调整 KTools 的核心行为。

消息与语言文件

KTools 及其支持的插件中，几乎所有的消息文本都可以自定义。消息使用 Mini Message 格式。

• 全局消息文件：./plugins/KTools/lang/en.yml
• 插件消息文件：./plugins/PLUGIN/lang/en.yml

你可以通过复制 en.yml 文件并重命名来创建自定义语言文件。创建后，请务必在 config.yml 中修改 language 选项以启用新语言。

> 注意：只有默认的语言文件（如 en.yml）会自动生成缺失的消息条目。

🔧命令

KTools 自身包含 5 个基础命令

• /givecustom item <目标玩家> <物品ID> <数量> - 给予来自 KTools 的自定义物品。
• /ktools - 显示 KTools 插件信息。
• /ktools messages reload - 重载所有消息文件。
• /ktools bar add/set <进度条名称> <目标玩家> <数值> - 为自定义进度条（例如来自 KThirst 插件）增加或设置点数。
• /ktools resourcepack refresh - 重新上传资源包。

其他基于 KTools 的插件也会添加自己的命令。完整的命令列表（包括权限和描述）可以在以下位置查看：

• 全局命令文件：./plugins/KTools/commands.yml
• 插件命令文件：./plugins/PLUGIN/commands.yml

⭐自定义物品

使用 KTools 框架的插件可以添加自定义物品。所有已添加的物品都可以在 ./plugins/KTools/items.yml 文件中查看。你也可以在游戏中通过 /givecustom 命令获取这些物品。

✨资源包管理

KTools 可以管理插件使用的自定义资源包。玩家首次加入服务器时需要接受该资源包。

编辑与更新

• 你可以在 ./plugins/KTools/textures/ 目录下编辑纹理文件。
• 编辑后，需要删除 ./plugins/KTools/cache.yml 文件中的 resourcepackUrl 链接。
• 最后，重启服务器以重新生成资源包。

与其他资源包整合

如果你的服务器已在使用其他资源包，请按以下步骤操作：

• 确保 KTools 的资源包已生成（首次需在 config.yml 中启用资源包并启动服务器）。
• 从 ./plugins/KTools/cache.yml 文件的 resourcepackUrl 处下载 KTools 生成的资源包。
• 在 ./plugins/KTools/config.yml 中，将 resourcepack: true 改为 resourcepack: false 以禁用 KTools 的资源包推送。
• 将你的资源包与 KTools 的资源包合并。
• 将合并后的资源包提供给玩家。

自托管资源包（实验性功能，自 2.3.0 起）

如果你拥有除 Minecraft 端口外的其他可用端口，可以自托管 KTools 生成的资源包，这将提升上传/下载速度并避免第三方网站的不稳定性。

启用步骤

• 打开 ./plugins/KTools/config.yml，找到 resourcePackSelfHost 部分。
• 进行如下配置：

resourcePackSelfHost:
  enabled: true
  port: 8008 # 如果此端口被占用或你只能使用特定端口，请修改
  usePortInUrl: true # 如果使用反向代理隐藏了端口，可设为 false
  host: "http://你的服务器IP或域名" # 结尾不要加 "/"

• 保存配置并重启服务器。
• 使用命令 /ktools resourcepack refresh 刷新资源包。

❓许可与致谢

• 许可证：KTools 插件基于 Apache 2.0 许可证 发布。你可以在自己的插件中使用它，包括商业用途，但需要提供相应的许可声明。
• 致谢：完整的贡献者名单与源代码可在 GitHub 上查看。