Commands¶
For: intermediate admins. Casual players only need
status,qs, andstart.
All commands are available under /manhunt and its alias /mh. Tab
completion only suggests what the sender has permission to run.
Playing¶
| Command | What it does | Permission |
|---|---|---|
/manhunt |
First run: one-click setup. Later: opens the admin GUI (needs jmanhunt.gui) or shows your teams. |
jmanhunt.gui, jmanhunt.command.status |
/manhunt status [id\|all] |
Shows one match roster by id, or every running match plus populated lobbies with all. |
jmanhunt.command.status, jmanhunt.command.status.other for the argument |
/manhunt help |
Shows the in-game command list. | jmanhunt.command.help |
/manhunt setup |
Step-by-step setup tour in chat (players only). For learning as you go. | jmanhunt.command.setup |
/manhunt support |
Shows Discord, GitHub, and Ko-fi links. | jmanhunt.command.support |
/manhunt challenges |
Shows a chat notice with a clickable link to the optional Challenges addon. | jmanhunt.command.challenges |
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, the L{lobby}|G{game} tag,
running time, enabled modifiers, and show-on-start. Long rosters truncate,
dead players get a skull line (tune it all under manhunt.status-*).
Teams¶
| Command | What it does | Permission |
|---|---|---|
/manhunt setplayer <selector> <role> |
Assigns hunter, speedrunner, spectator, afk, or none. |
jmanhunt.command.setplayer (jmanhunt.command.setplayer.self for your own role only) |
/manhunt quickstart [percentage] |
Assigns teams and starts immediately, bypassing autostart. | jmanhunt.command.quickstart |
/manhunt qs [percentage] |
Alias for /manhunt quickstart. |
jmanhunt.command.quickstart |
Roles¶
| Role | Description |
|---|---|
hunter |
Participates as a hunter. Requires jmanhunt.hunter. |
speedrunner |
Participates as a speedrunner. Requires jmanhunt.speedrunner. |
spectator |
Watches without playing. Requires jmanhunt.spectator. |
afk |
Excluded from the match entirely; waits in the lobby. Requires jmanhunt.afk. |
none |
Not participating: the pool Quick Start draws from. Requires jmanhunt.none. |
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¶
| Command | What it does | Permission |
|---|---|---|
/manhunt lobby join <selector> <lobby-id> [role] [-notp] |
Moves players to a lobby queue, teleporting them there unless -notp is given. |
jmanhunt.command.lobby |
/manhunt lobby leave [selector] |
Removes players from whatever lobby they are in. | jmanhunt.command.lobby |
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.
Matches¶
| Command | What it does | Permission |
|---|---|---|
/manhunt start [lobby-id] |
Starts a match for a lobby queue. | jmanhunt.command.start |
/manhunt end [id] |
Cancels a match with no winner and no saved stats. | jmanhunt.command.end |
/manhunt end [id] -i / -immediate |
Cancels immediately, skipping the end delay intermission. | jmanhunt.command.end |
/manhunt end all [-i] |
Cancels every running match at once. Works from console. | jmanhunt.command.end |
/manhunt game join <id> [role] [selector] |
Adds players to a running match (default spectator). |
jmanhunt.command.game |
/manhunt game leave [id] [selector] |
Removes players from a running match; leaving participants need a second run within 10 seconds. | jmanhunt.command.game |
Joining and Leaving a Running Match¶
/manhunt game join lets someone watch; living participants confirm
leaving with a second run within 10 seconds. Full behavior is in
Concurrent Matches.
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¶
| Command | What it does | Permission |
|---|---|---|
/manhunt config <category> <key...> [value] |
Lists, views, or changes settings by category. | jmanhunt.command.config |
/manhunt override <lobby> settings <get\|set\|clear> <key...> [value] |
Views, changes, or removes one lobby's setting overrides. | jmanhunt.command.override |
/manhunt override <lobby> modifiers <get\|set\|clear> [id] [true\|false] |
Views, changes, or removes one lobby's modifier overrides. | jmanhunt.command.override |
/manhunt override <lobby> clear |
Removes every override of one lobby. | jmanhunt.command.override |
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 and modifier 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 clear
get shows the effective value plus (override) or (global); every clear asks
once and deletes on an identical rerun within 10 seconds; emptied lobbies are pruned.
World Engine¶
| Command | What it does | Permission |
|---|---|---|
/manhunt worldengine lobbyconfig pos1\|pos2 |
Records a lobby-bounds corner at your feet block. | jmanhunt.command.worldengine (jmanhunt.command.worldengine.lobbyconfig) |
/manhunt worldengine lobbyconfig setbounds <lobby-id> |
Stores the recorded corners as a lobby's bounds. | jmanhunt.command.worldengine (jmanhunt.command.worldengine.lobbyconfig) |
/manhunt worldengine lobbyconfig setlobbytp <lobby-id> [coords] |
Sets a lobby's teleport (your position, or x y z yaw pitch). |
jmanhunt.command.worldengine (jmanhunt.command.worldengine.lobbyconfig) |
/manhunt worldengine lobbyconfig deletelobby <lobby-id> |
Deletes a lobby's stored entry. | jmanhunt.command.worldengine (jmanhunt.command.worldengine.lobbyconfig) |
/manhunt worldengine tpto lobbyworld\|gameworld [selector] [preset] |
Teleports to the lobby world (generating it on a confirmed second run) or the game world spawn. | jmanhunt.command.worldengine (jmanhunt.command.worldengine.tpto) |
/manhunt worldengine cellindex get |
Shows the current world-engine cell index. | jmanhunt.command.worldengine (jmanhunt.command.worldengine.cellindex) |
/manhunt worldengine cellindex set <value> |
Sets the world-engine cell index, clamped to the addressable grid. | jmanhunt.command.worldengine (jmanhunt.command.worldengine.cellindex) |
/manhunt worldengine cellindex buffer |
Lists the buffered ready-cell ids. | jmanhunt.command.worldengine (jmanhunt.command.worldengine.cellindex) |
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¶
| Command | What it does | Permission |
|---|---|---|
/manhunt modifiers setmod <id> <true\|false> |
Switches one modifier on or off. | jmanhunt.modifiers |
/manhunt modifiers setpreset <id> <true\|false> |
Switches one preset on or off. | jmanhunt.modifiers |
/manhunt modifiers export modifier <id> |
Prints a click-to-copy share string. | jmanhunt.modifiers |
/manhunt modifiers import modifier <string> |
Takes a shared string in. | jmanhunt.modifiers |
/manhunt modifiers create ... |
Creates entries from chat or console (see below). | jmanhunt.modifiers |
/manhunt modifiers test <role> <commands> |
Dry-runs commands through the tag pipeline (players only). | jmanhunt.modifiers |
/manhunt modifiers config <id> <setting\|reset\|define\|icon\|color\|broadcast> ... |
Reads or edits one modifier's config settings and visibility (see below). | jmanhunt.modifiers |
/manhunt reload |
Reloads the engine and mods, then reports new/removed ids plus file problems. | jmanhunt.command.reload |
/manhunt debug [INFO\|WARN\|SEVERE] |
Sets lifecycle debug output level; bare command toggles. Bounds draw as particles while on. | jmanhunt.command.debug |
/manhunt dev schem <pos1\|pos2\|save\|load\|list> |
Saves and loads .jmhlobby bundles for authoring presets. Only list works from console. |
jmanhunt.command.dev.schem |
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):
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
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.