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
• Almanac Tab - When the menus show the Almanac tab: whenever the Almanac lists a season (the default), only while a season runs, or never. It is stored in mods/ziggfreedcommon/almanac.json as $MenuTab (Show, OnlyWhileLive)

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 to 150 XP
/mmoconfig mining --args=Rock_Gem_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|Rock_Gem_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 holds read-only copies of the defaults the mod keeps in its own code, one defaults-<config>.json for each config that has them: XP values, mob kill XP, item and action requirements, the skill tree, command rewards and reward icons. Each file shows what the mod ships, not what packs add, and it is rewritten only when its contents change. The skill tree's file is the one exception: it follows your own milestone settings. The mod never reads these files, so editing one does nothing.

A config built on assets has no reference file. Its defaults are the asset files inside the jar, or in the pack that adds the feature, and you can read them there or in the in-game Asset Editor. World rules, power level, bonus drops, abilities and mastery tracks all work this way.

Older reference files that nothing writes any more, such as defaults-luck-loot.json and defaults-mastery.json, are deleted from the folder at start-up. 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.