Description
Support Server - https://discord.gg/DRxwt8Qg2W
An item management plugin for Hytale servers that allows administrators to control crafting, usage, and death protection for any item in the game. Perfect for VIP systems, server economy control, and preventing item loss. Everything is managed through a beautiful, easy-to-use GUI - just one command needed!
Features
Crafting Blacklist
- Real-time updates - Changes apply immediately without server restart
- Recipe locking - Recipes require tier 999 workbench (impossible to achieve)
Death Protection
- Automatic restoration - Protected items are returned to inventory on death
- Clean death screen - Protected items don't appear as "lost" items
- Selective protection - Choose exactly which items to protect
Usage Restrictions
- Hotbar blocking - Players cannot select restricted items
- Permission-based - Optional permission system for VIP/exclusive items
- Automatic slot locking - System prevents restricted item usage
Advanced GUI
- Beautiful interface - Modern tabbed GUI (`/itemmanage`)
- Search functionality - Quickly find items by name/ID
- One-click management - Add/remove items with a single click
- Visual feedback - See all restrictions
- Permission management - Set permissions directly in GUI
Quick Start
1. Install the plugin:
```
Place ItemManager-1.0.0.jar in your server's mods/ folder
Restart your server
```
2. Open the GUI:
```
/itemmanage
```
3. Manage items through the GUI:
- Crafting Blacklist: Click the "Crafting Blacklist" tab → Type item ID → Click "Add"
- Death Protection: Click the "Death Prot." tab → Type item ID → Click "Add"
- Usage Restrictions: Click the "Usage Restr." tab → Type item ID → Set permission (optional) → Click "Add"
- Remove items: Click "REMOVE" button next to any item
- Search: Use the search bar to filter items
That's it! Everything is managed through the GUI - no commands needed.
Installation
1. Download `ItemManager-1.0.0.jar`
2. Place the JAR file in your server's `mods/` folder
3. Restart your server
4. The plugin will automatically create a `Hyronix_ItemManager` folder with `config.json`
Requirements:
- Hytale Server (latest version)
- Java 21+
- Admin/OP permissions to manage items
Commands
Everything is managed through the GUI - only one command needed!
| Command | Description |
|---------|-------------|
| `/itemmanage` | Opens the advanced GUI for managing all item restrictions |
GUI Features:
The GUI includes three tabs for complete item management:
Crafting Blacklist Tab
- View all blacklisted items
- Add items to prevent crafting
- Remove items from blacklist
- Search for items by name/ID
- Real-time updates - changes apply immediately
Death Prot. Tab
- View all protected items
- Add items to protect from death drops
- Remove protection from items
- Search for items by name/ID
Usage Restr. Tab
- View all restricted items
- Add items to restrict usage/equipping
- Set optional permissions for VIP/exclusive items
- Remove restrictions from items
- Search for items by name/ID
All operations are done directly in the GUI - no additional commands needed!
Permissions
Usage Restriction Permissions
When adding a usage restriction, you can specify a permission:
- Empty permission: Blocks everyone except admins/OP
- Set permission (e.g., `vip.use`): Only players with that permission can use the item
Example: Creating a VIP Item System
Step 1: Restrict the item with a permission
```
Open /itemmanage → "Usage Restr." tab → Add item → Set permission to "vip.use"
```
Step 2: Give players the permission
Option A - Direct permission:
```bash
/perm user add <player-uuid> vip.use
```
Option B - Group-based (recommended):
```bash
/perm group add VIP vip.use
/perm user group add <player-uuid> VIP
```
Now only players with `vip.use` permission can use the VIP sword!
Configuration
The plugin automatically creates `Hyronix_ItemManager/config.json` with your settings. You can edit this file directly or use the GUI.
Configuration Structure:
```json
{
"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
}
}
}
```
Configuration Notes:
- `enabled`: Set to `false` to temporarily disable a restriction without removing it
- `permission`: For usage restrictions, leave empty to block everyone (except admins), or set a permission string
- Changes to the config file require a server restart or `/reload` (if supported)
How It Works
Crafting Blacklist:
1. When an item is added to the crafting blacklist, the plugin modifies its recipe
2. The recipe's required workbench tier is set to 999 (impossible to achieve)
3. The recipe disappears from crafting menus entirely
4. Changes apply immediately to all players via packet updates
5. Admins/OP can still craft these items (bypass system)
Death Protection:
1. When a player dies, the plugin intercepts the death event
2. Protected items are automatically restored to the player's inventory
3. Protected items are filtered from the death screen display
4. Other items drop normally (unprotected items)
5. No duplication issues - items are restored exactly as they were
Usage Restrictions:
1. When a player tries to select a restricted item in their hotbar, the selection is blocked
2. A periodic check (every 1 second) ensures restricted items can't be used
3. If a restricted item is already selected, the player is automatically switched to a safe slot
4. Players receive a notification (not chat spam) when blocked
5. Players with the required permission (if set) can use the item normally
Finding Item IDs
Item IDs follow Hytale's naming convention. Here are some examples:
Common Item ID Patterns:
| Weapons | `Weapon_Sword_Crude`, `Weapon_Bow_VIP`, `Weapon_Daggers_Mithril` |
| Armor | `Armor_Mithril_Head`, `Armor_Cobalt_Chest`, `Armor_Copper_Legs` |
| Tools | `Tool_Pickaxe_Cobalt`, `Tool_Axe_Mithril`, `Tool_Shovel_Copper` |
| Items | `Ingredient_Fibre`, `Food_Bread`, `Material_Wood_Log` |