Commands
Complete command reference
Player Commands
The /xp command is your main hub - it provides access to skills, skill trees, quests, boosts, Records, and settings all in one place. The shortcut commands below open specific pages directly; you don't need them, but they're available.
| Command | Aliases | Description |
|---|---|---|
/mmoxp | /xp, /skills | Check your experience for your skills. |
/skilltree | /st, /rewards | Open the skill tree to view and claim milestone rewards. |
/xpdisplay | /xpd | Configure your XP display preferences. |
/mmoachievements | /mmoach, /achievements | Open the achievements page. |
/mmoquests | /mmoquestlog, /mmoql | Open the quest log. |
/quest | - | View and manage your quests: an alias over the shared library's /zigprogress quest accept|claim|abandon|status, under this mod's own permission node. It adds two bits of MMO policy on top: a quest authored as handed over only in conversation is refused from chat, and a claim checks for inventory room first so a full bag reads as "make room". Named-arg form: /quest accept --questId=<id>. Subcommands: accept, claim, abandon, status |
/mmoleaderboard | /mmolb, /mmorankings | Open Records, the menu's rankings page, where skill levels rank on the Skills tab beside the server's other stats. Since 1.7.1 the old skill leaderboard lives there; the command and its aliases stay. |
/mmoboosts | /mmoxpboosts | View your active XP boosts. |
/mmoabilities | - | Open the abilities bind page. |
/mmoability | - | Use and bind active abilities: use / bind / unbind / input / list are player-facing, under the command's own node. The admin verbs are reload, grantmod, revokemod, explain (what a cast is actually worth), unlockall and lockall. unlockall takes an optional scope, --arg1=all|actives|passives. Subcommands: bind, unbind, use, list, input, reload, grantmod, revokemod, unlockall, lockall, explain |
/mmohud | - | Show or hide your on-screen HUDs (quest tracker, ability cooldowns, zone difficulty, mob inspector); the zone-difficulty and mob-inspector cards only appear with the optional MMO Mob Scaling mod installed. Subcommands: show, hide |
/mmomastery | /mastery | Ability mastery system; split permission, the open / list read paths are player-facing while respec / bypass mutate paths require admin. Subcommands: open, list, respec, bypass |
/mmocurrency | /currency | Check and adjust wallets; an alias over the shared wallet engine, so it reads and writes the same balances /zigcommerce does. Split permission, balance / list read paths are player-facing while give / take / set mutate paths require admin. Subcommands: balance, list, give, take, set |
/setmmoxp | /setxp | Set XP for a skill or all skills on yourself; the --target=<player> form is OP only. |
/mmoshopui | - | Open the Token Shop UI. |
/mmobountyui | - | Open the Bounty Board UI. |
With command permissions switched on, most of these check their own node, mmoskilltree.command.<name>. The Command Permissions table lists each one.
Admin Commands
All admin commands require OP status (or mmoskilltree.admin permission when permissions are enabled). Several commands run from the server console; boost and config commands take values via --args= (use | or _ to separate multiple values).
| Command | Aliases | Description |
|---|---|---|
/mmoconfig | /skillconfig | Configure MMO skill settings. trim prunes redundant XP entries only (it lost its luck half when luck loot folded into bonus-drops.json); diff answers luck, drops or all. Subcommands: list, diff, trim, disable, basexp, scale, remove, creative, restedxp, permissions, reload, reloaddefaults, reloadlang, validate, blacklist, resetrewards, formula, language, resetpermcache, questhud, achievement |
/mmoadmin | /mmoconfig-ui, /mmosettings | Open the admin configuration UI. |
/bulksetxp | /setxpall, /masssetxp | Set XP for one, many, or all players. Use * or comma-separated names. |
/mmoawardxp | - | Award XP to a player. Usage: /mmoawardxp <player> <skill> <amount>. |
/mmolamp | - | Give a player a Skill Lamp. Usage: /mmolamp give <player> <amount> [--picks=N] [--skills=ALL|<category>|<id,id>]. Each skill the player picks when they rub it gets the amount; --picks is 1 to 10 (default 1), and --skills limits the picker to a category or a list of skill ids (default ALL). The Mmo_Lamp reward kind runs it as the console. |
/mmoboost | /boost | Manage XP boosts: give a boost token, start a global boost now, list the running global boosts, or clear and check a player. give takes an optional sixth value, the effect whose icon the boost shows on the buff bar (pipe form only, since effect ids carry underscores); without one, or with an effect the server lacks, it shows the default icon for a personal or a global boost. Subcommands: give, global, list, clear, status |
/mmoquestadmin | - | Admin quest management. Except reload and list, an alias over the shared library's /zigprogress quest verbs (give, reset, complete, status), with resetdialogues over /zigprogress memory forget, so a script may use either spelling. reload re-reads this mod's own owner files and pack layers (the shared assets are /zigprogress reload's); list is this mod's category-tagged view; complete keeps an OFFLINE half the shared verb has not got (the reward spools until the player next connects). Pipe-separated named-arg form: /mmoquestadmin give --args=<player|*>|<questId>. Subcommands: reload, list, give, reset, resetdialogues, complete, status |
/mmoquestui | - | Open the NPC quest UI for a player. |
/mmoachadmin | - | Achievement admin: /mmoachadmin reset --player=<name> wipes one player's whole achievement record. An alias over the shared library's /zigprogress achievement reset, plus the one thing only this mod can do: releasing the server-first claims that player won. Subcommands: reset |
/mmobounty | - | Bounty-board diagnostics: an alias over the shared economy's audit and catalogue, so it reports on the same boards /zigcommerce does. Subcommands: reset, validate |
/mmoshop | - | Token-shop diagnostics: an alias over the shared economy's audit and catalogue, so it reports on the same storefronts /zigcommerce does. Subcommands: list, reset, validate |
/mmonpc | - | Manage NPC placements (the Adventurer's Guide, quest givers, anything a pack places): list what is placed, switch one on or off, re-place them after a content change, and see which structures and press-F destinations are available. The list noun rides the --arg1= option (a bare noun after list is not parsed): structures reads the sighting buffer (what the anchor engine recorded), markers scans the live entity store (what actually exists right now, only while its chunk is loaded), so the two disagreeing localizes a sighting problem. Subcommands: list, list --arg1=structures, list --arg1=markers, list --arg1=channels, enable, disable, reconcile |
/mmomigrate | - | Upgrade helper: scan (the default) writes mods/mmoskilltree/migration/report-<timestamp>.md classifying every owner file and installed pack, narrowed with --scope=all|owner|packs; --action=owner --confirm=yes applies the safe owner conversions in place, backing each file up first and reading each written file back unless --verify=false; --action=pack --name=<pack> reports what one pack needs and points at the web converter, since a pack is never rewritten in game; --action=report reprints where the newest report was written and what it counted. |
/mmopacks | /mmopack | Manage MMOSkillTree third-party content packs. |
/mmotheme | /menutheme | Set the server-wide menu theme. |
/mmoquestui <playername> <character> opens the NPC quest screen for a player, showing the quests tied to that character. Conversations and quest hand-ins are authored content, so this console command is the manual fallback for scripting or a custom NPC setup.
Bulk Set XP Examples
# Set all online players to 1000 mining XP
/bulksetxp mining 1000
# Reset all skills to 0 for a specific player
/bulksetxp all 0 --targets=PlayerName
# Set swords to 5000 for multiple players
/bulksetxp swords 5000 --targets=Player1,Player2,Player3
# Set all players to level 50 in woodcutting (~435k XP)
/bulksetxp woodcutting 435156Quest and Achievement Admin Examples
/mmoquestadmin, /quest and /mmoachadmin keep their names, arguments and permission gates, and each verb speaks to the one quest and achievement runtime the shared library owns. The same verbs are reachable as /zigprogress quest ..., /zigprogress achievement ... and /zigprogress memory forget (see below), so a script may use either spelling. Two things to know: giving a quest to somebody already past its finish line pays or parks it at once, and reset wipes a record for a quest id the catalogue no longer knows instead of refusing it.
# Give a quest (use * for everybody in your world)
/mmoquestadmin give --args=Steve|getting_started
# Reset one quest, or every quest, for a player (wipes the completion record too)
/mmoquestadmin reset --args=Steve|getting_started
/mmoquestadmin reset --args=Steve|all
# Forget everything every conversation remembers about a player (first-visit beats play again)
/mmoquestadmin resetdialogues --args=Steve
# Force-complete and pay a quest; an offline player receives it on next connect
/mmoquestadmin complete --args=Steve|getting_started
# Where every quest stands for a player
/mmoquestadmin status --args=Steve
# Re-read this mod's own quest files and pack layers (the shared assets are /zigprogress reload's)
/mmoquestadmin reload
# Wipe a player's whole achievement record and release the server-firsts they won
/mmoachadmin reset --player=SteveShared Library Commands
The required ZiggfreedCommon jar registers its own commands, because it owns the engines behind wallets, storefronts and boards, behind quests, achievements and what conversations remember, and behind titles, Records, the on-screen displays, dungeons, Claims and parties. The MMO's /mmoshop, /mmobounty and /mmocurrency are thin aliases over /zigcommerce, and /mmoquestadmin, /quest and /mmoachadmin are aliases over /zigprogress, so either spelling does the same thing to the same data.
| Command | Aliases | Description |
|---|---|---|
/zigcommerce | - | ziggfreed-common's economy admin family: audit the loaded catalogue, inspect wallets, storefronts and boards, look up one player, and hand out, take or set a balance. Permission nodes are ziggfreed.ziggfreedcommon.command.zigcommerce and ziggfreed.ziggfreedcommon.command.zigcommerce.<verb>; the console holds all of them. The MMO's /mmoshop, /mmobounty and /mmocurrency are aliases over it. Subcommands: validate, wallets, shops, boards, show, give, take, set, resetlimits, resetrerolls |
/zigprogress | - | ziggfreed-common's progression admin family over the one shared quest and achievement runtime, in three nested groups plus reload: quest (list, give, reset, complete, status, accept, claim, abandon), achievement (list, status, give, claim, reset) and memory (forget: everything every conversation remembers about a player). give is the force-it verb that awards an achievement outright, claim is the peer of quest claim and collects what is earned and still waiting (achievement claim --achievement=all collects everything at once, the way --quest=all does), and reset starts a player over on one achievement or on all of them. Named-arg form (--quest=<id>, --achievement=<id>, --player=<name>, --tag=<tag>, --everyone); a per-player verb needs the player online. Permission nodes are engine-derived: ziggfreed.ziggfreedcommon.command.zigprogress for the family, .zigprogress.<group> per group and .zigprogress.<group>.<verb> per verb (a verb needs all of its ancestors); the console holds everything. The MMO's /mmoquestadmin, /quest and /mmoachadmin are aliases over it. Subcommands: reload, quest list, quest give, quest reset, quest complete, quest status, quest accept, quest claim, quest abandon, achievement list, achievement status, achievement give, achievement claim, achievement reset, memory forget |
/zigtitle | - | ziggfreed-common's titles family. grant gives a player a title, revoke takes one away, and list shows the titles a player has earned, the one they show marked. All three take --player=<name or player id> for a player who is online or not (an offline player by name needs an authenticated server; their player id always works): a grant or a revoke for an offline player waits and happens the next time they log in, with the same notice as any new title, and list reads their titles as of their last visit plus how many changes are waiting. Leave --player out to act on yourself. open opens the title picker and is every player's. Permission nodes are ziggfreed.ziggfreedcommon.command.zigtitle for the family and .zigtitle.<verb> for grant, revoke and list, a verb needing both; open needs neither, and the console holds everything. Subcommands: grant, revoke, list, open |
/zigleaderboard | - | Records from the command line. encounter opens Records' Boss Fights for you, at the fight --encounter=<id> names (its encounter script id) or at the first fight on record, and every player holds it. clock <offset> moves the stat board's clock (7d, 12h, 30m, -1d, or 0 to put it back) so you can watch a week or a month turn over without waiting; it is kept in memory only, so a restart puts it back, and while it is moved new numbers land in All Time alone and no old week or month is dropped. clock is a staff verb: it belongs to the game's World Editor group and the groups above it, and runs from the console. Subcommands: encounter, clock |
/zigstats | - | The stat store's admin family. show lists every tally a player holds by its key, the same key a ziggfreedcommon:counter condition names (Mob_Kills, Blocks_Broken, Mob_Kills/<role id> for one line), then each seasonal event's copy as <event>@<year>/<key>. Leave --player out for your own; the player must be online. It says so when stats are switched off in mods/ziggfreedcommon/stats.json. Permission nodes are ziggfreed.ziggfreedcommon.command.zigstats and .zigstats.show; the console holds everything. Subcommands: show |
/zighud | - | Your on-screen displays. On its own, or with open, it opens the menu's Settings tab. hide and show take --panel=<id|all>; hide with no panel named hides every display, the quest tracker included (from 2.3.0), and while everything is hidden each Show switch on the Settings tab reads off until you turn one back on. place --panel=<id> --placement=<id> moves a display on your screen. Every player holds these. default --panel=<id> --placement=<id> sets a display's spot for everyone and needs ziggfreed.ziggfreedcommon.command.zighud.default or the game's World Editor group. Subcommands: open, hide, show, place, default |
/zigdungeon | - | The dungeons' admin family. list shows every dungeon and how it is set up: whether it is open, its difficulty and season, its world template and prefab, how its copies are shared, its time limit and how soon an empty copy closes. status lists every copy open now, with its areas in use, the players inside and on the way in, its recent tick time, and whether it is taking new parties. close <copy> closes a copy now by its world name (such as crypt-1), and everyone inside goes back where they came in; it refuses any world the library did not open as a dungeon copy. enter <dungeon> takes you into a dungeon by its id, as a party of one in an empty area, through the same checks every way in makes, and says exactly why when it refuses; it needs you in the game, not the console. Permission nodes are ziggfreed.ziggfreedcommon.command.zigdungeon for the family and .zigdungeon.<verb> per verb, a verb needing both; nobody holds them until you grant them, and the console holds everything. Guide Subcommands: list, status, close, enter |
/zigclaims | - | Puts rewards in a player's Claims. give --lootable=<id> rolls that loot table and puts what it lands in the Claims of the player --player=<name or player id> names, online or not (an offline player by name needs an authenticated server; their player id always works): a player who is offline finds it, and the notice, at their next login. Leave --player out for yourself. Each give is a Claim of its own, the table rolls as a won round with no score, and a roll that lands nothing writes no Claim. chest [--player=<name>] [--chest=<id>] [--lootable=<id>] stands a reward chest two blocks east of a player who is online, credited to them alone as a rare kill would, so a chest can be tried on any server: --chest names the reward chest file (Zc_Reward_Chest unless given), and --lootable the table rolled into it in place of the file's own Contents.Lootable, needed when the file names none; a roll that lands nothing raises no chest. Permission nodes are ziggfreed.ziggfreedcommon.command.zigclaims for the family and .zigclaims.give and .zigclaims.chest for the verbs, a verb needing both; nobody holds them until you grant them, and the console holds everything. Guide Subcommands: give, chest |
/zigparty | - | Your party, the one a dungeon takes you in with. On its own it opens your party: its members, your invites, and who to invite. invite --player=<name> invites a player who is online, making you a party of your own first if you have none; accept joins the party that invited you (with more than one invite waiting, /zigparty on its own is where you pick); leave takes you out, and when the leader leaves, the next member leads. Every player holds all of it, since the family and its verbs sit in the game's Adventurer group (hytale:Adventurer). As shipped, a party holds 5 players and an invite lasts 60 seconds (Server/ZiggfreedCommon/Party/ZiggfreedCommon.json). Subcommands: invite, accept, leave |
These carry their own permission nodes rather than mmoskilltree.admin: ziggfreed.ziggfreedcommon.command.zigcommerce for the family and ziggfreed.ziggfreedcommon.command.zigcommerce.<verb> per verb, with a verb needing both; ziggfreed.ziggfreedcommon.command.zigprogress for that family, .zigprogress.<group> per group and .zigprogress.<group>.<verb> per verb, with a verb needing all of its ancestors; and the same pattern for /zigtitle, /zigstats, /zigdungeon and /zigclaims (ziggfreed.ziggfreedcommon.command.zigtitle.grant, say). Nobody holds any of them until you grant it, and the console holds everything. A few are every player's from the start: /zigtitle open, /zigleaderboard encounter, /zighud (all but default) and all of /zigparty. Full guide: ZiggfreedCommon commands; for dungeons and Claims, Authoring Dungeons and Claims.
# Audit every wallet, storefront, pool, board and contract
/zigcommerce validate
# What one storefront or board is offering right now
/zigcommerce shops --shop=General
/zigcommerce boards --board=Daily
# What a player holds, has bought this period, and has rerolled
/zigcommerce show --player=Steve
# Adjust a balance (the player must be online)
/zigcommerce give --player=Steve --currency=Bounty_Token --amount=250
# Give purchase limits or a reroll allowance back
/zigcommerce resetlimits --player=Steve
/zigcommerce resetrerolls --player=Steve# The merged quest catalogue, and where one player stands (the player must be online)
/zigprogress quest list
/zigprogress quest list --tag=Tutorial
/zigprogress quest status --player=Steve
/zigprogress quest status --player=Steve --quest=getting_started
# Start, close out, or wipe a quest for a player (--everyone gives it to everybody online, in every world)
/zigprogress quest give --quest=getting_started --player=Steve
/zigprogress quest give --quest=getting_started --everyone
/zigprogress quest complete --quest=getting_started --player=Steve
/zigprogress quest reset --quest=getting_started --player=Steve
/zigprogress quest reset --quest=all --player=Steve
# The player-side moves, from the console or on behalf of somebody
/zigprogress quest accept --quest=getting_started --player=Steve
/zigprogress quest claim --quest=getting_started --player=Steve
/zigprogress quest abandon --quest=getting_started --player=Steve
# Achievements: the catalogue, one player's record, and the admin moves on it
# (give grants past the gates, claim collects what is waiting, reset wipes one or all)
/zigprogress achievement list
/zigprogress achievement status --player=Steve
/zigprogress achievement give --achievement=battle_tested --player=Steve
/zigprogress achievement claim --achievement=all --player=Steve
/zigprogress achievement reset --achievement=battle_tested --player=Steve
/zigprogress achievement reset --achievement=all --player=Steve
# Forget everything every conversation remembers about a player
/zigprogress memory forget --player=Steve
# Fold the shared quest and achievement assets again and publish them
/zigprogress reloadTitle Examples
/zigtitle hands titles out and takes them back by hand. From CommonLib 2.3.0, --player takes a player who is offline too, by name or by player id: the change waits and happens the next time they log in, with the same notice as any new title. A title you revoke while the achievement that gave it still stands comes back at their next login, so to take it for good, reset that achievement as well.
# Give a title, or take it away (an offline player gets the change at their next login)
/zigtitle grant --player=Steve --title=<title id>
/zigtitle revoke --player=Steve --title=<title id>
# The titles a player has earned, the shown one marked, and any changes still waiting
/zigtitle list --player=Steve
# Open your own title picker (every player can)
/zigtitle openRecords and Stats Examples
Records, the rankings page in the menu, belongs to the shared library, and /mmoleaderboard opens it too. /zigleaderboard encounter opens its Boss Fights, /zigstats show lists what a player has counted, and /zigleaderboard clock lets you try a week's or a month's turnover before your players see one.
# Open Records' Boss Fights, at one fight or at the first fight on record
/zigleaderboard encounter
/zigleaderboard encounter --encounter=<encounter script id>
# Every tally a player holds, by the key a ziggfreedcommon:counter condition names
# (the player must be online)
/zigstats show --player=Steve
# Move the board's clock a week on to see This Week turn over, then put it back
/zigleaderboard clock 7d
/zigleaderboard clock 0HUD Examples
/zighud on its own opens your Settings tab. From CommonLib 2.3.0, hide with no panel named hides the quest tracker along with the bars, and show brings back the displays you had up.
# Hide every display, the quest tracker included, then bring them back
/zighud hide
/zighud show
# Hide just one display
/zighud hide --panel=<panel id>Placed NPC Examples
/mmonpc manages every placed NPC live - the Adventurer's Guide, quest givers, and anything a content pack places. Disabling one despawns the NPC already standing there.
# Every placement, and whether it is switched on
/mmonpc list
# Switch one off, or all of them
/mmonpc disable --arg1=Mmo_Hub
/mmonpc disable --arg1=*
# Back on
/mmonpc enable --arg1=Mmo_Hub
# Force a sweep now, everywhere or in one world
/mmonpc reconcile
/mmonpc reconcile --arg1=default
# The list noun rides --arg1= (a bare noun after list is not parsed):
# recorded structure-marker sightings, the marker entities live right now
# (the two disagreeing localizes an anchoring problem; a marker only exists
# while its chunk is loaded), and the registered press-F destinations
/mmonpc list --arg1=structures
/mmonpc list --arg1=markers
/mmonpc list --arg1=channelsUpgrade Check Examples
/mmomigrate reports what on your server still speaks a retired format, and converts the owner files that can be converted safely. It backs up first, writes atomically, reads the result back, and rolls back if anything fails to decode. Content packs are never rewritten in game; run those through the web Migration Converter instead.
# Look at everything, change nothing. Writes a report and names its path.
/mmomigrate
# What could be converted, without converting it
/mmomigrate --action=owner
# Actually convert
/mmomigrate --action=owner --confirm=yes
# What your installed content packs still carry
/mmomigrate --action=pack
# The newest report's path and its counts again
/mmomigrate --action=reportBoost Commands
Boost commands can be run from in-game or server console. Use --args= with | or _ to separate values.
Boost Target Options
all- All skills- Skill name (e.g.,
mining) - Category name (e.g.,
gathering,combat)
Examples
# Give Steve a 2x all-skills token for 30 min
/mmoboost give --args=Steve|all|2.0|30
# Same command using underscore delimiter
/mmoboost give --args=Steve_all_2.0_30
# Give all online players a 1.5x mining token
/mmoboost give --args=*|mining|1.5|60
# Give a GLOBAL boost token (affects everyone when activated)
/mmoboost give --args=Steve|all|2.0|60|global
# Give 5 tokens at once
/mmoboost give --args=Steve|mining|1.5|30 --quantity=5
# Give a token whose boost shows an effect's icon on the buff bar (pipe form only)
/mmoboost give --args=Steve|mining|1.5|30|personal|<effect id>
# The global boosts running now
/mmoboost list
# Activate 2x XP for everyone for 15 min immediately
/mmoboost global --args=all|2.0|15Config Commands
Config commands use --args= for values. Use | to separate multiple values. See the /mmoconfig subcommands in the admin table above; common usage:
Config Command Examples
# Set diamond to 150 XP
/mmoconfig mining --args=Rock_Gem_Diamond|150
# All ores give 25 XP (wildcard)
/mmoconfig mining --args=Ore_|25
# Harder early game
/mmoconfig basexp --args=400
# Easier endgame
/mmoconfig scale --args=150
# Enable XP in creative mode
/mmoconfig creative --args=false
# Block "Dummy" entities from giving combat XP
/mmoconfig blacklist --args=add|Dummy
# Validate this mod's own content (quests, abilities, masteries, placements, ...)
/mmoconfig validate
# Validate the shared economy (wallets, storefronts, boards)
/zigcommerce validate