Description
MMO Skill Tree
A fully customizable RPG skill progression system for Hytale, inspired by mcMMO and RuneScape - hotbar abilities, triggered passives, quests, achievements, and a deep skill tree.
Level up 20 skills, unlock 32 hotbar abilities, claim Lv 100 capstone passives, complete quests, hunt ~200 achievements, and climb the leaderboards. Every block you mine, tree you chop, and enemy you defeat builds toward a character that's truly yours - solo or on a server.
Everything runs through clean in-game menus, so there are no commands to memorize. Server owners get a visual admin dashboard to retune all of it - no config files required.

Required dependency: Ziggfreed's CommonLib
MMO Skill Tree needs the free Ziggfreed's CommonLib library jar to run. Download
ZiggfreedCommon-1.1.1.jar(or newer) and drop it into your server'sMods/folder next to the MMO Skill Tree jar. It is a separate file that loads first automatically; without it, the mod will not load. CommonLib adds no commands, config, or content of its own, it is shared plumbing the mod stands on.
Features
20 Skills
- Gathering - Mining, Woodcutting, Excavation, Harvesting, Fishing
- Combat - Swords, Daggers, Polearms, Staves, Axes, Blunt, Archery, Magic, Artillery, Unarmed, Defense, Acrobatics
- Crafting & Misc - Crafting, Enchanting, Building
Prefer to build your own? Add custom skills in custom-skills.json, or disable any built-in skill you don't want.
Active Abilities
32 hotbar abilities across ten skills - unlock them in the skill tree, bind with /mmoabilities, and cast. Three ability slots each map to one of six Hytale inputs (Ability 1 / 2 / 3, alone or with Crouch); pick whatever feels best, and bound slots can also fire from reusable Cast Items so you never have to swap off your weapon.
- Magic - Arcane Missiles, Poison Dart, Fireball / Ice Bolt, Frost Nova / Renewal, Flame Stream, Meteor: burst, control, sustain, and a channeled torrent
- Archery - Hunter's Mark, Piercing / Scatter Shot, Volley, Paralyzing Dart
- Melee (Sword / Axe / Daggers) - empowered swings, momentum dashes with i-frames, and party buffs
- Defense - Shield Bash, Shield Slam, and a Guardian's Call party aura
- Gathering capstones - Seismic Slam (Mining), Lumberjack Leap (Woodcutting), Thorn Patch (Harvesting), Tide Caller (Fishing)
- A dodge for everyone - an 8-way i-frame roll from Acrobatics Lv 4
Choice tiers let you pick 1 of 2 at key levels (Shadowstep vs Vanish, Fireball vs Ice Bolt, and more), and every combat skill carries triggered passives plus two Lv 100 capstones that augment abilities, apply real status effects (stun, slow), or drop damage zones at the kill site. A server-tunable pre-defense damage cap keeps combos in check.
Skill Tree Rewards
Every skill has a reward tree at level milestones (5, 10, 15, 20, 30, 40, 50, 65, 80, 100) plus choice tiers for abilities and unique passives. Early tiers are Pick 1 of 2-3; elite and master tiers let you Pick 2-3 of 5-6. Damage rewards are flat-first (flat values early, rare % multipliers only at Lv 80 / 100) so builds stay balanced instead of snowballing.
Reward types:
| Type | Effect |
|---|---|
| Bonus XP | Gain more XP from actions |
| Max Health / Stamina / Mana | Permanently raise a resource pool |
| Health / Mana Regen | Regenerate a resource over time |
| Damage | Flat or percent damage with attacks |
| Block | Take less damage from hits |
| Critical Chance | Chance for 50% bonus damage |
| Combo Damage | Flat or percent extra damage on combo finisher hits |
| Lifesteal | Flat or percent heal when you deal damage |
| Dodge Counterattack | Bonus damage on your next hit after an i-frame dodge |
| Ability Unlock | Unlocks an active ability or triggered passive |
| Cooldown Reduction | Reduces cooldowns of this skill's abilities |
| Effect Duration | Extends your abilities' status effects |
| Luck | Chance for bonus resources when gathering |
| Fall Reduction | Take less damage from falls |
| Parry rewards | Counterattack, Reflect, Stamina Drain, and Stun Damage (with Perfect Parries) |
Quests
Give players goals to chase - defined in JSON, or with the visual Quest Builder.
- Objective types - break / place blocks, kill mobs, deal damage, pick up items, catch fish, reach skill levels, talk to NPCs, and turn in items, plus three new in 1.4.0: reach a location, eat or drink an item, and spend currency. Any objective can be scoped to a world zone, so a hunt only counts where it should ("in the Howling Sands")
- Quest-giver NPCs with branching dialogue (new in 1.4.0) - hand quests out through NPCs that hold real conversations: progress-aware greetings, option branches, lore, and one-time handouts, with the NPC accepting or turning in the quest right from the chat. Drop a giver beside the world-spawn guide, have one appear the first time players discover a zone, or place it by hand with
/mmonpc. Still works with any external dialogue mod that can run a command - point a button at/mmoquestuito open the quest UI straight from a conversation - Chains & gates - AND/OR prerequisites for branching questlines, total / skill-level gates, and permission checks
- Repeatable with cooldowns - daily quests and farming loops on a timer
- Staged objectives - any order within a stage, sequential between stages
- Flexible rewards - XP, boost tokens, currency, or commands, mixed per quest
- Auto-accept & auto-claim, quest tags, and Main / Daily / Misc categories
Want ready-made content? The free MMO Skill Quest Pack adds two campaign questlines - the Emerald Wilds (starting at world spawn) and the Howling Sands (unfolding once you find the desert) - each with its own quest givers, branching dialogue, and achievements.
Achievements
~200 achievements with progress tracking, point milestones, and server-first claims (the first player to unlock certain achievements is recorded permanently). Multi-criteria meta-cascades chain unlocks, Feats of Strength have no progress bar, and players pin up to 5 to the HUD. ABILITY_CAST objectives track casts (ships with a Spellsword chain at 10 / 100 / 1,000).
Statistics
Persistent lifetime stats in the Statistics view: mob kills, damage dealt, ability casts (per-ability), playtime, blocks broken and items picked up (per type), and fish caught. Achievement criteria read straight from these.
Elite Hostile Mobs
Hostile mobs can roll into elites the moment they spawn - Rare (1.5×), Elite (2.5×), and Legendary (5× HP, with scaled damage). Configurable roll chance, allow / deny filtering, custom tiers, and persistence across chunk unloads. Off by default; one-click toggle in the dashboard.
Bounty Boards & Token Shop
From the free MMO Skill Bounty Pack: placeable board posters offer rotating kill, gather, mine-and-deliver, train, and delivery contracts that pay Bounty Tokens plus skill XP. Everyone sees the same daily and weekly board, accepts what they like, finishes anywhere, and auto-claims; reroll a single contract for a few tokens, and harder contracts lock behind a minimum combat level. Spend tokens at the Token Trader on XP boosts, item caches, and conversions, with a rotating Featured shelf and an XP Exchange. An Adventurer's Guide NPC stands at world spawn as a one-stop hub - and a first-time guided walkthrough of the whole mod. New in 1.4.0: a fast-rotating Quick Contracts board, plus the everyday jobs migrated onto the Daily board as training contracts - steady skill XP for quick jobs between the bigger paydays.
Consumable XP Items & Scrolls
- XP & Boost tokens - flat-XP tokens in 8 tiers (100 up to 500,000 XP) and timed XP-multiplier boosts (personal or global), awarded at skill milestones, hold-to-consume, all tunable in
xp-tokens.json - Utility scrolls - a reusable Skills Menu scroll, plus one-skill and full skill-tree reset scrolls (your XP and levels are always preserved)
Multi-Language Support
Full localization in 9 languages (English, Spanish, French, Portuguese, Hungarian, Turkish, German, Italian, Russian), covering all UI, ability names + flavor + effect summaries, and content (shop offers, quests, achievements, mastery, currencies). Text follows the language you set for the game itself and is resolved by your own client, so there is no separate language to pick; add your own by shipping a .lang file.
Mastery Capes
Reach Lv 100 in a skill to earn its Mastery Cape - 20 in all, plus a Master Cape at total level 1500. Each beats Epic-tier chest armor with damage resistance, bonus health, and skill-themed bonuses; several have custom 3D models. Effectively indestructible (9999 durability) and auto-awarded.
Taming (optional)
Install Alec's Animal Husbandry (built on the Alec's Tamework API) plus the free MMO Skill Taming Pack to add a Taming skill that levels as you feed, breed, and care for your companions, with its own quests, achievements, and boost rewards. Without those mods the skill and its content stay completely hidden, so it never gets in the way.
The Player Experience
No commands to memorize - type /xp and reach everything from there. Act inside a menu (accept a bounty, claim a reward, buy from the shop) and a colored banner confirms it worked, or explains why it didn't, without hiding behind the window.
Skill Overview
A card grid of every skill with level, progress, XP, and active buffs, plus a Total Level summary card and Gathering / Combat / Crafting / Misc tabs. A Stat Sources drill-down breaks every buff stat down to the exact skill-tree rewards and mastery nodes feeding it - scoped per weapon, with each bonus's gating clause ("vs <25% HP", "scope: Swords") spelled out. Quick-action buttons jump to any skill's tree, rewards, and boosts.
Skill Trees

