MMO Skill Tree Integration

ArenaPvP integrates with MMO Skill Tree to preserve player skill data during arena matches. Skills are saved and cleared when entering an arena, then fully restored when leaving — identical to how inventory is handled.

Why This Matters

MMO Skill Tree grants players passive bonuses based on their skill levels (e.g. higher damage with swords, faster mining, parry bonuses). Without this integration, players would carry their skill advantages into arena combat, creating unfair matchups between high-level and low-level players.

With the integration enabled:

• All players enter arenas with zero skill XP — a level playing field
• Original skill data is persisted to disk — safe even if the server crashes
• Skills are fully restored when the player leaves the arena

How It Works

Entering an Arena

When a player enters an arena, ArenaPvP:

1. Snapshots all skill XP
2. Saves the data to mods/arenapvp/data/skills/{uuid}.json
3. Clears all skills to 0 XP

This happens atomically alongside the inventory save — if the skill save fails, the arena entry still proceeds (skills just won't be cleared).

Leaving an Arena

When a player leaves an arena (match ends, disconnect, etc.), ArenaPvP:

1. Reads the saved
2. Restores each skill's XP
3. Deletes the save file

This runs inside the same world.execute() block as inventory restoration, ensuring thread safety.

Setup

1. Install MMO Skill Tree on your Hytale server.
2. Start the server — ArenaPvP detects it automatically.
3. Check the server log for:

   [MMOSkillTree] MMOSkillTree detected - will connect when needed
   [MMOSkillTree] MMOSkillTree integration enabled

No additional setup is needed. The integration activates automatically when MMO Skill Tree is present.

Configuration

All MMO Skill Tree settings live inside the Integrations block of your config.json:

{
  "Integrations": {
    "MMOSkillTree": {
      "FairPlayMode": true
    }
  }
}

Key	Type	Default	Description
FairPlayMode	boolean	true	When true, skills are saved and reset on arena entry, then restored on exit. This ensures all players compete on equal footing regardless of their skill-tree progression. Set to false to let players keep their skill bonuses inside arenas.

tip

Set FairPlayMode to false if you want high-level players to have an advantage inside arenas (RPG-style progression). Keep it true for a level playing field.

Data Persistence

Skill snapshots are stored as JSON files in:

mods/arenapvp/data/skills/
  550e8400-e29b-41d4-a716-446655440000.json
  ...

Each file contains a map of skill IDs to XP values:

{
  "MINING": 125000,
  "SWORDS": 89000,
  "DEFENSE": 45000,
  "WOODCUTTING": 67000
}

info

If a player disconnects and the server restarts before they reconnect, their skill data is safely preserved on disk. The next time they join, the reconnection system will restore both inventory and skills.

Without MMO Skill Tree

If MMO Skill Tree is not installed, the integration is silently disabled. No errors are logged and arenas function normally — players simply keep their skills during matches.