MMO Skill Tree & Abilities

v0.8.5 - Acrobatics XP & Mob Detection Fix

• Fixed Acrobatics skill not gaining XP - The Acrobatics skill was not awarding any XP. It now correctly awards XP when players survive fall damage
• Improved fall damage detection - Fall damage is now detected more reliably for both Acrobatics XP awards and fall damage reduction rewards
• Improved mob identification in combat - Combat events now identify mobs more accurately, improving combat XP tracking, quest objectives, and entity blacklisting
• New default quest: Forest Patrol - A repeatable kill quest to slay Skeletons in the forest, rewarding Woodcutting XP Tokens on a 90-minute cooldown

v0.8.4 - Quest Config Overhaul & Health Balance Pass

• Default quests auto-generated on every server start - Default quests are now written to mods/mmoskilltree/quests/_defaults/default-quests.json each time the server loads, keeping defaults up-to-date with new mod versions automatically
• User quest files fully replace defaults - Create your own .json files anywhere in the mods/mmoskilltree/quests/ folder (or subdirectories). If any user files exist, the defaults are ignored entirely. The generated default file remains as a reference you can copy and customize
• Legacy example-quests.json migrated automatically - Servers upgrading from older versions will have their example-quests.json moved to mods/mmoskilltree/quests/backups/ automatically
• New default quest - Builder Basics
• Reduced Max Health rewards across all skill trees by 50% - Health bonuses from skill tree rewards were too powerful, allowing high-level players to accumulate excessive health pools. All Max Health reward values have been halved across every skill. Defense remains the highest health-granting skill (up to +28 at level 100, down from +55). Server owners with custom skill tree overrides are not affected
• Quest requirements now shown in the UI - Locked quests now display a "Requires:" line below the description showing what's needed to unlock them: prerequisite quest names, total level gates, and skill level gates. The line appears in green when all requirements are met, or gray when any are unmet
• Quest completion notification now directs to the Quests page - The "quest ready to claim" notification previously told players to use the /quest claim command. It now directs players to open the Quests page in the UI instead

v0.8.3 - Boost Command Improvements

• Underscore delimiter for boost commands - /mmoboost give and /mmoboost global now accept underscores as an alternative to pipes for separating arguments (e.g., /mmoboost give Ziggfreed_mining_2_30 instead of /mmoboost give Ziggfreed|mining|2|30). Pipes still work as before

v0.8.2 - Leaderboard Toggle & Stat Modifier Fixes

• Leaderboard toggle - Server owners can now show or hide the Leaderboard tab from the admin dashboard. When disabled, the Leaderboard tab is hidden from all sidebar pages and players cannot navigate to it. Found in General Settings alongside the existing Quests toggle
• Reset to Defaults warning - The admin dashboard now shows a prominent warning before resetting to defaults, reminding server owners to back up their overrides first
• Fixed orphaned stat bonuses persisting after skill tree changes - When an admin removed or changed a skill tree reward while players were offline, those players could retain phantom health, stamina, or mana bonuses on their next login. Offline players now receive full reward validation on reconnect regardless of whether the change was to XP config or the skill tree
• Fixed stat bonuses not updating during live skill tree edits - Editing skill tree rewards via the admin dashboard or /mmoconfig reload now fully refreshes stat bonuses for all online players. Previously, changing a reward's type or removing a reward could leave stale health, stamina, or mana bonuses applied
• Stat bonuses are now cleared on disconnect - Health, stamina, and mana bonuses from skill tree rewards are stripped when a player disconnects. On reconnect, only rewards that still exist in the current config are reapplied. This prevents stale stat modifiers from carrying over if the skill tree is edited between sessions

v0.8.1 - Quest & Boost Fixes

