v0.5.1 Patch Notes

New Features

• Target Player XP Command - OPs can now set other players' XP directly
•     /setmmoxp --target= - Set XP for another player
•     Requires mmoskilltree.command.setxp.others permission (default: OP)
•     Target must be online and in the same world
•     Works with all skills or "all" for bulk changes
•     Example: /setmmoxp mining 1000 --target=PlayerName

• Custom Reward Display Names - Configure display names for item rewards
•     Add displayName field to reward entries in command-rewards.json
•     Value must be a localization key (e.g., "reward.mining.starter_kit")
•     Add the key to your localization/messages-*.json files
•     Falls back to "Level X" if key not found or not configured

• Localized SetXP Command Messages - All command messages now support localization
•     Error messages (permission denied, player not found, invalid XP, unknown skill)
•     Success messages (skill set, all skills set, with/without target)
•     Localized in all 8 supported languages

Admin Commands

• Reset Item Rewards Command - /mmoconfig resetrewards --args=
•     Resets all claimed item rewards for an online player
•     Player can re-claim rewards at their current level milestones
•     Example: /mmoconfig resetrewards --args=PlayerName

Balance Changes

• Leveling Curve Rebalanced - Adjusted default leveling parameters for longer progression
•     baseXpPerLevel changed from 100 to 150
•     levelScaleMultiplier changed from 1.1 to 1.35
•     Creates a steeper curve where high levels require significantly more XP
•     Level 50 now requires ~127k XP (was ~69k), Level 100 requires ~1M XP (was ~297k)
•     Existing servers can adjust via /mmoconfig basexp and /mmoconfig scale

• Item Rewards Scaling Improved - Default item rewards scaled up to match harder leveling curve
•     All skill rewards increased 3-5x at higher tiers
•     Life Essence added to all skills at every tier
•     Level 100 rewards now include ~100 Life Essence, ~80 rare bars, ~10-15 Voidheart
•     Total Level rewards scaled up significantly (e.g., Total 1000 now gives 1000 Life Essence)
•     Elemental essences (Fire, Ice, Lightning) quantities increased proportionally

Reward Validation

• Automatic Reward Revocation - Rewards are validated and revoked when player no longer qualifies
•     Triggers when XP is reduced via /setmmoxp
•     Triggers when leveling config changes: /mmoconfig basexp, /mmoconfig scale, /mmoconfig reload, /mmoconfig reloaddefaults
•     Offline players are validated on their first skill action after logging in
•     Revokes all rewards from tiers where player level is now below requirement
•     Removes stat modifiers (health, stamina, mana) via RewardEffectRegistry
•     Displays count of revoked rewards to admin

Config Refactoring

• Config File Split - Separated large SkillConfig into focused configs for easier management
•     skill-config.json - General settings only (leveling formula, permissions, placed blocks, entity blacklist)
•     xp-maps.json (NEW) - XP values per skill (block patterns, weapon tiers, etc.)
•     luck-loot.json (NEW) - Luck bonus loot tables (block pattern -> item ID)
•     Each config has its own version number for independent updates

• XpMapsConfig.java - New singleton config for XP values per skill
• LuckConfig.java - New singleton config for luck loot tables
• SkillConfig.java - Slimmed down, delegates XP/luck methods to new configs (marked deprecated)
• MMOSkillTreePlugin.java - Initializes all new configs on startup