物品转储器

ItemDumper 插件

一款 Hytale 服务器插件，能将游戏中所有物品 ID 导出至文本文件。

版本

1.1.0

描述

ItemDumper 可自动提取并导出 Hytale 服务器中所有可用的物品 ID，生成一份排序整齐、易于阅读的文本文件。适用于以下场景：

• 插件开发
• 服务器配置
• 创建自定义战利品表
• 调试物品相关问题
• 了解可用的游戏内容

安装

1. 将 ItemDumper-1.0.0.jar 复制到服务器的 mods/ 目录中
2. 启动或重启 Hytale 服务器
3. 插件将在启动时自动运行

输出

插件会在以下位置生成文件：

<服务器目录>/data/plugins/ItemDumper/all_item_ids.txt

文件包含：

• 带有生成信息的文件头
• 物品总数
• 按字母顺序排序的所有物品 ID 列表
• 每个物品的翻译键（如有）

输出格式

物品类型标识

输出中的每个物品都以类型标识开头：

• [BLOCK] - 可放置方块，能在世界中放置（如岩石、木材、家具、装饰品）
• [ITEM] - 仅限物品栏的物品，无法作为方块放置（如护甲、武器、工具、食物、药水）

可放置与不可放置物品的区分

可放置物品（[BLOCK]） 包括：

• 建筑方块 (Rock_*, Wood_*, Soil_*)
• 家具和装饰品 (Furniture_*, Deco_*)
• 植物和植被 (Plant_*, Flower_*)
• 工作台和容器 (Bench_*, Container_*)

不可放置物品（[ITEM]） 包括：

• 护甲部件 (Armor_*)
• 武器 (Weapon_*)
• 工具 (Tool_*)
• 食物和药水 (Food_*, Potion_*)
• 合成材料 (Ingredient_*)
• 鱼类物品 (Fish_*)

示例输出

================================================================================
ALL ITEM IDS IN HYTALE SERVER
Generated by ItemDumper v1.1.0
Total Items: 3011
  - Placeable Blocks: 2275
  - Inventory Only: 736
================================================================================

    1. [BLOCK] *Container_Bucket_State_Filled_Milk [server.items.Container_Bucket_Milk.name]
    2. [BLOCK] *Container_Bucket_State_Filled_Mosshorn_Milk [server.items.Container_Bucket_Mosshorn_Milk.name]
    3. [BLOCK] *Container_Bucket_State_Filled_Water [server.items.Container_Bucket_Water.name]
    4. [BLOCK] *Deco_Bucket_State_Filled_Milk [server.items.Deco_Bucket_Milk.name]
    5. [BLOCK] *Deco_Bucket_State_Filled_Mosshorn_Milk [server.items.Deco_Bucket_Mosshorn_Milk.name]
    6. [BLOCK] *Deco_Bucket_State_Filled_Water [server.items.Deco_Bucket_Water.name]
    7. [BLOCK] *Deco_Mug_State_Filled_Water [server.items.Deco_Mug_Water.name]
    8. [BLOCK] *Deco_Tankard_State_Filled_Water [server.items.Deco_Tankard_Water.name]
    9. [ITEM]  *Fish_Bluegill_Item_State_Epic [server.npcRoles.Bluegill.name]
   10. [ITEM]  *Fish_Bluegill_Item_State_Legendary [server.npcRoles.Bluegill.name]
   11. [ITEM]  *Fish_Bluegill_Item_State_Rare [server.npcRoles.Bluegill.name]
   12. [ITEM]  *Fish_Bluegill_Item_State_Uncommon [server.npcRoles.Bluegill.name]
   13. [ITEM]  *Fish_Catfish_Item_State_Epic [server.npcRoles.Catfish.name]
   14. [ITEM]  *Fish_Catfish_Item_State_Legendary [server.npcRoles.Catfish.name]
   15. [ITEM]  *Fish_Catfish_Item_State_Rare [server.npcRoles.Catfish.name]
   16. [ITEM]  *Fish_Catfish_Item_State_Uncommon [server.npcRoles.Catfish.name]
   17. [ITEM]  *Fish_Clownfish_Item_State_Epic [server.npcRoles.Clownfish.name]
   18. [ITEM]  *Fish_Clownfish_Item_State_Legendary [server.npcRoles.Clownfish.name]
    ...

使用输出

在构建预制件或为世界编辑选择方块时：

• ✅ 使用标记为 [BLOCK] 的物品 - 可在预制件中生效
• ❌ 避免使用标记为 [ITEM] 的物品 - 这些仅限物品栏，在预制件中使用会导致错误