MMO Skill Tree

MMO Skill Tree

A fully customizable RPG skill progression system for Hytale inspired by mcMMO and RuneScape

Level up 23 skills, unlock powerful rewards, 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.

Server owners: Customize XP values, leveling speed, skill tree rewards, and add your own languages - all through simple config files with hot-reload support.

Features

23 Skills Across 4 Categories

Gathering - Mining, Woodcutting, Excavation, Harvesting, Fishing

Combat - Swords, Daggers, Polearms, Staves, Axes, Blunt, Archery, Unarmed, Block, Taming, Acrobatics

Crafting & Misc - Crafting, Repair, Alchemy, Enchanting, Cooking, Smithing, Building

Skill Tree Rewards

Every skill has a reward tree unlocked at level milestones (5, 10, 15, 20, 30, 40, 50, 65, 80, 100). 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

10 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

Damage Deal more damage with attacks

Block Take less damage from hits

Critical Chance Chance for 50% bonus damage

Lifesteal Heal when you deal damage

Luck Chance for bonus resources when gathering

Fall Reduction Take less damage from falls

Mana System: Players start with 0 mana - it must be earned through skill tree choices!

Rewards are tailored to each skill category:

Staves - THE mana class! Bo staff masters unlock massive mana pools (360+ potential)

Archery - High mana for wand and spellbook users (290+)

Crafting - Moderate mana for enchanters and magical crafters

Gathering skills offer Luck, Stamina, defensive bonuses, and minimal mana

Physical Combat (Swords, Daggers, Axes, etc.) - Warriors rely on steel, not sorcery

Block focuses on damage reduction, health, and survivability

Acrobatics specializes in fall damage reduction (up to 60%!) and stamina

Multi-Language Support

Play in your preferred language! The mod includes full localization for all UI text, notifications, and skill tree rewards.

8 Languages Included - English, Spanish, French, Portuguese, Hungarian, Turkish, German, and Italian

Language Selector - Change language instantly in Settings

Custom Languages - Add your own translations

Community Translations - Share language files with other servers

Permission System

Fine-grained control over who can use skills and commands. Disabled by default for easy setup - enable only when you need it!

Skill Permissions - Control which players can gain XP in specific skills mmoskilltree.skill.* - Wildcard for all skills

mmoskilltree.skill.mining, mmoskilltree.skill.swords, etc.

Skills without permission are hidden from UI pages and excluded from totals

Command Permissions - Control access to plugin commands mmoskilltree.command.xp - View skills

mmoskilltree.command.setxp - Admin XP command

mmoskilltree.command.setxp.others - Set other players' XP (--target)

mmoskilltree.admin - Admin config and boost commands

Opt-in System - Permission checking is disabled by default Enable via /mmoconfig permissions --args=true or toggle in /mmoadmin

When disabled, all players can use all features

XP Boost System

Boost XP gains for yourself or your entire server! Perfect for events, VIP perks, or rewarding active players.

Global Boosts - Affect all players on the server

Personal Boosts - Affect only the activator

Target Options - All skills, specific skill, or skill category

Additive Stacking - Multiple boosts combine (1.5x + 2x = 2.5x total)

Cooldown System - Prevent boost spam with configurable cooldowns

Boost Tokens - One-time boost awards via admin commands

Award tokens with /mmoboost give --args=<player>|<target>|<mult>|<mins>|[scope]

Personal tokens boost only that player; global tokens boost everyone when activated!

Tokens are stored until the player chooses to activate them

Works for offline players - tokens delivered when they log in

Perfect for quest rewards, events, or special promotions

No permission required - players simply click to activate!

Boost UI - Access via "Boosts" tab in /xp

Active Boosts - Currently running boosts with time remaining

Boost Tokens - One-time tokens ready to activate (shows [Global] tag if server-wide)

Reusable Boosts - Repeatable boosts from permissions (with cooldowns)

Permission-Based Activation (Repeatable):

mmoskilltree.xpboosts.<target>.<scope>.<multiplier>.<duration>.<cooldown>

