Simple Enchantments Integration
ArenaPvP integrates with Simple Enchantments to preserve custom enchantments on items when kits are created and applied.
How It Works
When Simple Enchantments is detected at startup, ArenaPvP uses its API to:
- Preserve enchantments in kit presets — When an admin creates a kit with
/arena kitcreate, the custom enchantments on each item are serialized and stored along with the item data. - Restore enchantments on kit application — When a player spawns in an arena with a kit, the enchantments are reapplied to the items.
Without Simple Enchantments, kits still work normally — items just won't have custom enchantment data.
Setup
- Install Simple Enchantments on your Hytale server.
- Start the server — ArenaPvP detects it automatically.
- You'll see a success log message on startup.
No additional configuration is needed.
Simple Enchantments API Reference
For developers, the Simple Enchantments plugin (org.herolias.plugin.api.EnchantmentApi) provides:
| Method | Description |
|---|---|
addEnchantment(item, enchantmentId, level) | Add an enchantment to an item, returns the modified ItemStack |
removeEnchantment(item, enchantmentId) | Remove an enchantment, returns modified ItemStack |
getEnchantmentLevel(item, enchantmentId) | Get the level of a specific enchantment on an item |
hasEnchantment(item, enchantmentId) | Check if an item has a specific enchantment |
getEnchantments(item) | Get all enchantments on an item as Map<String, Integer> |
registerItemToCategory(itemName, category) | Register an item to an enchantment category |
Item Categories
Simple Enchantments uses categories to determine which enchantments can be applied to which items:
| Category | Description |
|---|---|
MELEE_WEAPON | Swords, axes used for melee |
RANGED_WEAPON | Bows, crossbows |
TOOL | General tools |
PICKAXE | Pickaxes |
SHOVEL | Shovels |
AXE | Axes (woodcutting) |
SHIELD | Shields |
BOOTS | Foot armor |
HELMET | Head armor |
ARMOR | General armor pieces |
STAFF | Magic staves |
STAFF_MANA | Mana-based staves |
STAFF_ESSENCE | Essence-based staves |
Creating Enchanted Kits
To create a kit with enchanted items:
- Equip items with the custom enchantments you want (enchant them using Simple Enchantments' own commands or methods).
- Once your inventory is ready, run:
/arena kitcreate enchanted-warrior Warrior - The kit is saved with all enchantment data intact.
- Assign the kit to an arena template in
config.jsonand players will receive the enchanted items.