物品管理器 - 新手盒子

.detail-panel[hidden] { display: block !important; } .detail-tabs { display: none; } /* These three panels are rendered by the browser. */ [data-versions], [data-changelog-panel], [data-comments] { display: none; }

支持服务器 - https://discord.gg/DRxwt8Qg2W

这是一个用于 Hytale 服务器的物品管理插件，允许管理员控制游戏中任何物品的合成、使用和死亡保护。非常适合 VIP 系统、服务器经济控制以及防止物品丢失。所有操作都通过一个漂亮且易于使用的 GUI 进行管理 - 只需一个命令！

功能

合成黑名单

实时更新 - 更改立即生效，无需重启服务器
配方锁定 - 配方需要等级 999 的工作台（无法达到）

死亡保护

自动恢复 - 受保护的物品在死亡后会自动返回背包
干净的死亡界面 - 受保护的物品不会显示为“已丢失”物品
选择性保护 - 准确选择要保护的物品

使用限制

快捷栏阻止 - 玩家无法选择被限制的物品
基于权限 - 可选的权限系统，用于 VIP/专属物品
自动插槽锁定 - 系统阻止使用被限制的物品

高级 GUI

精美界面 - 现代标签式 GUI（/itemmanage）
搜索功能 - 按名称/ID 快速查找物品
一键管理 - 单击即可添加/移除物品
视觉反馈 - 查看所有限制
权限管理 - 直接在 GUI 中设置权限

快速开始

安装插件：

将 ItemManager-1.0.0.jar 放入服务器的 mods/ 文件夹
重启你的服务器

打开 GUI：
```
/itemmanage
```
通过 GUI 管理物品：
- 合成黑名单：点击“合成黑名单”标签 → 输入物品 ID → 点击“添加”
- 死亡保护：点击“死亡保护”标签 → 输入物品 ID → 点击“添加”
- 使用限制：点击“使用限制”标签 → 输入物品 ID → 设置权限（可选）→ 点击“添加”
- 移除物品：点击任意物品旁边的“移除”按钮
- 搜索：使用搜索栏筛选物品
就是这样！所有操作都通过 GUI 管理 - 无需命令。

安装

下载 ItemManager-1.0.0.jar
将 JAR 文件放入服务器的 mods/ 文件夹
重启服务器
插件会自动创建一个包含 config.json 的 Hyronix_ItemManager 文件夹

要求：

Hytale 服务器（最新版本）
Java 21+
管理员/OP 权限以管理物品

命令

所有操作都通过 GUI 管理 - 只需一个命令！

命令	描述
`/itemmanage`	打开用于管理所有物品限制的高级 GUI

GUI 功能

GUI 包含三个用于完整物品管理的标签：

合成黑名单标签

查看所有被列入黑名单的物品
添加物品以防止合成
从黑名单中移除物品
按名称/ID 搜索物品
实时更新 - 更改立即生效

死亡保护标签

查看所有受保护的物品
添加物品以保护其不会在死亡时掉落
移除物品的保护
按名称/ID 搜索物品

使用限制标签

查看所有被限制的物品
添加物品以限制使用/装备
为 VIP/专属物品设置可选权限
移除物品的限制
按名称/ID 搜索物品

所有操作都在 GUI 中直接完成 - 无需额外命令！

权限

使用限制权限

当添加使用限制时，你可以指定一个权限：

空权限： 阻止除管理员/OP 外的所有人
设置权限（例如 vip.use）： 只有拥有该权限的玩家可以使用该物品

示例：创建 VIP 物品系统

步骤 1：使用权限限制物品

打开 /itemmanage → “使用限制”标签 → 添加物品 → 设置权限为 “vip.use”

步骤 2：给予玩家权限

选项 A - 直接给予权限：

/perm user add <玩家-uuid> vip.use

选项 B - 基于用户组（推荐）：

/perm group add VIP vip.use

/perm user group add <玩家-uuid> VIP

现在，只有拥有 vip.use 权限的玩家才能使用 VIP 剑！

配置

插件会自动创建包含你设置的 Hyronix_ItemManager/config.json。你可以直接编辑此文件或使用 GUI。

配置结构：

{
  "craftingBlacklist": {
    "Weapon_Sword_Crude": {
      "enabled": true,
      "permission": ""
    },
    "Armor_Cobalt_Head": {
      "enabled": true,
      "permission": ""
    }
  },
  "usageBlacklist": {
    "Weapon_Bow_VIP": {
      "enabled": true,
      "permission": "vip.use"
    },
    "Tool_Pickaxe_Premium": {
      "enabled": true,
      "permission": "premium.tools"
    }
  },
  "deathProtected": {
    "Armor_Mithril_Head": {
      "enabled": true
    },
    "Weapon_Sword_Signature": {
      "enabled": true
    }
  }
}

配置说明：

enabled：设置为 false 以临时禁用某项限制而不删除它
permission：对于使用限制，留空以阻止所有人（管理员除外），或设置权限字符串
对配置文件进行更改需要重启服务器或执行 /reload（如果支持）

工作原理

合成黑名单：

当一个物品被添加到合成黑名单时，插件会修改其配方
配方的所需工作台等级被设置为 999（无法达到）
配方会从合成菜单中完全消失
更改通过数据包更新立即对所有玩家生效
管理员/OP 仍然可以合成这些物品（绕过系统）

死亡保护：

当玩家死亡时，插件会拦截死亡事件
受保护的物品会自动恢复到玩家的背包
受保护的物品会从死亡界面显示中过滤掉
其他物品正常掉落（未受保护的物品）
不会出现复制问题 - 物品会准确恢复

使用限制：

当玩家试图在快捷栏中选择受限物品时，选择会被阻止
定期检查（每 1 秒）确保受限物品无法被使用
如果已选择了受限物品，玩家会自动切换到安全插槽
玩家在受到阻止时会收到通知（不是聊天刷屏）
拥有所需权限（如果已设置）的玩家可以正常使用该物品

查找物品 ID

物品 ID 遵循 Hytale 的命名约定。以下是一些示例：

常见物品 ID 模式：

类别	示例
武器	`Weapon_Sword_Crude`, `Weapon_Bow_VIP`, `Weapon_Daggers_Mithril`
盔甲	`Armor_Mithril_Head`, `Armor_Cobalt_Chest`, `Armor_Copper_Legs`
工具	`Tool_Pickaxe_Cobalt`, `Tool_Axe_Mithril`, `Tool_Shovel_Copper`
物品	`Ingredient_Fibre`, `Food_Bread`, `Material_Wood_Log`