Claim rewards tier by tier - locked tiers are gray, available glow orange, claimed turn green. One-click selection with a confirm, arrow navigation between skills, a respec button, [ACTIVE] / [PASSIVE] tags on ability unlocks, and reward icons with "Lv N" badges on locked picks.
Abilities
Bind unlocked abilities on a searchable, sortable, filterable grid (/mmoabilities) across three slots. A pip-style Cooldown HUD shows ability icons, trigger labels, and timers in an admin-configurable position. Reusable Cast Items let you fire abilities without leaving your weapon held; keyboard inputs work in parallel.
Item Rewards

Claim milestone rewards from tier cards (LOCKED / READY / CLAIMED) with a full preview and an inventory-full safety check, so you never lose an item. Earn Mastery Points every 15 levels to spend in Ability Mastery; currency rewards show their icon and pop a notification with your new total.
XP Boosts

Activate personal or server-wide XP multipliers from the Boosts tab - one-time tokens (global ones tagged [Global]) and permission-based reusable boosts with cooldowns, all one click.
Quests, Leaderboard & Settings
- Quests - filter by category, watch objective progress tick as you play, and accept or claim from quest cards.
- Leaderboard - rank by Total Level or category, drill into individual skills, and always see your own position. Hide your online status in Settings if you prefer.
- Settings - toggle XP and combat notifications, inventory-item ability casting, and online-status privacy. (Language follows your game client; there is no separate language setting.)


