Configuration

Admin UI

The fastest way to configure common settings is via /mmoadmin:

• Disable XP in Creative - Toggle whether creative mode players gain XP
• Skill Permissions - Toggle permission-based skill access
• Item Rewards - Enable/disable item rewards at milestones
• Boost Stacking Limits - Configure max multiplier, active boost caps, and stack mode
• Allow Skill Tree Reset - Toggle whether players can respec their reward choices
• Max Levels - Set a default max level for all skills (shipped default: 200) and override it per-skill. XP stops being awarded once a skill reaches its cap
• Milestone Announcements - Run commands when players reach configurable level milestones (e.g., broadcast achievements with /say)
• Award Boost - Grant boost permissions or tokens to players
• Mob Kill XP - Configure per-mob XP values and weapon scaling for kill-only combat mode
• Edit XP Maps - Visually edit XP values per skill
• Edit Rewards - Visual editor for command rewards per skill and level
• Edit Skill Tree - Customize skill tree reward tiers, levels, and choices
• Edit Tokens - Browse and modify XP token and boost token values

Changes made via /mmoadmin are saved immediately to the config files.

In-Game Help Guide

Every admin page has a ? button that opens a contextual help card for that specific feature. Each card has an Overview, How It Works, Examples, and Tips section, plus a link to the full online docs. The help content is localized through the standard language files so translated servers get a fully localized guide.

Config Files

The mod's own configs live in mods/mmoskilltree/ (29 files plus the quests/, achievements/, and optional localization/ folders). A second folder, mods/ziggfreedcommon/, is generated by the required companion jar and holds the files listed further down.

Shared library files (mods/ziggfreedcommon/)

The required ZiggfreedCommon jar keeps its own folder beside this one, because it owns the engines behind wallets, storefronts, boards, placed NPCs and the placed-block ledger. Some of these are yours to edit; the runtime stores are not.

What each one holds, and which content folders they override, is on ZiggfreedCommon: shared engines & files.

Config Types

Override-Based Configs

Most config files (hud-layout.json, ability-settings.json, ability-overrides.json, power-level.json, ability-clamps.json, mastery.json, combat-text.json, feedback.json, npc-placements.json, dialogues.json, world-rules.json, xp-maps.json, bonus-drops.json, skill-tree.json, command-rewards.json, mob-kill-xp.json, mob-drop-commands.json, xp-tokens.json, item-requirements.json, action-requirements.json, boost-templates.json, custom-skills.json, reward-icons.json, integrations.json) use an override system:

• Files store only your customizations, not all defaults
• Your changes are preserved across mod updates
• New defaults are added automatically
• Use /mmoconfig diff to see what you've changed
• Use /mmoconfig trim to remove redundant XP entries - rows that merely restate a built-in value. It applies to XP overrides only; every other override layer merges field by field over an asset rather than restating it whole, so there is nothing redundant for a trim to find

Traditional Configs

Other configs store all values and may be regenerated on version updates. Your old config is backed up automatically.

Quick Config Examples

# Set diamond ore to 150 XP
/mmoconfig mining --args=Ore_Diamond_|150

# All ores give 25 XP (wildcard pattern)
/mmoconfig mining --args=Ore_|25

# Disable a default pattern
/mmoconfig disable --args=mining|Wood_Log

# View your customizations
/mmoconfig diff --args=mining

# Remove a customization (revert to default)
/mmoconfig remove --args=mining|Ore_Diamond_

# Harder early game
/mmoconfig basexp --args=400

# Easier endgame
/mmoconfig scale --args=150

Detailed Guides

• Content Packs - Author content as a pack
• XP Values Configuration - Customize XP per block, item, and weapon
• Leveling Formula - Understand and tune the XP curve
• Anti-Exploit Features - Placed block tracking, entity blacklist
• Skill Tree - Customize reward tiers, choices, and combat targeting
• Command Rewards - Customize item rewards at skill milestones
• Mob Kill XP - Configure per-mob XP values and weapon scaling for kill-only combat mode
• Mob Drop Commands - The simple kill surface: run console commands or a native item drop when a mob dies
• Bonus Drops - Everything extra a broken block or a killed mob hands over, in one table you can re-tune row by row
• ZiggfreedCommon - What the required companion jar owns, its content folders, its owner files, and its commands
• Quests - Create quests with objectives, prerequisites, and rewards
• XP Tokens - Configure consumable XP tokens and boost tokens
• Achievements - Player achievement system with points, meta-chains, and server-first claims
• Power Level - Multi-pillar power formula for the optional MMO Mob Scaling companion mod

Notification Tuning

Combat can produce a lot of floating notifications - damage numbers, XP gains, crits, defense blocks, combo finishers. Two knobs control the noise level:

• Notification batching - notificationBatchMs in skill-config.json (100 to 5000ms, default 1000) aggregates same-type notifications into one combined number.
• Per-type toggles - players can silence individual notification channels (critical hits, lifesteal, defense blocks, fall damage, combo damage) from the Settings page, while keeping everything else on.

Reference Files

The mods/mmoskilltree/_reference/ folder contains read-only files showing all default values: one defaults-<config>.json per override config, for example defaults-xp-maps.json and defaults-skill-tree.json.

defaults-luck-loot.json is retired and retires itself on the first start after upgrading. The built-in lucky-find rows are readable files inside the jar now, at Server/MMOSkillTree/BonusDrops/, and each one carries comments explaining what it does. See Bonus Drops.

Hot Reload

Most config changes can be applied without restart:

• /mmoconfig reload - Reload all configs from files
• /mmoconfig reloadlang - Reload language files
• /mmoconfig reloaddefaults - Reset to built-in defaults
• /mmoability reload - Re-read the ability catalogue and your ability overrides
• /mmoquestadmin reload - Re-read the MMO's own quest files and pack layers
• /zigprogress reload - Fold the shared quest and achievement assets again and publish them

Wallets, storefronts and boards reload with the asset stores rather than through a config command of their own, because their content lives in the shared library's folders. Run /zigcommerce validate afterwards to confirm the catalogue reads the way you meant it to.

Backing up and restoring your configuration and player data is covered once, on Server Operations: Backup & Recovery.