Troubleshooting

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

"My abilities.json edits do nothing"

abilities.json (the old JSON-blob ability-override format) was retired. On first boot after upgrading, the mod moves the legacy file (never reads it) to a timestamped file under mods/mmoskilltree/backup/ and logs a startup warning.

Current ability configuration is split across two places:

• ability-settings.json - server-wide ability toggle and dodge/counterattack timing
• ability-overrides.json - per-ability owner tuning (partial overlays onto the folded ability, defaults < pack < owner)

Full ability bodies live as pack-authorable Server/MMOSkillTree/Abilities/*.json assets. After editing ability-overrides.json, run /mmoability reload to re-fold and re-validate live.

Content Pack Not Loading

Content packs are discovered at server start only. If a pack's content doesn't appear:

• Confirm the pack zip (or unzipped folder) is in the server's mods directory and its manifest has "IncludesAssetPack": true
• Restart the server - dropping a new zipped pack in while the server is running does not load it
• An unzipped pack's file monitor auto-refreshes on save for live edits during development, but a brand-new pack still needs one restart to register
• Check the server log at startup for pack load / validation errors
• Run /mmoconfig validate to surface content audit findings across all domains

Safe Live-Reload Paths

Use one of these instead, depending on what you changed:

• /mmoconfig reload - reloads override configs (including currencies.json)
• /mmoquestadmin reload - reconciles both owner quest files and loaded pack-delivered (asset-driven) quests
• /mmoability reload - re-folds the ability catalog from current pack state plus a fresh ability-overrides.json read, and re-validates
• The pack file-monitor (unzipped packs only) auto-refreshes on save
• A full restart for jar-bundled content, or a brand-new zipped pack drop

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 an earlier release. Update to the latest version.

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

Language Issues

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 an earlier release. This crash occurred when multiple XP events fired in the same tick.

"Assert not in thread"

Fixed in an earlier release. This occurred when accessing player data across world threads (leaderboard).