Example: mmoskilltree.xpboosts.mining.self.2_0.30.60 - 2x Mining, self-only, 30min, 1hr cooldown

Admin Command: /mmoboost (use | between values in --args=)

give --args=<player|*>|<target>|<mult>|<mins>|[scope] - Award token (scope: personal or global)

global --args=<target>|<multiplier>|<minutes> - Immediate server-wide boost

list / clear --args=[player] / status --args=[player] - Management commands

Player-Friendly Interface

Skill Overview (/xp) or (/mmoxp)

View all skills with levels and progress bars

Filter by category: Gathering, Combat, Crafting, Misc

Quick access to skill trees via "View Tree" buttons

See total level and XP at a glance

Skill Tree Page

Navigate between skills with arrow buttons

Clear tier status indicators: Locked (gray), Available (orange), Claimed (green)

One-click reward claiming

Reset button to respec your choices

Settings Page

Toggle XP gain notifications on/off

Set minimum XP threshold for notifications

Toggle combat effect notifications (lifesteal, crits)

Choose your preferred language

Leaderboard

View player rankings across your server - including offline players!

Online/offline status indicators (green = online, gray = offline)

Sort by Total Level, Gathering, Combat, or Production

Drill down to see rankings for individual skills

See your own rank highlighted at the bottom

Commands

Command Description

/xp Open the skill overview UI

/xpdisplay {number} Quick notification settings

/mmoadmin Open admin configuration UI (Admin)

/setmmoxp {skill\|all} {value} [--target=player] Set XP for self or target player (OP required for targeting others)

/bulksetxp {skill\|all} {value} [--targets=players] Set XP for one, many, or all players (Admin)

/mmoconfig diff --args=skill\|all\|luck Show only your customizations (Admin)

/mmoconfig trim Remove redundant overrides (Admin)

/mmoconfig reloaddefaults Reset to default config (Admin)

/mmoconfig reloadlang Reload language files (Admin)

/mmoconfig creative --args=true\|false Toggle XP gains in creative mode (Admin)

/mmoconfig permissions --args=true\|false Toggle skill permission checks (Admin)

/mmoconfig blacklist --args=add\|remove\|list [pattern] Manage combat XP entity blacklist (Admin)

/mmoconfig resetrewards --args=player Reset claimed item rewards for a player (Admin)

/mmoconfig formula --args=hybrid\|legacy Switch leveling formula (Admin)

For Server Owners

Total Control Over Progression

Make the mod fit YOUR server's vision. Every aspect of the skill system is configurable without touching code.

XP & Leveling

Set XP values for any block, item, or weapon using pattern matching

Hybrid OSRS leveling - Exponential endgame with meaningful early progression

Early/mid levels are ~10% harder than before, endgame scales exponentially to 10M XP at level 100

Leveling Formula: XP = OSRS_exponential + (base × level × (level-1) / 2)

Default: base=300, scale=200 (balanced progression to 10M at level 100)

Use wildcard patterns (e.g., Ore_ matches ALL ores at once)

Disable XP gains in creative mode (enabled by default)

Anti-exploit protection - Players can't gain XP from breaking blocks they placed

Optional expiration timer for placed blocks to "become natural" again

Deployable protection - Totems and turrets don't give combat XP (configurable blacklist)

Manage entity blacklist via /mmoconfig blacklist command

Enable permission-based XP restrictions (disabled by default)

Debug mode to test high-level gameplay instantly

Item Rewards at Milestones

Receive item rewards when reaching skill milestones

Comprehensive defaults included - All skills have pre-configured item rewards

Rewards scale with progression: Level 10 (Starter): 2-3 basic items (copper tools, common ingredients)

Level 25 (Progressing): 3-4 items (iron/cobalt gear, uncommon materials)

Level 50 (Skilled): 5-6 items (rare materials, gems, better gear)

Level 65 (Expert): Epic-tier materials (Mithril, Adamantite, rare gems)

Level 80 (Advanced): Late-game materials (Onyxium, Prisma, elemental essences)

