迷你套件

高级工具包管理模组

专为 Hytale 服务器设计的先进工具包管理模组，配备直观的图形界面。

功能特性

• 从当前背包无限创建自定义工具包
• 通过简单指令编辑和删除工具包
• 启用/禁用工具包，无需删除
• 支持按世界分配工具包
• 自定义排序
• 每个工具包保存完整的背包布局和物品（包括快捷栏、存储栏、护甲、背包及实用物品！）
• 工具包选择、编辑与创建的直观自定义界面
• 每个工具包可单独设置权限
• 可配置的工具包选择冷却时间
• 支持多语言翻译

快速开始

创建工具包：

/minikit create

打开 MiniKit 的工具包创建界面。

选择一个工具包：

/minikit（或 /kit、/kits）

打开 MiniKit 的工具包选择界面。

编辑工具包：

/minikit edit <kitId>

打开 MiniKit 的工具包编辑器界面。

指令与权限

指令	权限节点	描述
/minikit（或 /kit、/kits、/minikits）	minikit.use	允许打开 MiniKit 界面查看并选择工具包
界面 - 选择任意工具包	minikit.select-kit.*	允许从界面选择任意工具包
界面 - 选择特定工具包	minikit.select-kit.<kitId>	允许按 ID 选择特定工具包（如 minikit.select-kit.1）
冷却绕过	minikit.admin.bypass-cooldown	绕过工具包选择冷却时间
完整管理员模式	minikit.admin.*	启用所有管理员指令
/minikit create [名称] [排序权重]	minikit.admin.create-kit	允许从当前背包创建新工具包
/minikit edit <kitId>	minikit.admin.edit-kit	允许通过编辑界面修改现有工具包
/minikit update <kitId>	minikit.admin.update-kit	允许用当前背包更新现有工具包的物品
/minikit delete <kitId>	minikit.admin.delete-kit	允许按 ID 删除现有工具包
/minikit toggle <kitId>	minikit.admin.toggle-kit	允许按 ID 启用或禁用工具包
/minikit list	minikit.admin.list-kits	允许列出所有可用工具包及其 ID 和状态

授予基础访问权限

赋予玩家使用工具包的权限：

/perm group add Adventure minikit.use
/perm group add Adventure minikit.select-kit.*

授予特定工具包访问权限

允许玩家仅使用特定工具包（例如，工具包 ID 1 和 3）。

注意：这需要省略上述通配符权限（.*）。

/perm group add Adventure minikit.use
/perm group add Adventure minikit.select-kit.1
/perm group add Adventure minikit.select-kit.3

授予管理员访问权限

赋予完全管理控制权：

/perm group add Adventure minikit.use
/perm group add Adventure minikit.select-kit.*
/perm group add Adventure minikit.admin.*

配置选项

MiniKit 在首次运行时自动创建配置文件。你可以在服务器 mods/com.jecsham_MiniKit/Config.json 文件中找到它。

设置项	默认值	描述
SelectKitCooldownSecs	5	玩家两次选择工具包之间必须等待的秒数
HideKitIfNoPermission	false	若为 true，则对没有权限的玩家隐藏工具包。若为 false，则显示工具包但无法选择。
CheckInventoryConflicts	false	若为 true，则在应用工具包前检查玩家背包格子是否可用。若 ClearInventory 为 true，则忽略此选项。
ClearInventory	false	若为 true，则在应用工具包前清空玩家背包。若为 false，则将工具包物品添加到现有背包。

面向开发者

MiniKit 为希望将工具包功能集成到自己插件中的开发人员提供了全面的 API。

开始使用

添加 MiniKit 作为依赖

在你的 manifest.json 中

// ...
{
  "Dependencies": {
      "com.jecsham:MiniKit": "*"
  }
   // 或
   "OptionalDependencies": {
         "com.jecsham:MiniKit": "*"
   }
}
// ...

Gradle：

dependencies {
    compileOnly files('libs/MiniKit-<version>.jar')
}

API 使用

访问 API

// 在你的 Main 类中：
private MiniKitAPI miniKitAPI = null;

// 在 setup() 方法中：
try {
   miniKitAPI = MiniKit.getAPI();
   if (miniKitAPI != null) {
      // MiniKit 集成已启用
      LOGGER.atInfo().log("来自 MiniKit 的工具包总数：" + miniKitAPI.getKitCount());
      }
   } catch (NoClassDefFoundError | Exception e) {
      // MiniKit 不可用，继续运行但不使用它
      // 或者如果你的插件依赖于 MiniKit，则退出程序
   }

API 方法

方法	返回值	描述
getKitById(int id)	Optional<Kit>	通过唯一 ID 检索工具包
getKit(String name)	Optional<Kit>	通过名称检索工具包
hasKit(int id)	boolean	检查是否存在具有指定 ID 的工具包
hasKit(String name)	boolean	检查是否存在具有指定名称的工具包
getAllKits()	Map<Integer, Kit>	返回所有工具包，按 ID 映射
getKitCount()	int	返回工具包总数

如有 Bug 或建议，欢迎反馈！