• Fixed crash when opening Quest page in a new world - Opening the Quest page before performing any quest-tracked action caused a server error. Players with no quest data can now browse and accept quests immediately
• Fixed quest JSON files using unicode escapes - Generated quest files now use clean, human-readable characters instead of unicode escapes like \u003d
• Fixed boost quantity flag only awarding one token - Using /mmoboost give with --quantity= greater than 1 could silently discard all but one token. All requested tokens are now correctly awarded
• Renamed admin quest command - /quests is now /mmoquestadmin, matching the mmo prefix convention used by all other admin commands
• Default XP notification threshold lowered to 3 - New players no longer see notifications for only >= 10 XP gain, reducing confusion about xp gains

v0.8.0 - Data-Driven Quests, Token Editor & Bug Fixes

• Data-driven quest system - Define quests in JSON files under mods/mmoskilltree/quests/. Each quest has objectives, rewards, categories, prerequisites, and level requirements. An example file with starter quests is generated on first run
• 8 objective types - Break blocks, place blocks, craft items, kill mobs, deal damage, pick up items, reach levels, and talk to NPCs. Each objective supports exact, contains, or prefix matching
• Repeatable quests with cooldowns - Mark quests as repeatable with a configurable cooldown period
• Quest categories and filtering - Organize quests into Main, Daily, Misc, or custom categories. Players filter by category in the UI
• Auto-accept, auto-claim, and sequential objectives - Quests can start tracking automatically, deliver rewards on completion without manual claiming, or require objectives to be completed in order
• Prerequisites and level gates - Quests can require other quests to be completed first, a minimum total level, or a minimum skill level
• Command-based rewards with offline delivery - Rewards execute server commands with placeholders. Rewards for offline players are queued and delivered on next login
• Quest UI page - Browse quests from a new sidebar tab with category filtering, state-based display, objective progress tracking, and accept/claim/abandon buttons
• Quest commands - Players use /quest to accept, claim, abandon, and check progress. Admins use /mmoquestadmin to reload config, give quests, reset progress, and force-complete quests
• Progress notifications - Players see a notification on every objective increment (e.g., "Mine Stone Blocks (3/10)")
• Boost page redesigned with sidebar - The Boosts page now has the same sidebar navigation as the Skill Overview and Quest pages
• Give multiple boost tokens at once - The /mmoboost give command now accepts an optional quantity argument (e.g., --quantity=5)
• New admin page for editing XP tokens and boost tokens - Browse and modify all 240 token definitions at runtime through a visual editor. Accessible from the admin dashboard via the new "Edit Tokens" button
• Three browsing modes - Switch between XP Tokens, Personal Boosts, and Global Boosts tabs, each with adapted navigation and table columns
• Override, disable, or reset any token - Change XP amounts, multipliers, and durations. Disable individual tokens or reset them to defaults with one click
• Admins can always reset skill trees - OPs and players with the admin permission can still reset skill tree rewards even when the "Allow Skill Tree Reset" toggle is disabled for regular players
• Fixed leaderboard not updating after admin XP commands - Using /setmmoxp or /bulksetxp now immediately reflects changes on the leaderboard
• Fixed ghost stat bonuses after reward revocation - Revoking renamed or removed skill tree rewards could leave orphaned stat bonuses. These phantom modifiers are now properly cleaned up
• Fixed XP tokens not triggering full level-up effects - Consuming a flat XP token that caused a level-up now correctly fires milestone announcements, item reward notifications, and quest objective tracking
• Fixed combat tracking not identifying mob types - Damage dealt to regular mobs now correctly identifies the entity type, enabling per-mob quest objectives and entity blacklisting
• Entity blacklist now supports specific mob types - Block individual mob types (e.g., trorks) from giving combat XP, in addition to Projectile and Deployable categories
• Fixed player data not initializing until first action - Skill data is now created when a player connects, not on their first block break. All UI pages, settings, and leaderboard entries work immediately on join. New players also receive the server's default language automatically
• Fixed Settings page becoming unresponsive - Clicking toggles or language buttons on the Settings page before skill data was initialized could leave the page stuck in a loading state

