Commands¶

Quick Start: Pick your goal.

All commands are available under /manhunt and its alias /mh. Tab completion only suggests what the sender has permission to run. Casual players only need status, qs, and start.

Playing¶

Match Status¶

/manhunt status shows your own match (watching one after elimination counts), else your lobby queue. An id shows one roster grouped by role; all lists every running match, then every populated lobby. Extras under settings.server.status toggle win conditions (show-win-conditions), the L{lobby}|G{game} tag (show-ids), running time (show-elapsed-time), the enabled-mods block (always the last section, the effective per-match list: the same hoverable roll call as the match start, gated by show-modifiers plus the mod-broadcasts switch), and show-on-start. Long rosters truncate, dead players get a skull line (tune the roster under manhunt.status-* and the mods block under modifiers.broadcast-*).

Teams¶

Roles¶

Targets always need the permission for their role. Players already in the match need -f (-force) for any role change; moving someone else out of afk needs the command twice within 10 seconds; -s (-silent) suppresses the role messages and sounds. With a live match, the mid-match policy decides instead (see Concurrent Matches).

Quick Start¶

Assigns teams and starts immediately, bypassing autostart. Who converts and where everyone lands is in Concurrent Matches.

Lobbies¶

Each lobby runs its own queue, autostart countdown, and match (see Concurrent Matches); joining honors the per-role queue caps unless -f is passed. New to lobbies? Start with the Lobby System.

Preferences¶

The prefs verbs target yourself with jmanhunt.command.prefs.self; targeting anyone else needs jmanhunt.command.prefs.

Cosmetics¶

Targeting anyone but yourself needs jmanhunt.command.cosmetics; remove always needs it. Console names its targets.

Language¶

Players only. See Per-player language.

Matches¶

Joining and Leaving a Running Match¶

/manhunt match join lets someone watch; living participants confirm leaving with a second run within 10 seconds. Full behavior is in Concurrent Matches.

Match History¶

/manhunt match history <match-id> replays the stored MATCH SUMMARY for that match, tagged with the match id in the header. It works from console and for players, renders to the sender only, and reads the same stored snapshot as the by id placeholders. Tab completion suggests recent cached match ids. Unknown ids report back as unknown instance ids.

Team Chat¶

Hunters and speedrunners in a match can talk privately by prefixing a line with @team or @t. See Team Chat for prefixes, settings, and lobby scoping.

Settings¶

Editing Settings In-Game¶

/manhunt config browses and changes settings in-game, one category at a time (same settings as the admin GUI); tab completion only suggests children.

/manhunt config settings match autostart enabled true
/manhunt config settings compass actions auto interval 5
/manhunt config world-engine general cell-size 20000

Every value is validated before it is stored. String lists drill by index (... 0, ... 0 <words>, ... add <words>, ... remove 0, ... reset). With no category the command lists categories; setting names match case-insensitively. When settings.server.announce.config-changes is enabled, every change is announced to online admins (jmanhunt.admin) except the one who made it.

Per-Lobby Overrides¶

/manhunt override stores per-lobby setting, modifier, and modifier-value overrides (matches read the override first); also editable in the admin GUI.

/manhunt override 1 settings get settings match autostart enabled
/manhunt override 1 settings set settings match autostart enabled false
/manhunt override 1 modifiers set gapple true
/manhunt override 1 values set flood base-y 69
/manhunt override 1 values get flood
/manhunt override 1 clear

get shows the effective value plus its layer: (override) for the lobby, (global) for GLOBAL, (default) for the file. Values validate against the setting's type before they store. Every clear asks once and deletes on an identical rerun within 10 seconds; emptied lobbies are pruned. See Operator values for the full layer model.

World Engine¶

Lobby and Game Worlds¶

If the lobby world does not exist yet, the first tpto lobbyworld run asks for a confirming second run within 10 seconds, which generates a void world, pastes the DEFAULT preset, and points lobby 0 at the spawn. Pass a preset (EMPTY, DEFAULT, ADVANCED) with a selector to generate with that preset instead (ignored once the world exists). gameworld hops to the game world spawn and never generates anything. Without a selector, both target you (console must pass one).

Mods and Admin¶

Playlists¶

Click the trailing stick to draft a playlist: the id dialog opens, then the pad block dialog, and confirming redirects back to the playlist list. Click a list entry to edit its id, icon, block, mode, and composition; the composition entry opens the twin side editor (speedrunners left, hunters right, minimum 1 each). Renames redirect to the list. Every edit saves advanced/playlists.yml at once. See Quick Match and Playlists.

Party¶

create starts a solo private party; invite <player> asks an online player in (and creates a solo party first when the inviter has none), and join <leader> takes a public party directly or a private one with an invite. leave steps out (the leader's exit promotes the longest-standing member, the last exit disbands), kick <name> removes a member, setmode <public|private> flips who may join, setleader <name> hands over leadership, and list shows the members. Parties share one Quick Match queue: only the leader steps pads or queues (every route), the whole party lands on one side, oversized parties get a pad error, and ranked queues require every member within one rank step of the leader. A non-leader leaving or kicked mid-queue evicts just that member, while the leader leaving drops the whole party attempt so no ghosts stay queued; joining is refused while either side queues. Parties cap at 4 (parties.max-size). Parties are private by default. See Playlists.

Ranked¶

enable and disable flip the ranked master switch at once and persist it to playlists.yml: disabling stops every ranked queue with a notice and cancels running ranked matches immediately, enabling touches the season clock. status reports the switch plus the live season number (or that the ladder is unwired when statistics are off). resetweights <playlist> clears that playlist's auto-weights samples (survives seasons otherwise), with tab completion over the playlist ids; /manhunt playlists weights offers the same reset per playlist from the admin GUI. Once a ranked match begins it is closed: participant joins and leaves are refused, while spectators keep moving both ways. See Playlists.

Modifiers¶

Browse and toggle mods with setmod and setpreset, through the admin GUI, or by editing files under mods/ and running /manhunt reload. Share one with export, take one in with import (see Creating Modifiers):

/manhunt modifiers export modifier gear-dice
/manhunt modifiers import modifier JMH1D:...

Create entries without touching YAML (values run until the next flag, so no quoting needed):

/manhunt modifiers create modifier Beef Party --trigger ON_START --player give <p> cooked_beef 8
/manhunt modifiers create preset Chaos --member beef-party --member gear-dice

All create flags: Creating Modifiers and Presets. Edit a modifier's exposed settings and visibility without touching YAML:

/manhunt modifiers config flood setting base-y 69
/manhunt modifiers config flood reset base-y
/manhunt modifiers config flood define palette.accent COLOR
/manhunt modifiers config flood color ff00aa
/manhunt modifiers config flood broadcast false

setting and reset read and write GLOBAL (never the mod file); per-lobby values go through override ... values. See Config Settings for setting, reset, define, icon, color, and broadcast; the complete modifier reference lives in Modifiers.

Challenges¶

Play built-in challenges through our companion plugin JManhunt-Challenges (/jmhchallenges toggle <challenge>).

Developer Tools¶

/manhunt dev schem saves and loads .jmhlobby bundles (structure plus lobby bounds and teleports) for authoring lobby presets. See Developer Tools; only list works from the console.