HyEssentials

概述

HyEssentials 是一款轻量级但功能强大的插件，旨在为任何 Hytale 服务器提供基础功能。它包含一套基于聊天界面的强大礼包系统、一个支持颜色自定义的前缀管理器以及聊天格式功能。

功能

1. 礼包系统

• 可配置礼包：在 config.json 中创建无限数量的礼包。
• 用户友好：玩家输入 /kit 即可看到一个可点击的“可用礼包”菜单。
• 一次性领取：防止玩家滥用初始礼包（保存于 claimed.json 中）。
• 自定义指令：礼包可执行控制台指令（例如赠送物品或经验值）。

2. 前缀系统

• 自定义头衔/标签：为任何玩家设置自定义前缀（例如 [Owner]、[VIP]）。
• 颜色支持：使用 $ 或 & 代码支持颜色（例如 $c[Admin]）。
• 持久化：前缀自动保存，并在服务器重启后保持不变。

3. 聊天格式

• 自动着色：聊天消息自动显示玩家前缀。
• 简洁格式：[前缀] 玩家名：消息

指令

---

礼包指令

• /kit → 打开礼包菜单
• /kit claim <名称> → 手动领取特定礼包（例如 /kit claim starter）

前缀指令

• /prefix add <玩家> <文本> → 设置玩家前缀。
  • 用法：/prefix add 名称 $c[Admin]
  • （如果 & 被屏蔽，请使用 $ 表示颜色）
• /prefix remove <玩家> → 移除玩家前缀。

配置

插件会在服务器创建 mods/HyEssentials 文件夹，包含以下内容：

1. config.json

• 在此自定义您的礼包。
• 示例：

  "starter": {
      "display_name": "初始礼包",
      "commands": [
          "give {player} weapon_sword_wood --quantity=1",
          "give {player} plant_fruit_apple --quantity=5"
      ]
  }
  

2. prefixes.json

• 存储玩家前缀（除非服务器关闭，否则请勿手动编辑）。

3. claimed.json

• 存储哪些玩家已领取了哪个礼包（删除特定条目可重置玩家的领取记录）。

安装

1. 将 HyEssentials.jar 放入服务器的 mods/ 文件夹。
2. 重启服务器。
3. 尽情享受！