Level 100 (Master): 6-10 items including legendary weapons (Flame, Void, Spectral)

Total Level milestones: 50, 100, 200, 350, 500, 750, 1000

Example: Mining 100 rewards include Flame Pickaxe, Mithril bars, Voidstones

Manual claiming - Rewards don't auto-claim; use the Rewards UI

Configure via command-rewards.json - add your own items or modify defaults

Item Rewards UI

View and claim your item rewards in-game

Access via "Rewards" tab on the Skill Overview page

See all tiers with status: LOCKED (gray), READY (orange), CLAIMED (green)

Preview reward contents before unlocking

CLAIM button to receive items into your inventory

Items display up to 15 per tier (wrapped across multiple rows)

Toggle between Skill Rewards and Total Level Rewards

Rewards tab glows orange with * when you have unclaimed rewards!

Item Reward Notifications

Get notified when new rewards become available on level-up

Example: "Mining Lv.10 item rewards available! Open /xp > Rewards"

Localized in all 8 supported languages

Command Rewards

Run custom commands when players reach skill milestones

Configure via command-rewards.json - no code required

Works with any skill at any level (e.g., Mining 10, Swords 50, Total Level 100)

Placeholders: {player}, {level}, {skill}, {total_level}

Run as CONSOLE (full permissions) or PLAYER (their permissions)

One-time rewards - commands only execute once per milestone

Perfect for: broadcasting achievements, running custom scripts, server integrations

Skill Tree Rewards

Customize milestone levels (default: 5, 10, 15, 20, 30, 40, 50, 65, 75, 100)

Define reward choices per tier with custom values

Set how many rewards players can pick per tier (multi-select)

Mix and match 10 reward types: XP bonuses, stats, mana, combat effects, luck

Localization

8 languages included (English, Spanish, French, Portuguese, Hungarian, Turkish, German, Italian)

Add unlimited custom languages - just create a JSON file

All UI, notifications, skills, and rewards fully translatable

Hot-reload translations without restart

Zero Downtime

Hot-reload all configs with /mmoconfig reload

Configs auto-backup when mod updates (your customizations are safe)

In-game commands for quick tweaks

Config Files

Located in mods/mmoskilltree/:

File What You Can Customize

skill-config.json Leveling formula, permission settings, placed block tracking, combat XP entity blacklist

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

command-rewards.json Item rewards and commands at skill level milestones