v0.7.9 - Reward Card Fixes, Layout & Localization

• Reward cards now display 5 per row - Item reward cards are more compact, fitting an extra column so you can see more rewards at a glance without scrolling
• Fixed empty display names on reward cards - Some rewards (particularly XP tokens and boost tokens) were showing blank names due to a localization fallback issue. Names now display correctly
• Added Void Leather to level 65 milestone rewards - Void Leather added at level 65 for Harvesting, Daggers, Archery, Unarmed, Block, Acrobatics, and Crafting
• Boost names are now fully localized - Boost descriptions, activation messages, and the XP page boost summary now display skill and category names in the player's chosen language
• Global boost broadcast uses server language - The server-wide boost activation announcement now uses your configured default language instead of always English

v0.7.8 - Bug Fixes

FINALLY FIXED combat XP exploit from non-hostile mobs** - Players could farm combat XP by attacking passive creatures. Combat offense XP is now only awarded when dealing damage to hostile entities

• Fixed XP token milestone rewards not giving items - XP tokens awarded at skill levels 25, 50, 65, 80, and 100 were using an incorrect item ID, causing the /give command to fail. Tokens now resolve correctly for all 16 skills
• Fixed reward card display for XP tokens - XP token rewards on the Item Rewards page now show their proper display name instead of raw placeholder text
• Fixed milestone announcement skill names - The {skill} placeholder in announcement commands now uses the proper display name (e.g., "Mining" instead of "mining")
• Removed Woodcutting Fragment craft recipe - The craftable Woodcutting XP Fragment has been removed
• Added gem weapon XP values - Emerald, Sapphire, Cinder, and Ruby weapon variants now have default XP values across all combat skills (Swords, Daggers, Battleaxes, Axes, Maces, and Bows). Adds support for the Emerald Armor, Sapphire Armor & Weapons, and Ruby Armor & Weapons mods

v0.7.7 - Consumable XP Token Items

• 235 new consumable XP items - Physical tokens that players hold to consume. Two types: Flat XP tokens grant instant skill XP (8 tiers from 100 to 500,000 XP across 16 skills), and Boost tokens activate timed XP multipliers (personal and global variants)
• Hold-to-consume mechanic - Right-click and hold to use a token. Taking damage interrupts the action
• Flat XP tokens bypass boosts - Token XP grants are fixed amounts, not affected by active multipliers
• Boost tokens activate instantly - Consumable boost items work through the existing boost system, respecting stacking limits
• XP tokens as milestone rewards - Skills now award XP tokens at levels 25, 50, 65, 80, and 100
• Craftable Woodcutting Fragment - The Woodcutting XP Fragment can be crafted at a Workbench using 300 wood, 2 light leather, and 2 iron bars
• Fully configurable - Override XP amounts, multipliers, durations, or disable specific tokens in mods/mmoskilltree/xp-tokens.json

v0.7.6 - Cape Models, Card Buffs & Balance

• New cape models - The Master Cape, Swords Cape, and Woodcutting Cape now have unique custom 3D models. All capes updated to use the "Back" cosmetic slot
• Master Cape stat boost - 20% damage resistance (up from 18%) and 5% damage enhancement across all attack types (up from 4%)
• Color-coded buff labels - Claimed tree buffs on skill cards now display as individually colored labels matching the buff type instead of plain gray text
• Tier progress metadata - Skill cards now show tier progress (e.g., "Tier 4/10"), XP bonus, and luck percentage below buffs
• Milestone announcement commands - Server owners can run commands when players reach configurable level milestones. Supports {player}, {level}, {skill}, and {total_level} placeholders
• Online status privacy - Players can hide their online status on the leaderboard via a new toggle in Settings. Admins always see true status
• Reduced ore and bar reward quantities - All metal bar milestone rewards reduced by approximately 50% across all skills and total level tiers
• Fixed boost button style - Skill cards with only unused tokens now show a muted button instead of the bright active style