For Server Owners
Customize everything from a visual dashboard - no config files required for most settings.
Admin Dashboard

Open it with /mmoadmin. Toggle features (creative-mode XP, permissions, item rewards, quests, leaderboard, elite mobs, abilities), set the default language and per-skill max levels, choose the leveling formula and combat-XP mode, and configure milestone announcement commands, boost-stacking limits, the combat blacklist, ability-HUD position, and the damage cap. An Actions bar gives one-click reload, reset-to-defaults, award-boost, and shortcuts to every editor.
Visual Editors
- XP Values - per-skill XP for every action, with wildcard matching (
Ore_hits all ores), inline editing, an override system, and a diff view - Rewards - per-milestone item and command rewards by category; add, disable, or reset individual rewards, and configure custom levels
- Award Boost - grant boosts by username (one-time token) or UUID (permission-based) with multiplier / duration / cooldown presets and a live preview



XP & Leveling
Hybrid OSRS curve with a meaningful early game and an exponential endgame (Lv 10 = 14k, Lv 50 = 446k, Lv 100 = ~10M), plus anti-exploit protection (no XP from player-placed blocks), a combat-entity blacklist, and per-ability XP routing via the $HELD token.
Permissions & Localization
Permissions are off by default - enable per-skill XP and command nodes from the dashboard when you need them (skills without permission hide themselves from the UI). Localization ships all 9 languages with hot-reload; add a custom one by copying a language file, translating it, and reloading.
Config Files
Most owners never touch JSON, but everything lives in mods/mmoskilltree/ for advanced control. Override-based configs store only your changes and auto-backup on every update.
| File | What You Can Customize |
|---|---|
skill-config.json |
Leveling formula, default language, permissions, placed-block tracking, combat-XP mode + blacklist, boost-stacking limits, damage cap, dodge timing |
abilities.json |
Every active ability and triggered passive - damage, cooldowns, radii, models, sounds, animations, on-hit effects, XP routing, HUD position |
combat-text.json |
Colored floating text (red crit, gold level-up) - master and per-event toggles plus a configurable color per event |
feedback.json |
Sound + optional camera-shake cues per moment (crit, finisher, kill, level-up, bounty). Combat sounds ship off by default |
bounty-board.json |
Bounty board schedules - rotation, selection, slot / difficulty mix, reroll cost, per-board and global on/off, per-difficulty combat-level gate. Bounties ship in a content pack like the MMO Skill Bounty Pack |
token-shop.json |
Token Shop catalog + global on/off. Offers ship in a content pack (cost, reward, optional combat-level / per-day gate); packs can add rotating Featured pools |
spawn-hub.json |
The Adventurer's Guide hub NPC at world spawn (on by default as an onboarding guide; gains bounty / shop tiles with the Bounty Pack) - toggle, role, offset / facing, and the worlds list it spawns in (defaults to default; "*" = all worlds, empty = none) |
quest-givers.json |
Quest-giver NPCs - placement (spawn beside the world-spawn guide, appear once on zone discovery, or place by hand), role, and the dialogue or quest list each opens. Quest-giver content ships in a content pack like the MMO Skill Quest Pack |
dialogues.json |
Branching NPC dialogue trees - progress-aware greetings, option branches, conditions, and actions (accept / turn in a quest, hand out a one-time reward, open a menu). Drives TALK_TO_NPC objectives |
world-rules.json |
Per-world rules matched by world name (with Name_* prefixes for instanced worlds): an XP multiplier (0 off, 0.5 half, 2.0 double), a combined abilities + HUD toggle (off silently blocks casting + hides the cooldown / quest HUDs), a weapon-combat toggle (off = vanilla combat: no crit / lifesteal / skill-tree + mastery damage / defense), and a per-world disabled-skills list. Unlisted worlds are unaffected |
xp-maps.json |
XP per block / item / weapon for each skill |
luck-loot.json |
Luck bonus loot tables |
skill-tree.json |
Milestone levels, reward choices, multi-select tiers, ability-unlock placement |
command-rewards.json |
Item rewards and commands at skill milestones |
mob-kill-xp.json |
Per-mob base XP for kill-only combat mode |
mob-drop-commands.json |
Command-based mob drops with chance, delay, and notifications |
xp-tokens.json |
XP token amounts, boost multipliers / durations, enable / disable |
item-requirements.json |
Skill-level requirements for items, weapons, and blocks |
action-requirements.json |
Tool-type requirements for blocks, weapon-type requirements for mobs |
boost-templates.json |
Permission-based boost definitions (multiplier, duration, cooldown) |
custom-skills.json |
Custom skill definitions and built-in skill enable / disable |
elite-mobs.json |
Elite mob tiers, roll chance, and filtering |
white-label.json |
Server branding (name, description, logo) on UI pages |
reward-icons.json |
Per-skill / per-target / per-reward-type icon overrides |
integrations.json |
Enable / disable / prioritize mod integrations (auto-generated) |
quests/*.json |
Quest definitions, objectives, rewards, categories, prerequisites |
achievements/*.json |
Achievement definitions, criteria, milestones, server-first claims |
localization/*.json |
All text in any language |
Item Level Requirements (item-requirements.json) and tool-type requirements let you gate weapons, tools, armor, and blocks behind skill levels (per-skill, multi-skill, or total level), with held-tool checks when mining and wildcard pattern matching. Ores ship with Mining defaults by tier. Both are off by default.
Don't want to edit JSON? The Config Manager adds visual builders for quests and settings, shareable config presets, and a community gallery.
Commands Reference
Most features are reachable from the UI, but commands are there for quick actions and automation:
| Command | Description |
|---|---|
/xp |
Open the skill overview UI |
/mmoabilities |
Open the ability bind page (alias: /mmoability) |
/quest |
Accept, claim, abandon, and check quest progress |
/mmoquests |
Open the quest log UI (aliases: /mmoquestlog, /mmoql) |
/mmoleaderboard |
Open the leaderboard UI (aliases: /mmolb, /mmorankings) |
/mmoboosts |
Open the boosts UI (alias: /mmoxpboosts) |
/mmoadmin |
Open the admin dashboard |
/setmmoxp {skill} {value} |
Set XP for yourself or a target player |
/bulksetxp {skill} {value} |
Set XP for multiple or all players |
/mmoboost |
Manage XP boosts (give tokens, start global boosts) |
/mmoquestui |
Open the NPC quest UI for a player (admin / console) |
/mmoawardxp {player} {skill} {amount} |
Add XP to a player (admin / console) |
/mmoquestadmin |
Admin quest management (reload, give, reset, complete, status) |
/mmoconfig |
Advanced config commands (see full list) |
Installation
- Download the
.jar, drop it in your server'smods/folder, and start the server. - Play. Any config customizations auto-back up in
mods/mmoskilltree/whenever the mod updates.
Recommended: Perfect Utils
Recommended for full ability behavior - it provides the low-level primitives behind crowd control:
- Stun on hit - Shield Bash, Shield Slam, and Paralyzing Dart actually freeze the target's movement and AI (without it, the hit lands but the target keeps attacking)
- Aggro drop / taunt - Shadowstep and Vanish drop nearby mob aggro on cast
The plugin auto-detects it at startup; without it, those abilities still cast and spend resources, they just lose the CC payload.
Optional integrations
These mods integrate automatically when installed alongside MMO Skill Tree:
- Perfect Parries - unlocks the four Parry reward types (Counterattack, Reflect, Stamina Drain, Stun Damage) on the skill tree
- Angler's Almanac - rod-catch XP from the biome-driven fishing overhaul, wired to the FISHING skill
- Alec's Animal Husbandry (built on the Alec's Tamework API) - unlocks the optional Taming skill; pair it with the MMO Skill Taming Pack for Taming quests, achievements, and rewards
- SimpleEnchantments - enchanting items awards Enchanting XP scaled to enchantment level
Roadmap
- Class System (future) - pick a class identity (Adventurer / Warrior / Hunter) with per-skill bonuses, advancement ranks, and a Class Hub menu. Ships as a free drop-in Classes Pack.
- Proving Grounds (future) - a solo dungeon system (via the optional MMO Skills Instances sibling mod) with mob encounters, entry requirements, rewards, and time-attack leaderboards.
- Server-wide competitions and seasonal events
- More Lv 100 capstones and unique passives
- More skills and reward types
Full Changelog
v1.4.3
Two fixes for bounties you have already accepted: drop one from the Quests menu, and always collect a finished one even after it rotates off the board.
- New: abandon an accepted bounty from the Quests menu. Bounties you have picked up carry an Abandon button in the Quests menu, just like a regular quest, and it works even after the bounty has rotated off the board. Turning in and claiming still happen at the Bounty Board.
- Fixed: a finished bounty could become impossible to collect once it expired. A delivery bounty you had not yet handed in, or a reward held back by a full inventory, used to vanish when the bounty rotated off the board. The Bounty Board adds a "Ready to turn in" section at the top of the list with every bounty you can still hand in or claim, no matter the current rotation.
v1.4.2
A hotfix for a Quests-menu crash, a sweep of the same crash across several other menus, and a fix for companion mods that read your MMO skill data.
- Fixed: the Quests menu could disconnect you the moment it opened. On a server with quest categories, opening the Quests menu could drop you at the loading screen ("Disconnected from server. CustomUI Set command couldn't set value"). The category tab buttons are fixed.
- Fixed: the same disconnect (or a button showing a raw "{0}") on several other menus. We audited every menu and fixed the same issue wherever a name or amount appeared on a clickable button: the mastery "Pay with" buttons, the Token Shop and Bounty Board offer lists, the leaderboard skill filter, your tracked-achievement list, the new-player tutorial preview, and some admin pages. Most only affected servers that add custom skills or content. Bonus: the admin skill pickers and leaderboard filter are now translated instead of always English.
- Fixed: companion mods that read your MMO skill data could log an error at startup and lose their integration. Mods like Perfect Parries no longer print a
NoSuchMethodExceptionwarning when the server boots, and their MMO-powered features work again. (The 1.4.0 localization change had removed a method they look up.)
v1.4.1
A hotfix for a skills-menu crash and a few buttons that showed a raw placeholder instead of a number.
- Fixed: the skills menu could disconnect you while an XP boost was active. With a boost running, opening the skills menu could drop you at the loading screen ("Disconnected from server"); the admin Item Rewards editor could disconnect the same way when opened. Both are fixed.
- Fixed: a few buttons showed a raw "{0}" placeholder instead of a number. This affected the bounty board's Turn In button (its progress count), the mastery Refund button (its percentage), and the ability "Restore Items" cooldown button.
v1.4.0
Quest-giver NPCs with branching dialogue, two campaign questlines in a new free pack, three new objective types with zone-scoped goals, an achievements refresh, and a new quick bounty board with daily training contracts.
- New: quest-giver NPCs with branching dialogue. Quests can be handed out by NPCs that hold real conversations - progress-aware greetings, option branches, lore, and one-time handouts - accepting and turning in quests right from the chat. Givers appear beside the world-spawn guide, show up the first time players discover a zone, or get placed by hand. Configured in the new
quest-givers.jsonanddialogues.json. - New: two campaign questlines (the free MMO Skill Quest Pack). A brand-new free pack adds the Emerald Wilds and Howling Sands campaigns, with their own quest-givers, dialogue, and achievements. See the pack's page for the per-questline detail.
- New: a guided start out of the box. The Adventurer's Guide offers a new player a short tutorial or a skip, and both paths hand over the Skill Menu Scroll so the menu is always one item-use away. The tutorial ships in the jar and works with no pack installed (breaking your first block grants the scroll), and finishing or skipping it opens the Emerald Wilds campaign with the Quest Pack installed. Dialogue options can also complete a quest with its rewards or run a command.
- New: three objective types + zone scoping. Quests and bounties can ask you to reach a location, eat or drink an item, or spend currency, and any objective can be scoped to a world zone so a hunt only counts where it should.
- New bounty contracts (the MMO Skill Bounty Pack). A fast-rotating Quick Contracts board and daily training contracts, for steady skill XP between the bigger paydays.
- New: per-world rules (server owners). Set rules per world by name - scale or switch off XP, turn off the whole ability layer and its on-screen HUDs (for a lobby or a story instance), switch weapon combat to vanilla (no crit / lifesteal / skill-tree + mastery damage), or disable specific skills - with a name pattern like
Dungeon_01_*covering a family of instanced worlds at once. Worlds you do not configure are unaffected. Configured in the newworld-rules.json(and pack-authoredWorldRules/*.json). - Achievements refresh. Every achievement shows an icon. New chains reward eating and drinking, spending, and talking to NPCs. The old daily / weekly bounty achievement chains became Feats of Strength - kept as a badge of honor, but no longer worth achievement points. Finishing one of the retired one-time questlines (mining, fishing, the warrior / mage paths, the early one-offs, or the Champion of Orbis finale) now earns a new Feat of Strength, granted automatically at login to players who completed them.
- Every menu reads in your game's language, automatically. All MMO Skill Tree text now follows the language you set for Hytale and is resolved by your own client, so skill / item / currency names always appear in your language. Ability descriptions, mastery bonuses, reward cards, and milestone rewards describe themselves and translate too (including a few spots that used to show in English regardless of locale), and boost rewards read as a clean line instead of baked-in text. The Taming Pack's quests and achievements are localized into all nine languages too.
- Heads-up: the in-game language setting was removed. There is no longer a language picker in the welcome screen or Settings - MMO Skill Tree follows the language you choose for the game. Server owners still set a default fallback language; floating combat numbers stay in that default language.
- Required: install the Ziggfreed's CommonLib companion jar. 1.4.0 needs
ZiggfreedCommon-1.1.1.jarin your mods folder alongside the MMO Skill Tree jar (a separate file that loads first); without it the mod will not load. - Heads-up for existing servers. The built-in daily quests moved into the Bounty Pack's new boards (install the pack to keep them), and a handful of retired achievements no longer grant their old points; see the patch notes for details.
Older versions
Per-version notes for v1.3.2 and earlier live in patch-notes/ and on the docs site:
- Patch Notes - user-facing notes for every release
- Developer Changelog - full technical detail
Links & Support
Questions or suggestions? Join the Discord or leave a comment. Full docs at mmo-skill-tree-docs.ziggfreed.com.
Developed by: ZiggFreed @ Wintergreen Solutions
Support Development: Ko-fi | Buy Me a Coffee
MMO Skill Tree is not affiliated with Hypixel Studios or Hytale.