localization/*.json All text in any language

Quick Examples

/mmoconfig mining --args=Ore_Diamond_|150 # Diamond ore = 150 XP /mmoconfig mining --args=Ore_|25 # All ores = 25 XP (wildcard) /mmoconfig basexp --args=400 # Harder early game (default: 300) /mmoconfig scale --args=150 # Easier endgame (default: 200) /mmoconfig creative --args=false # Enable XP in creative /mmoconfig permissions --args=true # Enable skill permission checks /mmoconfig blacklist --args=add Dummy # Block "Dummy" entities from giving combat XP /mmoconfig blacklist --args=list # View current blacklist XP Scale Reference (base=300, scale=200)

Level XP Required Progression

10 14,270 Early game

25 95,573 Early-mid

50 446,222 Mid game

80 2,274,045 Late game

100 ~10,000,000 Endgame

Exponential OSRS curve kicks in at higher levels - level 100 takes real dedication!

Adding Custom Languages

Copy messages-en.json to messages-XX.json (e.g., messages-de.json)

Translate all values (keep keys the same)

Run /mmoconfig reloadlang - new language appears in Settings!

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.

Roadmap

Active abilities with cooldowns

Server-wide competitions and events

More languages!

Full Changelog

v0.5.11 - Admin Toggle & UI Polish

Item Rewards Toggle - New setting in /mmoadmin to enable/disable item rewards

Find it in the "General Settings" section

Disabling hides the Rewards tab from the skill overview page

Perfect for servers that want skill tree rewards but not item drops

Active Boosts Display - See your current XP boosts at a glance on /xp

Boost bar appears above the stats bar when boosts are active

Shows scope [G] global or [P] personal, multiplier, target, and time remaining

Up to 3 boosts displayed

Skill Tree Buff Indicator - Skill tree buffs now show [Tree] prefix

Example: [Tree] +15 HP +5% DMG

Helps distinguish skill tree rewards from other sources

Leaderboard Fix - Total level now correctly sums individual skill levels

Previously used a formula-based calculation which was confusing

Now Mining 50 + Woodcutting 50 = Total Level 100 (intuitive!)

v0.5.10 - Bulk XP Command

New /bulksetxp Command - Set XP for one, many, or all players at once Usage: /bulksetxp <skill|all> <value> [--targets=players]

Target a single player: /bulksetxp mining 1000 --targets=PlayerName

Target multiple players: /bulksetxp swords 5000 --targets=Player1,Player2,Player3

Target all online players: /bulksetxp all 0 (defaults to all)

Aliases: setxpall, masssetxp

Perfect for server resets, events, or bulk player management

Admin permission required

Improved Console Support - /mmoboost command now works more reliably from console

Internal Improvements - Updated command architecture for better stability

v0.5.9 - Permission-Based Skill Filtering & Admin Boost Page

Skill Permission Filtering - When permissions are enabled, skills are now filtered throughout all UI pages Skills without permission are hidden from the XP overview page

Skills without permission are excluded from total and category level calculations

Skill Tree and Item Rewards pages skip unpermitted skills during navigation

Leaderboard skill filters only show skills the player has access to

Category tabs hidden when no skills are permitted in that category (Gathering, Combat, Crafting, Misc)

Players see only what they can level - cleaner, less confusing UI

Admin Permission Help - /mmoadmin now shows permission nodes when permissions are enabled Explains mmoskilltree.skill.* for all skills access

Explains mmoskilltree.skill.mining, .swords, etc. for individual skills

Explains mmoskilltree.command.xp for the /mmoxp command access

Award Boost Admin Page - New UI for granting boost permissions and tokens to players Access via "Award Boost" button in /mmoadmin

Dual input fields: UUID field for recurring permissions (stored in permissions system)

Username field for one-time tokens (delivered immediately if online)

Dynamic skill list - All configured skills shown as clickable buttons

Target categories (All, Gathering, Combat, Production) or individual skills

Preset + Custom values - Quick buttons or type your own: Multiplier: 1.5x, 2x, 3x, 5x, 10x + custom

Duration: 15m, 30m, 1h, 2h, 24h + custom (minutes)

Cooldown: None, 1h, 24h, 7d + custom (minutes)

Live permission preview updates as you configure

Award recurring permissions or one-time tokens with a single click

Perfect for VIP perks, event rewards, or custom rank benefits

Bug Fixes Luck loot with empty values no longer attempts to give items (allows disabling specific blocks)

Disabled luck drops and XP for cracked ores in special terrain (Thorium Mud, Cobalt Slate, Adamantite Magma, Iron Basalt)

Disabled XP patterns (-1 or 0) now properly skip combat skill bonuses

v0.5.8 - Skill Overview Redesign

Redesigned Skill Overview - Complete UX overhaul for the /xp page

Compact Buff Bar - All active buffs in one horizontal line at the top Shows: XP Boost, Damage, Block, Crit, Lifesteal with bright color coding

Inline Skill Buffs - See claimed rewards below each skill's progress bar Example: +15 HP +5% DMG +3% LUCK - values of same type combined

No more navigating to skill tree just to check your buffs

Better Readability - Lighter colors, larger text, wider columns

Cleaner XP Display - Shows 1M instead of 1.2M for large values

Permissions Reload - New /mmoconfig reloadperms command

Reload boost permissions from permissions.json without restart

Refresh button in Boost page reloads permissions in real-time

Total Level Fix - Now excludes skills without XP map data configured

Overview shows global totals, category views show category-specific buffs

Fully localized in all 8 languages

Improved Skill List - Skills list now scrolls when you have many skills active

No more overflow when viewing all skills at once

Wider panel (1100px) for better readability

Combat Reward Targeting - Skill tree rewards can now target specific weapon types

Damage, Critical Chance, and Lifesteal rewards can be restricted to specific weapons

Group targeting: MELEE (all melee), RANGED (archery), or individual skills

Server owners can create weapon-specific builds (e.g., "Sword Master" bonuses)

Backward compatible - existing configs work unchanged (defaults to all combat)

Example config: "combatTarget": "SWORDS" makes a bonus only apply with swords

v0.5.7 - XP Boost System

XP Boosts - Multiply XP gains for players or the entire server Global boosts affect all online players

Personal boosts affect only the activator

Target all skills, specific skills, or skill categories

Additive stacking: multiple boosts combine their bonuses

Cooldown system prevents boost spam (for permission-based boosts)

Boost Tokens - One-time boost awards via admin commands Award tokens to players (online or offline!)

Tokens stored until player chooses to activate

Perfect for quest rewards, events, promotions

No permission required to use - just click to activate

Boost UI Page - New "Boosts" tab in /xp with three sections: Active Boosts - Currently running boosts with time remaining

Boost Tokens - One-time tokens ready to activate

Reusable Boosts - Repeatable boosts from permissions

Permission-Based Repeatable Boosts - Grant boost permissions to players Format: mmoskilltree.xpboosts.<target>.<scope>.<multiplier>.<duration>.<cooldown>

Example: mmoskilltree.xpboosts.all.self.1_5.30.60 (1.5x all skills, 30min, 1hr cooldown)

Perfect for VIP perks or rank benefits

Admin /mmoboost Command - Direct boost management for OPs (use | between values in --args=) /mmoboost give --args=<player|*>|<target>|<mult>|<mins>|[scope] - Award token

Tokens can be personal (default) or global scope - global tokens boost everyone when activated!

/mmoboost global --args=<target>|<multiplier>|<minutes> - Immediate server-wide boost

/mmoboost list / clear --args=[player] / status --args=[player] - Management

Persistence - Global boosts and pending tokens survive server restarts

Defense skill renamed to Block - Clearer naming across all UI and documentation

Full localization - Boost UI translated in all 8 languages (EN, ES, FR, PT, HU, TR, DE, IT)

v0.5.6 - Admin UI & Override System

Admin Configuration UI (/mmoadmin) - Visual interface for server configuration

XP Overrides Editor - Visual editor for customizing skill XP values

Override-Based Config System - Your customizations survive mod updates!

Admin Permission - New mmoskilltree.admin permission for admin features

Bug Fix - Fixed exploit where players could gain combat XP from hitting projectiles

View full changelog →

Developer API

Other plugins can integrate via MMOSkillTreeAPI:

import com.ziggfreed.mmoskilltree.api.MMOSkillTreeAPI; import com.ziggfreed.mmoskilltree.data.SkillType;

// Get player data int level = MMOSkillTreeAPI.getLevel(store, ref, SkillType.MINING); long xp = MMOSkillTreeAPI.getXp(store, ref, SkillType.MINING); int totalLevel = MMOSkillTreeAPI.getTotalLevel(store, ref);

// Modify XP (silent, no notifications) MMOSkillTreeAPI.addXp(store, ref, SkillType.MINING, 100); MMOSkillTreeAPI.setXp(store, ref, SkillType.CRAFTING, 1000);

// Utilities double progress = MMOSkillTreeAPI.getLevelProgress(store, ref, SkillType.MINING); long xpRequired = MMOSkillTreeAPI.getXpRequiredForLevel(10); Additional skills (Fishing, Taming, Alchemy, Cooking, Smithing, etc.) are defined in the API for plugin developers.

Support

Questions or suggestions? Join the Discord or leave a comment!

Full Documentation: mmo-skill-tree-docs.vercel.app

Developed by: ZiggFreed @ Wintergreen Solutions

Support Development: Buy Me a Coffee

MMO Skill Tree is not affiliated with Hypixel Studios or Hytale.