v0.7.5 - Skill Cards Grid & Reset Toggle

• Skill overview redesigned as a card grid - The skill list now displays as a grid of cards (3 per row) instead of flat rows. Each card shows skill name, level, progress bar, XP, claimed buffs, and next reward hint at a glance
• Total Level card in overview - A special summary card appears first when viewing all skills, showing your combined level, total XP, and aggregate buffs. Distinguished by a blue accent background
• Quick-action buttons on every card - Each card can show up to three buttons: "Skill Tree" (opens the skill tree), "Rewards" (opens item rewards for that skill), and a boost percentage indicator (opens the boost page)
• Reward Ready indicators - The Skill Tree button turns orange with "Reward Ready!" text when unclaimed rewards are available at your current level
• Category color coding - Each card has a colored accent strip matching its category: green for Gathering, red for Combat, orange for Crafting, purple for Misc
• Total Level rewards button - The Total Level card includes a Rewards button that opens item rewards in total level mode
• New "Allow Skill Tree Reset" admin toggle - Server owners can now disable the skill tree reset button for all players from the admin dashboard. When turned off, the Reset button is hidden from the skill tree page, preventing respeccing. Found in General Settings of /mmoadmin
• Fixed Storm Hide and Storm Leather item rewards - Corrected item IDs so Storm materials now appear correctly when claimed

v0.7.4 - Skill Tree Admin Editor

• New in-game Skill Tree editor - Server owners can now customize skill tree reward tiers directly from the admin panel. Open /mmoadmin and click "Edit Skill Tree" to browse skills by category, view all tiers, and modify individual rewards
• Override-based customization - Only your modifications are stored in mods/mmoskilltree/skill-tree.json. New default rewards from updates propagate automatically without losing your changes
• Per-tier editing - Select any tier to view rewards, edit values, add new rewards, remove rewards, or adjust level requirements and choice counts
• Disable or reset tiers - Disable entire reward tiers or reset them to defaults with one click
• Status indicators - Color-coded buttons and labels show what's been customized at a glance
• Automatic migration - Existing skill tree configs from previous versions are auto-migrated with backup

v0.7.3 - Reward Claim Fix & Card Layout

• Fixed reward claiming not targeting the correct reward - Claim buttons now reliably trigger the correct reward. The rewards page has been rebuilt with a card grid layout where each reward has its own dedicated claim button
• Rewards are now grouped by level - Clear level separators (e.g., "Level 10", "Level 25") divide rewards into tiers, making it easier to find what you've unlocked
• Card-based layout - Rewards display as compact cards in rows of up to 4, showing item name, quantity, status, and claim button at a glance
• Reward descriptions - Server owners can now add optional description text to item rewards in mods/mmoskilltree/command-rewards.json using the "description" field. Descriptions appear below the item name on reward cards
• Existing configs without descriptions continue to work unchanged
• Click any reward to edit it - Clicking a reward entry in the admin Rewards Editor copies its data into the input fields for editing
• Saving updates existing rewards - If you edit a reward and save, it replaces the original entry instead of adding a duplicate
• Mastering a skill now rewards a global XP boost token - Reaching level 100 in any skill now awards a 1.25x All-Skill Global XP Boost (30 min) token instead of the previous personal skill-specific boost. When activated, this boost benefits every player on the server across all skills
• Celebrating mastery is now a server-wide event - your achievement helps everyone!
• Storm Leather & Storm Hide added to item rewards - New rare crafting materials available at levels 80 and 100 for Defense, Daggers, Archery, Acrobatics, Unarmed, Harvesting, and Crafting, plus Total Level milestones
• Reduced Total Level 350 rewards - Material quantities rebalanced to better match the progression stage
• Master Cape moved to Total Level 1500 - The Master Cape is now a long-term goal awarded at Total Level 1500 instead of 1000

View full changelog →