MMO Skill Tree
A fully customizable RPG skill progression system for Hytale inspired by mcMMO and RuneScape — with hotbar abilities, triggered passives, quests, achievements, and a deep skill tree.
Level up 20 skills, unlock 31 hotbar abilities, claim Lv 100 capstone passives, complete quests, hunt ~200 achievements, compete on leaderboards, and become a master of Hytale. Every block you mine, tree you chop, and enemy you defeat brings you closer to mastery — and a build that's truly yours.
Server owners: Customize everything through a visual admin dashboard — XP values, leveling speed, rewards, abilities, languages, and more. No config files required.
Features
- Gathering — Mining, Woodcutting, Excavation, Harvesting, Fishing
- Combat — Swords, Daggers, Polearms, Staves, Axes, Blunt, Archery, Magic, Artillery, Unarmed, Defense, Acrobatics
- Crafting & Misc — Crafting, Enchanting, Building
Active Abilities
31 hotbar abilities across ten skills. Unlock them through the skill tree, bind to slots 7/8/9 via /mmoabilities, and cast on hotkey.
- One basic dodge for everyone — Dodge (Acrobatics Lv 4): 8-way movement-direction roll with 100 ms i-frames, 3.5 s cooldown, 5 stamina. The "get out" button every player picks up early
- Magic spell suite — Arcane Missiles, Poison Dart, Fireball / Ice Bolt (choice), Frost Nova / Renewal (choice), Flame Stream, Meteor. Burst, control, sustain, and a 50-tick channeled torrent
- Archery toolkit — Hunter's Mark, Piercing Shot / Scatter Shot (choice), Volley, Paralyzing Dart. Marks, line shots, AoE rain, and a stun shot that runs on mana
- Sword / Axe / Daggers melee — empowered swings, dashes with momentum + i-frames, party buffs, and a 2.25× post-dash empower on Shadow Pounce
- Defense tank kit — Shield Bash (3-block stun-on-cast + flat +20 follow-up), Shield Slam (dash + stun sweep), Guardian's Call (party 1.4× aura)
- Gathering-skill capstones — Seismic Slam (Mining), Lumberjack Leap (Woodcutting), Thorn Patch (Harvesting), Tide Caller (Fishing). Combat tools that respect each gathering skill's identity
Choice tiers — Pick 1 of 2 at four levels: Daggers Lv 18 (Shadowstep vs Vanish), Magic Lv 22 (Fireball vs Ice Bolt), Archery Lv 28 (Piercing Shot vs Scatter Shot), Magic Lv 32 (Frost Nova vs Renewal). Pick one and the other locks out for that skill until you reset.
Triggered passives — every combat tree (Swords, Daggers, Polearms, Staves, Axes, Blunt, Unarmed, Archery, Magic, Artillery, Defense) has a triggered passive at low / mid level (fires on on_hit_dealt, on_kill, or on_finisher events) plus two Lv 100 capstones (Pick 1 of 2). Capstones augment specific abilities (meteor leaves a burning crater; scatter shot pellets each draw blood), apply real status effects (stun, slow), or drop damage zones at the kill site.
Damage stack cap — server-tunable pre-defense ceiling (maxPreDefenseMultiplier, default 4.0×) protects against runaway combo math.
Every skill has a reward tree unlocked at level milestones (5, 10, 15, 20, 30, 40, 50, 65, 80, 100) plus off-grid choice tiers for ability unlocks and unique passives. Each tier offers multiple reward choices with increasing complexity:
- Early tiers (Lv 5–15) — Pick 1 of 2-3 rewards
- Mid tiers (Lv 20–40) — Pick 1-2 of 3-4 rewards
- Elite tiers (Lv 50–65) — Pick 2 of 5 powerful rewards
- Master tiers (Lv 80–100) — Pick 3 of 5-6 ultimate rewards
- Choice tiers — Pick 1 of 2 mutually exclusive identity-defining options (abilities or unique passives)
Flat-first damage model — low/mid-tier damage rewards are flat values (added after multipliers) that don't compound with weapon-tree % stacks. Percent damage rewards exist only at Lv 80 and Lv 100 as rare endgame multipliers. A maxed Lv 100 build hits ~12% lower peak burst than the old percent-stacking max.
Reward types:
| Type |
Effect |
| Bonus XP |
Gain more XP from actions |
| Max Health |
Permanently increase your health pool |
| Max Stamina |
Permanently increase your stamina pool |
| Max Mana |
Permanently increase your mana pool |
| Health Regen |
Regenerate health over time |
| Mana Regen |
Regenerate mana 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 dodging an attack inside the i-frame window |
| Ability Unlock |
Unlocks an active ability or triggered passive |
| Cooldown Reduction |
Reduces cooldowns of abilities in this skill |
| Effect Duration |
Extends the duration of status effects from your abilities |
| Luck |
Chance for bonus resources when gathering |
| Fall Reduction |
Take less damage from falls |
| Parry Counterattack |
Bonus counterattack damage after parrying |
| Parry Reflect |
Reflect damage back to the attacker |
| Parry Stamina Drain |
Reduce stamina cost of parrying |
| Parry Stun Damage |
Bonus damage to stunned enemies |
Give players goals to chase. Define quests with objectives, rewards, prerequisites, and cooldowns — all through JSON files.
- 9 Objective Types — Break blocks, place blocks, craft items, kill mobs, deal damage, pick up items, reach skill levels, talk to NPCs (with HyCitizens), and turn in items
- NPC Quests — Tie quests to specific NPCs with a dedicated two-panel quest UI. Players discover quests through NPC interaction, with contextual dialogue text that changes based on quest progress. Works great with NPC Dialog — add a dialog button that runs
/mmoquestui to open the quest UI from NPC conversations
- Repeatable with Cooldowns — Perfect for daily quests and farming loops that reset on a timer
- Branching Prerequisites — Chain quests into storylines with AND/OR logic. Create branching paths where players choose between warrior or mage questlines, then converge later. Permission checks can be mixed into prerequisite groups alongside quest completions
- Level Gates — Lock quests behind total level or multiple skill level requirements
- Mixed Sequential & Parallel Objectives — Group objectives into stages — objectives in the same stage can be done in any order, while later stages unlock only after earlier ones are complete
- Multiple Reward Types — Grant XP, activate XP boost tokens, award currency, or run commands on completion. Mix and match reward types in a single quest
- Auto-Accept & Auto-Claim — Quests can start tracking automatically and deliver rewards without manual claiming
- Quest Tags — Tag quests for organization and filtering (e.g., "epic", "combat", "chapter-2")
- Quest Categories — Organize into Main, Daily, Misc, or custom categories with filtering in the UI
- Data-Driven — Define everything in JSON under
mods/mmoskilltree/quests/. Default quests auto-generate as a starting template
- Visual Quest Builder — Prefer a GUI? Design quests and questlines step-by-step on the docs site
Achievements
A full achievement system with progress tracking, point milestones, and server-first claims.
- Per-achievement JSON files under
mods/mmoskilltree/achievements/ — define name, description, criteria, and rewards
- Multi-criteria + meta cascades — chain achievements together so one unlocks another
- Server-first claims — first player to unlock specific achievements gets a permanent recognition; their name is recorded server-side
- Feats of Strength — exclusive achievements with no progress bar, awarded by admin command
- Pinning — players pin up to 5 achievements to the HUD for active tracking
- Subcategories — organize into combat / gathering / casting / etc. with their own filter chips
ABILITY_CAST objectives — track ability casts (any cast, scoped by ability id, or scoped by parent skill). Ships with a 3-tier Spellsword chain at 10 / 100 / 1,000 casts as a canonical example
Statistics
Persistent per-player lifetime stats tracked off-thread and surfaced in the Statistics UI sub-view.
- Combat stats — mob kills, damage dealt, ability casts (lifetime + per-ability), playtime
- Gathering stats — blocks broken (per type), items picked up (per type), fish caught
- Used by achievements —
ABILITY_CAST objectives read these, as do block-break and mob-kill criteria
Elite Hostile Mobs
Make combat more exciting with randomly spawning elite mobs. Hostile mobs have a chance to spawn as elites with boosted stats.
- Three Default Tiers — Rare (1.5x HP & damage), Elite (2.5x HP, 2x damage), and Legendary (5x HP, 3x damage). Add your own custom tiers or adjust existing ones
- On-Spawn Rolling — Elite status is determined the moment a mob appears, not during combat. No mid-fight surprises for the server
- Configurable Roll Chance — 10% base chance by default, adjustable per-server
- Mob Filtering — Use allow/deny lists to control which mobs can become elite. Block training dummies, restrict to specific mob types, or assign custom tiers to individual mobs
- Persistent — Elite status survives chunk unloads. Kill an elite or leave — it stays elite
- Admin Toggle — Enable or disable from the Admin Dashboard with one click. Disabled by default
- Override-Based Config — Only your customizations are saved in
mods/mmoskilltree/elite-mobs.json. Defaults auto-update with mod versions
Physical items that players hold and consume for instant XP or timed multiplier boosts.
- 279 Token Items — Flat XP tokens grant instant skill XP (8 tiers from 100 to 500,000 XP per skill) and Boost tokens activate timed XP multipliers (personal and global)
- Hold-to-Consume — Right-click and hold to use a token. Taking damage interrupts the action
- Flat XP Bypasses Boosts — Token XP is a fixed grant, not affected by active multipliers
- Earned Through Progression — Tokens are awarded at skill milestones (levels 25, 50, 65, 80, 100)
- Fully Configurable — Override XP amounts, multipliers, durations, or disable tokens in
mods/mmoskilltree/xp-tokens.json
Utility Scrolls
Special consumable items for character management.
- Skills Menu Scroll — Opens the Skills menu instantly without typing commands. Reusable (not consumed)
- Skill Tree Reset Scroll — Resets all skill tree reward selections, allowing you to pick new rewards. XP and levels are preserved. Consumed on use
Play in your preferred language. The mod includes full localization for all UI text, notifications, skill tree rewards, and active ability names + flavor + dynamic effect summaries.
- 9 Languages Included — English, Spanish, French, Portuguese, Hungarian, Turkish, German, Italian, and Russian
- Language Selector — Change language instantly in Settings
- Per-archetype ability templates — translators can re-order the auto-generated effect summary sentences to fit each language's natural sentence flow; numeric values come straight from the ability's config so balance changes propagate without re-translation
- Custom Languages — Add your own translations
- Community Translations — Share language files with other servers
Item Level Requirements
Lock items, weapons, and blocks behind skill level requirements. Control what players can use based on their progression.
- Skill-Gated Gear — Require specific skill levels to use weapons, tools, and armor
- Block Mining Requirements — Set mining level requirements for ores and valuable blocks
- Tool Requirements — When mining, both the block AND your held tool are checked. Can't use high-tier pickaxes until you meet their level requirements
- Multiple Skill Requirements — Require different skills at different levels on the same item (e.g., Crafting 30 AND Mining 50)
- Total Level Requirements — Gate items behind combined total level instead of individual skills
- Hard Enforcement — Players cannot mine blocks or deal weapon damage until they meet requirements
- Visual Feedback — Red notification tells players exactly what levels they need
- Admin UI Page — Configure requirements visually through the admin dashboard
- Pattern Matching — Use wildcard patterns to set requirements for entire item categories at once
- Default Ore Requirements — Ores come with Mining level defaults based on tier (Copper: 1, Iron: 10, Silver: 20, Gold: 30, Cobalt: 40, Mithril: 50, etc.)
- Disabled by Default — Both item level requirements and tool type requirements are OFF by default. Enable them from the admin UI when you're ready to add progression gates
Config file: mods/mmoskilltree/item-requirements.json
Reach level 100 and earn a powerful Mastery Cape unique to your skill.
- 20 Mastery Capes — One unique cape for each of the 19 skills with item rewards (including Magic and Artillery), plus a Master Cape for total level 1500
- Legendary Armor Stats — Every cape provides damage resistance, bonus health, and skill-themed bonuses that surpass Epic-tier chest armor
- Skill-Themed Bonuses — Combat capes boost your weapon's damage type, Magic and Artillery capes reward spellcasters and demolitionists, defensive capes maximize survivability, gathering capes provide balanced protection
- Master Cape — The best cape in the game: 20% damage resistance, highest health, mana, and 5% boost to all damage types
- Custom Models — The Master Cape, Swords Cape, and Woodcutting Cape feature unique custom 3D models
- Custom Quality — Gold "Mastery Cape" text with legendary drop particles
- Effectively Indestructible — 9999 durability
- Automatically Awarded — Earned through the Item Rewards system at level 100
The Player Experience
Everything is accessed through in-game UI pages — no commands to memorize. Type /xp to open the skill overview, and everything else is reachable from there.
Skill Overview
The main hub for your character progression. See all your skills at a glance in a card grid layout with levels, progress bars, and active buffs.
- Skill Cards — Each skill displays as a card with an item icon, name, level, progress bar, XP, color-coded buff labels, tier progress, and next reward hint. Icons show the tool or weapon associated with each skill (pickaxe for Mining, longsword for Swords, bow for Archery, etc.)
- Total Level Card — Overview mode shows a special summary card with your combined level, aggregate buffs, and total tier progress
- Category Tabs — Filter by Gathering, Combat, Crafting, or Misc
- Buff Bar — See your active XP boosts, damage bonuses, crit chance, and more at the top
- Quick-Action Buttons — Each card has buttons to open the Skill Tree, Rewards, and Boost pages directly
- Sidebar Tabs — Access Rewards, Boosts, Quests, Leaderboard, Abilities, and Settings from the sidebar
Skill Trees
Each skill has a dedicated tree of reward choices. Pick your build as you level up.
- Tier Milestones — Locked tiers appear gray, available tiers glow orange, claimed tiers turn green
- One-Click Claiming — Click a reward to select it, then confirm to claim
- Arrow Navigation — Browse between skills with left/right arrows at the top
- Reset Button — Respec your choices and pick different rewards
[ACTIVE] / [PASSIVE] tags on every ABILITY_UNLOCK reward so you can tell at a glance which abilities go on your hotbar vs. which trigger on their own- Reward icons show actual item / weapon / stat icons next to reward text; locked rewards are greyed out with a "Lv N" badge so you know which level milestone unlocks each one
Abilities
Bind unlocked active abilities to hotbar slots 7, 8, or 9 and cast on hotkey.
- Bind page (
/mmoabilities) — searchable, sortable, filterable grid of unlocked abilities. Search by name or flavor; sort by Name / Level / Skill; filter by category chip or specific skill; toggle Hide Locked
- Cooldown HUD — pip-style bar with ability icons, hotbar keys, and seconds counters. Coexists with MultipleHUD when installed; admin-configurable position
- Inventory-item casting (opt-in) — for players who scroll the hotbar with the mousewheel. Toggle on; three reusable items appear, one per ability slot. While the mode is on, hotbar slots 7-9 act as ordinary slots
Item Rewards
Earn items and gear when you hit skill milestones. Rewards scale from basic supplies at level 10 to legendary weapons and Mastery Capes at level 100.
- Tier Cards — Each milestone shows its rewards with status: LOCKED (gray), READY (orange glow), CLAIMED (green)
- Preview Before Claiming — See exactly what items you'll receive
- CLAIM Button — One click to receive items into your inventory
- Inventory Check — Won't claim if your inventory is full, so you never lose items
- Toggle View — Switch between individual skill rewards and Total Level rewards
- Notification Glow — The Rewards tab glows orange with a
* when you have unclaimed rewards
XP Boosts
Activate XP multipliers for yourself or the whole server from the Boosts tab.
- Active Boosts — See currently running boosts with time remaining
- Boost Tokens — One-time boosts awarded by admins, ready to activate with a click (global tokens show a
[Global] tag)
- Reusable Boosts — Repeatable boosts granted through permissions, with cooldown timers
- No Commands Needed — Just click the Activate button on any available boost
Quests
Track and complete objectives from the Quests sidebar tab.
- Category Tabs — Filter quests by Main, Daily, Misc, or custom categories
- Quest Cards — Each quest shows its status, description, objectives with progress bars, and unlock requirements
- Accept & Claim — Click to accept available quests or claim rewards when complete
- Requirements Display — Locked quests show what's needed: prerequisite quests, total level, or skill levels
- Progress Notifications — Objective progress updates as you play (e.g., "Mine Stone Blocks 3/10")
Leaderboard
Compete with other players across your server.
- Multiple Views — Sort by Total Level, Gathering, Combat, Production, or Misc
- Skill Drill-Down — Click a category to see rankings for individual skills
- Online Status — Green dots for online players, gray for offline. Players can hide their online status in Settings
- Skill Breakdown — Category views show each player's top 3 skills (e.g., "15 Mining + 6 Woodcutting + 3 more")
- Your Rank — Always see your own position highlighted at the bottom
Settings
Personalize your experience without leaving the game.
- XP Notifications — Toggle on/off, set minimum XP threshold to reduce spam
- Combat Notifications — Toggle lifesteal, crit, and block effect popups
- Inventory-item ability casting — toggle the mousewheel-friendly cast mode on or off
- Online Status Privacy — Choose whether your online status is visible to others on the leaderboard (admins always see true status)
- Language Selector — Switch between 9 built-in languages instantly
For Server Owners
Admin Dashboard
Manage everything through a visual admin panel — open it with /mmoadmin. No config files needed for most settings.
- General Settings — Toggle creative mode XP, permissions, item rewards, quests, leaderboard, elite mob scaling, abilities, and more with simple on/off switches
- Default Language — Set which language new players start with from a dropdown
- Leveling Formula — Adjust base XP and scale values, or switch between Hybrid and Legacy formulas
- Max Levels — Set a default max level for all skills (default: 200) and override it for individual skills. XP stops being awarded once a skill hits its cap
- Milestone Announcements — Run commands when players hit level milestones (e.g., broadcast achievements with
/say). Configure levels, command template, and placeholders
- Boost Stacking Limits — Configure max multiplier cap, active boost limits, and stacking mode
- Combat Blacklist — Add entities that shouldn't give combat XP (e.g., training dummies, specific mob types)
- Ability HUD Position — anchor edge, horizontal align, X / Y offsets — all configurable through dropdowns + text fields
- Damage Stack Cap — tune the pre-defense ability multiplier ceiling (
maxPreDefenseMultiplier)
- Actions Bar — Quick-access buttons for Reload, Reset to Defaults, Award Boost, plus editor shortcuts for XP Maps, Rewards, Skill Tree, Abilities, Mob Kill XP, Tokens, Item Requirements, and Boost Templates
XP Values Editor
Fine-tune how much XP every action gives, all through a visual interface.
- Browse by Skill — Select any skill to see all its XP sources
- Pattern Matching — Wildcards like
Ore_ match all ores at once
- Inline Editing — Change values directly and save
- Override System — Only your customizations are saved; defaults auto-update with mod versions
- Trim Overrides — Clean up redundant overrides that match defaults (also available on the Skill Tree editor)
- Diff View — See just your changes vs. the defaults
Rewards Editor
Customize what items and rewards players earn at each milestone.
- Category Tabs — Browse by Gathering, Combat, Crafting, Misc, Total Level, or All Skills (Global)
- Per-Level View — See all rewards for each milestone with display name, color, and status
- Add Rewards — Create custom rewards with any command, display name, and color
- Inline Disable — Disable individual default rewards without removing the entire level
- Reset to Defaults — One-click restore for any level
- Custom Levels — Type any level number to configure rewards at non-standard milestones
Award Boost Page
Grant XP boosts to players through a visual form.
- Player Targeting — Enter a username for one-time tokens, or UUID for recurring permission-based boosts
- Skill Selection — Click skill buttons to target specific skills, or choose All / Gathering / Combat / Production
- Quick Presets — Multiplier (1.5x-10x), duration (15m-24h), and cooldown (none-7d) preset buttons
- Custom Values — Type any multiplier, duration, or cooldown
- Live Preview — See the resulting permission string or token details before awarding
- One-Click Award — Grant the boost with a single button press
- Hybrid OSRS leveling — Exponential endgame with meaningful early progression
- XP Scale: Level 10 = 14k, Level 25 = 96k, Level 50 = 446k, Level 80 = 2.3M, Level 100 = ~10M
- Anti-exploit protection — No XP from player-placed blocks, with optional expiration timer
- Combat entity blacklist — Block specific mob types, totems, and turrets from giving combat XP (configurable via
/mmoconfig blacklist)
- Ability XP routing — every ability declares which skills gain XP from its damage. The
$HELD token resolves at cast time to the player's currently held weapon skill, with a heldExclude list for filtering. Multi-skill entries stack naturally
Disabled by default for easy setup — enable only when you need it.
- Skill Permissions — Control which players can gain XP in specific skills. Skills without permission are automatically hidden from all UI pages
- Command Permissions — Restrict access to player and admin commands
- Enable via the Admin Dashboard toggle or see the docs for permission nodes
- 9 languages included (English, Spanish, French, Portuguese, Hungarian, Turkish, German, Italian, Russian)
- Set the default server language in the Admin Dashboard
- Add custom languages: copy a language JSON file, translate it, and reload — the new language appears in Settings
- Hot-reload translations without restart
- Active ability names, flavor, and dynamic effect summaries are fully translatable per-language
For advanced customization, config files are located in mods/mmoskilltree/:
| File |
What You Can Customize |
skill-config.json |
Leveling formula, default language, permission settings, placed block tracking, combat XP entity blacklist, boost stacking limits, combat XP mode (Damage / Damage+Kill / Per-Hit / Kill-Only), ability damage stack cap (maxPreDefenseMultiplier), dodge timing window, counterattack arming duration |
abilities.json |
Every active ability and triggered passive — damage, cooldowns, radii, projectile models, sounds, animations, on-hit effects, XP routing, cast conditions, hud.position |
xp-maps.json |
XP per block/item/weapon for each skill |
luck-loot.json |
Luck bonus loot tables (what bonus items drop) |
skill-tree.json |
Milestone levels, reward choices, multi-select tiers, ability unlock placement |
command-rewards.json |
Item rewards and commands at skill level milestones |
mob-kill-xp.json |
Per-mob base XP values for kill-only combat XP 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 tokens |
item-requirements.json |
Skill level requirements for items, weapons, and blocks |
boost-templates.json |
Permission-based boost definitions (multiplier, duration, cooldown) |
action-requirements.json |
Tool type requirements for blocks, weapon type requirements for mobs |
custom-skills.json |
Custom skill definitions (name, category, triggers) and built-in skill enable/disable |
white-label.json |
Server branding (name, description, logo position) on UI pages |
integrations.json |
Enable/disable/prioritize mod integrations (auto-generated) |
elite-mobs.json |
Elite mob tiers, roll chance, mob filtering rules, and behavior settings |
reward-icons.json |
Per-skill / per-combat-target / per-reward-type icon overrides |
quests/*.json |
Quest definitions, objectives, rewards, categories, and prerequisites |
achievements/*.json |
Achievement definitions, criteria, point milestones, server-first claims, feats of strength |
localization/*.json |
All text in any language |
Override-based configs only store your customizations — defaults auto-update when the mod updates. All configs auto-backup on mod updates so your changes are never lost.
Don't want to edit JSON? The Config Manager provides visual builders for quests and settings, config presets you can share, and a community gallery to browse other servers' setups.
Most features are accessible through the UI, but commands are available 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 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 file
- Place in your server's
mods/ folder
- Start the server and play
Upgrading? Any customizations you made to config files will be automatically backed up in mods/mmoskilltree/ when the mod updates.
Recommended companion mod
📌 Perfect Utils — required for full ability behavior. MMO Skill Tree calls into Perfect Utils for the low-level primitives that make combat abilities feel right:
- Stun on hit — Shield Bash, Shield Slam, and Paralyzing Dart attach a
Stun effect; without Perfect Utils the visual lands but the target keeps attacking. With it installed, the target's movement and AI actually freeze for the duration
- Aggro drop / taunt — Shadowstep, Vanish drop mob aggro in a 30-block radius on cast; the (in-development) Challenging Shout taunt redirects mob threat. Without Perfect Utils these abilities still cast and spend resources, but mobs ignore the call
The plugin auto-detects Perfect Utils at startup and logs whether it was found. Without it, the abilities above degrade gracefully — they don't crash or error, they just lose their CC payload.
Optional integrations
These mods automatically integrate when installed alongside MMO Skill Tree:
- Perfect Parries — unlocks the four Parry reward types (Counterattack, Reflect, Stamina Drain, Stun Damage) on the skill tree
- HyFishing — fish-catch XP wired to the FISHING skill
- HyCitizens — TALK_TO_NPC quest objectives, NPC-bound quests, default "Daily Rounds" quest
- SimpleEnchantments — enchanting items awards Enchanting XP scaled to enchantment level
- NPC Dialog — wire
/mmoquestui into NPC dialog buttons
- MultipleHUD — the ability cooldown HUD coexists with other HUD mods (Coordinates HUD, Block Information, Equipment Plus HUD) instead of replacing them
Roadmap
- More active abilities — Daggers L33 / L47, Defense L32 / L38 (a few choice tiers ship with the second option staged for the next release)
- Server-wide competitions and seasonal events
- More Lv 100 capstones and unique passives
- Deeper integration with companion mods (parry, dialogue, NPCs)
- More skills and reward types
v1.0.0
The 1.0 release. Active abilities ship for the first time — the plugin previously granted only passive stat rewards. Top-level additions:
- 31 hotbar abilities + a triggered-passive lattice across the combat trees — see Active Abilities above for the full catalog, choice tiers, and Lv 100 capstone design
- Flat-first damage rebalance — % damage rewards in the early/mid skill tree are gone; flat damage rewards take their place. % damage is endgame-only (Lv 80 / 100), with values roughly halved. Two new unique-passive choice tiers per combat tree at off-grid levels (Lv 11–29 lower, Lv 52–78 upper) add hand-crafted execute-style, full-HP, ability-filtered, and low-HP rage rewards. Maxed Lv 100 build hits ~12% lower peak burst than the old percent-stacking math; mid-game (~Lv 40) drops more sharply because flat doesn't compound — by design
- Real-momentum dashes with i-frames — the five DASH abilities (Leap Strike, Berserker Charge, Shield Slam, Shadow Pounce, Lumberjack Leap) write a one-shot velocity impulse and grant a brief invulnerability window during the slide (150–300 ms per ability, server-tunable per ability)
- Dodge Counterattack passive — Souls-style parry-then-execute. Generalist "+25%" options at Acrobatics T4 / T6 and Defense T4; a fully-invested generalist hits 1.75× damage on every successful dodge counter. Specialist Shadow Counterstrike (Acrobatics T8) and Bulwark Counterstrike (Defense T7) add another +50% when dodging with the matching ability
- Active vs Passive labeling in the skill tree — every
ABILITY_UNLOCK reward wears [ACTIVE] or [PASSIVE] so you can tell at a glance which abilities go on your hotbar vs. which trigger automatically. Orphan reward chips are hidden from the page entirely
- Held-weapon gating — many abilities require the appropriate weapon category (sword for Power Strike, bow for Hunter's Mark, etc.). Hot-swap to the wrong weapon and the cast aborts cleanly — no cost, no cooldown
- Two ways to cast — keyboard hotkey (default) or opt-in inventory-item casting for mousewheel-friendly hotbar navigation
- Damage stack cap — server-tunable pre-defense ceiling (
maxPreDefenseMultiplier, default 4.0×) protects against runaway combo math
- Bespoke ground-AoE visuals — meteor (telegraph ring → fireball drop → cataclysmic burst), volley (cosmetic falling arrows per tick), seismic slam (dust telegraph → rock burst), thorn patch (foliage rustle → poison drips). Cast / impact / tick visuals are separate beats; per-tick sound effects are configurable
- Ability localization — names, flavor text, and the dynamic damage / radius / duration summary are translated per-language. Numeric values come from the ability's config so balance changes propagate without re-translation
Bug fixes
/mmoawardxp works without a trailing world argument — the admin XP-award command no longer requires --world. Run /mmoawardxp <player> <skill> <amount> from console, in-game, or from a quest-reward command and it just works. Old callers that still pass a world name continue to parse cleanly- Custom Skills admin page opens again — the page (and its wizard) crashed silently on open with an internal array index error after the acrobatics movement triggers were added in 0.16.1. Both pages render correctly from every entry point
- Quest claim button refreshes after claiming a repeatable quest — used to stay visible after claim, making it look like rewards weren't dispensed. The page refreshes on a successful claim so the quest moves out of the active list and the row reflects its new state (cooldown, or available again if there's no cooldown)
v0.16.1
- Acrobatics overhaul — trains as you actually move now (sprint, swim, safe landings, dangerous-fall survives) instead of farming fall damage. Fall reduction stacks past 90% across Acrobatics / Unarmed / Daggers / Building / Fishing — hit 100% to take zero fall damage
- Sprint & Swim achievement chains — five-tier each (Jogger → Globetrotter, Wader → Leviathan), plus a Movement Master meta with a 2.5× Acrobatics token and server-wide announcement at 1,000 km sprint + 500 km swim
v0.16.0
- Achievements — WoW-style long-term progression. ~200 defaults across Combat / Gathering / Crafting / Exploration / Misc, plus per-skill leveling chains (Novice → Master). Tracks silently as you play; no "accept" step
- Chains, metas, server-firsts, feats of strength, hidden, pinnable, searchable — chained tiered achievements collapse to the active tier; metas unlock when every child unlocks; 23 server-firsts (Crown of the Realm, Sovereign of Skills, Master of All, plus per-skill); five point-milestone tiers (Bronze → Diamond) with reward bundles
- Persistent statistics — lifetime per-player counters across 11 categories (mobs defeated, blocks broken/placed, items crafted/picked up, damage dealt/taken, deaths, fish caught, XP earned, playtime), with per-item breakdowns for reporting + leaderboards
- Three-column menu UI — main menu pages (
/xp, /mmoachievements, /boosts, /mmoquests) widen and gain a context-specific right panel showing pinned achievements, tracked quests, lifetime stats top-3, and the active boost stack
- Quest tracking — pin up to 5 active quests; tracked quests show on the
/xp side panel with live progress bars
v0.15.0
- Combo Finisher Damage rewards built into every melee skill tree (Swords, Daggers, Polearms, Staves, Axes, Blunt, Unarmed). Per-weapon combo pacing — Axes finish every 2nd hit, Swords every 3rd, others every 4th
- Per-channel combat notification toggles — five separate switches for crit / lifesteal / block / fall / combo, plus the master mute
- Decimal XP values in xp-maps and mob-kill-xp configs
⚠️ Plugin developers: XP-carrying API signatures changed long → double (SkillService.addXpByName, XpMapsConfig, MobKillXpConfig, TriggerResult.xpAwarded, CombatWeaponUtil.getWeaponXpValue). Recompile against 0.15.0+
v0.14.3
- Player-specific level caps via permission node — restrict an individual player's max level per skill (or globally). Per-skill nodes override the
all wildcard
- Elite mob colored particle aura replaces floating nameplates (Rare blue, Elite purple, Legendary gold). Customizable per-tier in
elite-mobs.json
v0.14.2
- Quests can reset other quests on completion —
resetsOnComplete lets a "weekly master" quest reset a group of dailies
- XP listener API for other mods — subscribe to every XP gain event with base/final amounts, level-up flag, and player + skill metadata. Subscribe example →
v0.14.1
- "Monster Slayer" daily quest — slay 30 hostile mobs for +3,500 Acrobatics + 3,500 Defense XP; auto-accept, 24h cooldown
- Placed-block tracking now persists across restarts and is per-world
v0.14.0
- Mob Drop Commands — per-mob command-based drops with multiple independent pools (chance, delay, notification, elite-tier filtering,
{player} / {mob} / {tier} placeholders). Built-in defaults: 5% / 25% / 50% / 100% essence drops by tier
- Admin Help Guide — card-based guide for all 15 configurable features with detailed help pages and per-page "?" buttons. Fully localized
- Elite Mob Tiers admin page — dedicated UI for adding / editing / removing elite tiers with name, weight, multipliers
v0.13.4
- Notification batching for combat / XP / luck during rapid combat or gathering — values accumulate over a configurable window (default 1000 ms; tunable 100–5000 ms) instead of spamming one popup per event
- "Essence Run" daily quest (+500 XP across 5 skills for 100 Life Essence)
v0.13.3
- NPC Quest System — quests bound to specific NPCs, hidden from the main quest log until accepted via NPC interaction. Dedicated two-panel UI with per-objective dialogue text supporting headers, bold, italic
TURN_IN quest objectives — remove items from inventory on turn-in. Supports partial turn-in and NPC-locked variants/mmoquestui admin command for opening the NPC quest UI from a dialog button
v0.13.2
- SimpleEnchantments integration — enchanting items awards Enchanting XP scaled to enchantment level. ENCHANTING gets a full 10-tier mana-focused skill tree
- Direct page commands —
/mmoquests, /mmoleaderboard, /mmoboosts open their pages without navigating through /xp
- Permission prerequisites in quest groups — mix permission checks with quest completions in AND/OR prerequisite logic
- Skill tree reward cards fully localized; performance fixes for servers with many active boosts
v0.13.1
- Dedicated Elite Mobs section in the Admin Dashboard with a separate Nameplates toggle
- HyCitizens NPC integration — TALK_TO_NPC quest objectives auto-trigger on NPC interaction; default "Daily Rounds" quest auto-generates when HyCitizens is detected
v0.13.0
- Elite Hostile Mobs — tiered system (default Rare / Elite / Legendary) where hostile mobs randomly spawn with boosted HP, damage, and damage resistance. On-spawn rolling, allow / deny lists, per-mob tier overrides, projectile / prop safety, admin toggle. Disabled by default
- Quest expansion — branching prerequisites with AND/OR groups, mixed sequential/parallel objectives, structured reward types (XP grants, boost tokens, commands), quest tags, per-player notification level
- Custom Skill Wizard Step 3 now configures command rewards (with
{player} / {level} / {skill} / {totalLevel} placeholders) instead of item requirements
- Combat XP requires hostility for unconfigured mobs to prevent passive-creature farming
v0.12.1
- Boost Activation Command — run a custom command (Discord webhook, log entry, broadcast) every time any XP boost is activated. Filters by scope (all / global / personal) with
{player} / {multiplier} / {target} / {duration} / {scope} placeholders
- Admin Config page reorganized into 4 section cards; in-place updates without scroll reset
v0.12.0
- Skill icons on XP page cards and notifications for every skill; dropdowns replace button selectors across admin pages
- Custom skills fully integrated — navigation arrows, Total Rewards tab, all systems treat custom skills identically to built-in
- Reward targeting works for all reward types (Luck, Bonus XP, etc.) — respect the Target field (ALL / MELEE / SWORDS / etc.)
- Separate skill and command permission toggles with optional alternate prefix
⚠️ Plugin developers: SkillType enum deprecated — all API methods now accept string-based skill IDs for both built-in and custom skills. Migration guide →
v0.11.x
- Magic & Artillery — two new combat skills split from Archery, with full skill trees, mastery capes, XP tokens, and item level requirements
- Custom Skill Creation Wizard — 4-step guided wizard for creating skills with XP maps, command rewards, and skill tree rewards
- Per-reward auto-claim — individual item rewards can auto-deliver on level-up
- Ranged weapon level requirements (bows, crossbows, wands, spellbooks, bombs, guns)
v0.10.x
- Fishing skill — 18+ aquatic mob types, HyFishing integration, mastery cape, full skill tree
- Custom skills system — define your own skills with custom IDs, categories, XP triggers, and full admin support
- Per-skill max level — default 200, configurable per skill via admin UI
- Quest expansion — custom categories, multi-skill requirements, catch-fish objectives
- Mod integration framework — automatic detection and priority-based adapter system (HyFishing, Perfect Parries, HyCitizens, SimpleEnchantments)
- Health & Mana Regen reward types; UI overhaul to native Hytale styling
v0.9.0
- 4 combat XP modes — Damage (1:1), Damage+Kill (hybrid, new default), Per-Hit, Kill-Only
- Item level requirements — lock weapons, tools, and blocks behind skill levels with admin UI
- Default ore requirements — Mining level gates from Copper (1) through Onyxium (80)
- Tool / weapon type requirements
v0.8.x
- Quest system with 8 objective types, hidden quests, search/filters, and auto-generated defaults
- White-label server branding, Skills Menu Scroll, Skill Tree Reset Scroll
- Native boost permissions via LuckPerms/HyperPerms, 124 built-in boost templates
- Kill-Only combat XP mode with 100+ mob defaults
View full changelog →
Support
Questions or suggestions? Join the Discord or leave a comment!
Full Documentation: 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.
