KitsZZ PvP/PvE

重要 Beta 依赖说明

此 Beta 分支现在需要 CoreZZ。

CurseForge 上旧版的 KitsZZ 公开文件不需要 CoreZZ。但对于此 Beta 分支，情况已不再如此。

如果您上传或安装此 Beta 文件，则必须先安装 ZZCore.jar。

KitsZZ 的功能

• 将多个工具包存储为按工具包名称组织的 JSON 文件。
• 提供一个玩家 GUI 和一个可视化管理员编辑器。
• 支持首次加入时的新手工具包。
• 支持冷却时间、一次性使用、反战斗规则和世界限制。
• 可以通过 ZZCore 经济提供者进行收费或退款。

命令和工作流程

• /kit 和 /kits 是玩家领取或列出工具包的主要入口点。
• 编辑和管理流程包括 /kit create、/kit delete、/kit get、/kit reload、/kit rename、/kit editor、/kit gui、/kit world 和 /kit cooldown。
• /kitsetstarter 和 setkitstarter 用于设置新手工具包。
• 该模块还会在 ZZ 生态系统中注册一个中心入口。

运行时文件和数据

• config.json 存储新手工具包、GUI、反战斗、费用和交付策略设置。
• mensajes.json 存储该模块的可本地化消息集。
• 该模块将其运行时数据存储在 ZonaZeroMc/ZZKits 下。
• kits/ 为每个工具包存储一个 JSON 定义文件。
• usage.json 存储冷却时间和一次性使用状态。
• 当找到旧模块文件夹时，会迁移旧的 JSON 数据。

可见配置示例

{
  "version": 4,
  "language": "es-ES",
  "starterKit": "default",
  "giveStarterOnFirstJoin": false,
  "overwriteSlotsOnGive": false,
  "defaultCooldownSeconds": 0,
  "defaultOneTime": false,
  "clearInventoryBeforeClaim": false,
  "inventoryFullMode": "DROP",
  "allowConsoleCommands": true,
  "enableGui": true,
  "guiClickAction": "SELECT",
  "guiShowLockedKits": false,
  "claimRateLimitSeconds": 2,
  "claimRateLimitBypassAdmin": true,
  "enableDeliveryAudit": true,
  "consumeUsageOnAdminGive": false
}

这显示了模块当前使用的默认配置结构。

配置参考

config.json 中的主要设置

• version (数字)：内部架构版本号。
• language (文本)：消息和 GUI 的语言代码，例如 es-ES 或 en-US。
• starterKit (文本)：用作新手工具包的工具包名称。
• giveStarterOnFirstJoin (是/否)：启用时，在首次加入时自动给予新手工具包。
• overwriteSlotsOnGive (是/否)：启用时，在交付工具包时覆盖目标槽位。
• defaultCooldownSeconds (数字)：应用于新创建工具包的默认冷却时间。
• defaultOneTime (是/否)：启用时，新创建的工具包默认只能使用一次。
• clearInventoryBeforeClaim (是/否)：启用时，在领取工具包前清空背包。
• inventoryFullMode (文本)：背包满时的交付行为。当前文档化的模式为 DROP 和 CANCEL。
• allowConsoleCommands (是/否)：启用时，允许控制台命令流程。

GUI 和领取流程

• enableGui (是/否)：启用可视化工具包 GUI。
• guiClickAction (文本)：GUI 使用的点击行为。
• guiShowLockedKits (是/否)：启用时，在 GUI 中显示锁定的工具包。
• claimRateLimitSeconds (数字)：两次领取之间的反垃圾时间窗口。
• claimRateLimitBypassAdmin (是/否)：启用时，允许管理员绕过领取频率限制。

审计和管理员交付

• enableDeliveryAudit (是/否)：启用时，记录工具包交付日志。
• consumeUsageOnAdminGive (是/否)：如果启用，当管理员给予工具包时，会消耗冷却时间或一次性使用次数。

权限

• kit.admin
• kit.{nombreKit}
• kit.world.{world}
• zz.admin 作为全局覆盖。

安装说明

1. 首先将 ZZCore.jar 复制到服务器的 mods 文件夹中。
2. 然后将 ZZKits.jar 复制到同一个服务器的 mods 文件夹中。
3. 启动 Hytale。
4. 配置工具包、权限、新手工具包行为以及可选的经济规则。

许可证

保留所有权利。

未经作者书面许可，不允许重新分发、转载、转售编辑或重新上传分支版本。