Download

Troubleshooting

Common issues and solutions

Not Gaining XP

Check Creative Mode

disableXpInCreative is true by default. If you're in creative mode, you won't gain XP.

Solution: Switch to survival mode, or disable the setting:

/mmoconfig creative --args=false

Check Permissions

If permissions are enabled, ensure you have mmoskilltree.skill.* or the specific skill permission.

Check if permissions are enabled:

/mmoadmin

Check Placed Block Tracking

You cannot gain XP from blocks you placed yourself (anti-exploit feature).

Solutions:

  • Break blocks placed by other players or world generation
  • Wait for placedBlockExpireMinutes if configured
  • Disable tracking: set trackPlacedBlocks: false in config

Config Changes Not Saving

  • Use /mmoconfig reload to reload from file
  • Check file permissions on the config directory
  • Ensure valid JSON syntax in config files

Commands Blocked

If commands say "no permission":

  • If permissions are enabled, you need mmoskilltree.command.* permissions
  • Admin commands require OP or mmoskilltree.admin permission

LuckPerms: OP Not Working

If you're using LuckPerms and "Enable Permissions" is OFF in /mmoadmin, you need the wildcard permission to act as OP:

/lp user <player> permission set * true

Alternatively, turn "Enable Permissions" ON and grant mmoskilltree.admin instead.

Rewards Not Appearing

  • Skill tree rewards require manual claiming via /skilltree
  • Item rewards require manual claiming via /xp → Rewards tab
  • Check if you meet the level requirement

Wrong Stat Bonuses After Update

Run /mmoconfig reload - stats are auto-recalculated on config version changes.

If issues persist, players can reset their skill tree and reclaim rewards.

Leaderboard Issues

Crash on multi-world servers: Fixed in v0.4.7. Update to the latest version.

This issue occurred with dungeons, temples, and other world instances.

Language Issues

Backup Files in Selector

Fixed in v0.3.2. Backup files (messages-en_backup.json) no longer appear in the language selector.

Missing Translations

Missing keys fall back to English automatically. No raw keys are ever shown.

Getting Help

  • Discord: Join Server
  • Issues: Report bugs on CurseForge or Discord
  • Config Questions: Use /mmoconfig diff to see your changes

Backup & Recovery

  • Configs auto-backup when mod updates (look for *_backup.json files)
  • Player data is stored in the world's entity data (ECS components)
  • Leaderboard cache is in mods/mmoskilltree/leaderboard-cache.json

Common Error Messages

"Entity contains component type"

Fixed in v0.2.1. This crash occurred when multiple XP events fired in the same tick.

"Assert not in thread"

Fixed in v0.4.7. This occurred when accessing player data across world threads (leaderboard).