ItemDumper Plugin

A Hytale server plugin that dumps all item IDs from the game to a text file.

Version

1.1.0

Description

ItemDumper automatically extracts and exports all item IDs available in your Hytale server to a sorted, easy-to-read text file. This is useful for:

Plugin development
Server configuration
Creating custom loot tables
Debugging item-related issues
Understanding available game content

Installation

Copy ItemDumper-1.0.0.jar to your server's mods/ directory
Start or restart your Hytale server
The plugin will automatically run on startup

Output

The plugin generates a file at:

<server-directory>/data/plugins/ItemDumper/all_item_ids.txt

The file contains:

A header with generation information
Total count of items
Alphabetically sorted list of all item IDs
Translation keys for each item (if available)

Output Format

Item Type Indicators

Each item in the output is prefixed with a type indicator:

[BLOCK] - Placeable blocks that can be placed in the world (e.g., rocks, wood, furniture, decorations)
[ITEM] - Inventory-only items that cannot be placed as blocks (e.g., armor, weapons, tools, food, potions)

Understanding Placeable vs Non-Placeable

Placeable items ([BLOCK]) include:

Building blocks (Rock_, Wood_, Soil_*)
Furniture and decorations (Furniture_, Deco_)
Plants and vegetation (Plant_, Flower_)
Benches and containers (Bench_, Container_)

Non-placeable items ([ITEM]) include:

Armor pieces (Armor_*)
Weapons (Weapon_*)
Tools (Tool_*)
Food and potions (Food_, Potion_)
Crafting ingredients (Ingredient_*)
Fish items (Fish_*)

Example Output

================================================================================
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]
    ...

Using the Output

When building prefabs or selecting blocks for world editing:

✅ Use items marked with [BLOCK] - these will work in prefabs
❌ Avoid items marked with [ITEM] - these are inventory-only and will cause errors if used in prefabs

Building from Source

Requirements

Java 21 or later
HytaleServer.jar in the root directory

Build Steps

Windows:

cd mods\ItemDumper
build.bat

Linux/Mac:

cd mods/ItemDumper
javac -source 21 -target 21 -cp "../../HytaleServer.jar" -d build/classes src/main/java/com/itemdumper/plugin/ItemDumper.java
cd build/classes
cp ../../src/main/resources/manifest.json .
jar cvf ../libs/ItemDumper-1.0.0.jar manifest.json com/itemdumper/plugin/*.class
cd ../..
cp build/libs/ItemDumper-1.0.0.jar ../

Dependencies

None

Permissions

None (runs automatically on server start)

Logs

Check your server console for output:

[INFO] ItemDumper setting up...
[INFO] ItemDumper starting...
[INFO] Successfully dumped 1234 item IDs to: <path>/all_item_ids.txt
[INFO] ItemDumper started successfully!

Credits

Created by ImVylo for the HyVorn community

License

Free to use and modify

Support

This plugin is provided as-is for educational and utility purposes.

ItemDumper