Skip to content
Matcha! Mods

Commands & Permissions

Commands & Permissions

Section titled “Commands & Permissions”

Every Journey command, its syntax, and required permissions. All commands support tab completion.

Quick Reference

Section titled “Quick Reference”

Player commands (anyone can use):

/journal                          Open quest journal
/party                            Party management
/track <task>                     Track a task on HUD
/track untrack                    Stop tracking
/journey bountyboard <id>        Open a bounty board
/journey bountyboard list        List bounty boards
/journey createcontract          Create custom bounty

Admin commands (operator/permission required):

/journey reload                   Reload all configs
/journey starttask <player> <task>   Start task for player
/journey buff apply <player> <buff>  Apply buff
/flag <player> add <flag>         Add player flag
/zonemanager                      Visual zone editor
/pathmanager                      NPC path editor
/journey visibility seeall        Toggle see-all mode
/mspawnnpc <id> <pos> [for <owner>]  Managed NPC spawn
/msummon <type> <pos> [for <owner>]  Managed entity spawn
/journey dump-molang              Export MoLang schema

Task Management

Section titled “Task Management”

/journey starttask <player> <task>

Section titled “/journey starttask <player> <task>”

Start a task for a player.

  • Permission: journey.command.admin (level 3)
  • Example: /journey starttask @p journey:tutorial_quest

/journey completetask <player> <task>

Section titled “/journey completetask <player> <task>”

Force-complete a task.

  • Permission: journey.command.admin (level 3)

/journey removetask <player> <task>

Section titled “/journey removetask <player> <task>”

Remove a task from a player (active or completed).

  • Permission: journey.command.admin (level 3)

/journey removecompleted <player>

Section titled “/journey removecompleted <player>”

Clear all completed tasks from a player’s history.

  • Permission: journey.command.admin (level 3)

/journey completesubtask <player> <task> <subtask>

Section titled “/journey completesubtask <player> <task> <subtask>”

Force-complete a specific subtask.

  • Permission: journey.command.admin (level 3)

/journey progresssubtask <player> <task> <subtask> <amount>

Section titled “/journey progresssubtask <player> <task> <subtask> <amount>”

Add progress to a subtask.

  • Permission: journey.command.admin (level 3)
  • Example: /journey progresssubtask @p journey:gather_items gather_wood 5

/track <task> or /journey track <task>

Section titled “/track <task> or /journey track <task>”

Track a task on the player’s HUD.

  • Permission: journey.command.track (level 3)

/track untrack

Section titled “/track untrack”

Stop tracking the current task.

  • Permission: journey.command.track (level 3)

Journal

Section titled “Journal”

/journal or /journey journal

Section titled “/journal or /journey journal”

Open the quest journal UI.

  • Permission: journey.command.journal (level 3)

Bounty Boards

Section titled “Bounty Boards”

/journey bountyboard <board_id>

Section titled “/journey bountyboard <board_id>”

Open a specific bounty board.

  • Permission: journey.command.bountyboard (level 0)

/journey bountyboard list

Section titled “/journey bountyboard list”

List all available bounty boards.

  • Permission: journey.command.bountyboard.list (level 0)

/journey bountyboard rotate <board_id>

Section titled “/journey bountyboard rotate <board_id>”

Manually trigger a bounty board rotation.

  • Permission: journey.command.admin (level 3)

/journey createcontract

Section titled “/journey createcontract”

Open the contract builder UI for creating custom bounties.

  • Permission: journey.command.createcontract (level 0)

Global Tasks

Section titled “Global Tasks”

/globaltask start <task_id>

Section titled “/globaltask start <task_id>”

Start a server-wide global task.

  • Permission: journey.globaltask (level 2)

/globaltask stop <task_id>

Section titled “/globaltask stop <task_id>”

Stop an active global task.

  • Permission: journey.globaltask (level 2)

/globaltask list

Section titled “/globaltask list”

List all registered global tasks.

  • Permission: journey.globaltask (level 2)

/globaltask active

Section titled “/globaltask active”

List currently running global tasks.

  • Permission: journey.globaltask (level 2)

Levelables

Section titled “Levelables”

/levelable give <player> <levelable>

Section titled “/levelable give <player> <levelable>”

Unlock a levelable for a player.

  • Permission: journey.command.admin (level 3)

/levelable remove <player> <levelable>

Section titled “/levelable remove <player> <levelable>”

Remove a levelable from a player.

  • Permission: journey.command.admin (level 3)

/levelable progress <player> <levelable> <amount>

Section titled “/levelable progress <player> <levelable> <amount>”

Award XP to a player’s levelable.

  • Permission: journey.command.admin (level 3)

/levelable open <player>

Section titled “/levelable open <player>”

Open the levelable GUI for a player.

  • Permission: journey.command.admin (level 3)

/levelable switch <player> <levelable>

Section titled “/levelable switch <player> <levelable>”

Switch a player’s active levelable.

  • Permission: journey.command.levelable.switch (level 2)

/levelable respec <player> [levelable]

Section titled “/levelable respec <player> [levelable]”

Reset levelable progress and refund skill points.

  • Permission: journey.command.levelable.respec (level 2)

Buffs

Section titled “Buffs”

/journey buff apply <player> <buff_id> [duration] [amplifier]

Section titled “/journey buff apply <player> <buff_id> [duration] [amplifier]”

Apply a buff to a player.

  • Permission: journey.command.buff (level 3)
  • Duration is in ticks (-1 for permanent)
  • Example: /journey buff apply @p speed_boost 1200 0

/journey buff remove <player> <buff_id>

Section titled “/journey buff remove <player> <buff_id>”

Remove a specific buff.

  • Permission: journey.command.buff (level 3)

/journey buff clear <player>

Section titled “/journey buff clear <player>”

Remove all buffs from a player.

  • Permission: journey.command.buff (level 3)

/journey buff list <player>

Section titled “/journey buff list <player>”

List all active buffs on a player.

  • Permission: journey.command.buff (level 3)

/journey buff reload

Section titled “/journey buff reload”

Reload buff configs from disk.

  • Permission: journey.command.buff (level 3)

Flags

Section titled “Flags”

/flag <player> add <flag>

Section titled “/flag <player> add <flag>”

Add a flag to a player.

  • Permission: journey.command.flag (level 3)
  • Example: /flag @p add tutorial_complete

/flag <player> remove <flag>

Section titled “/flag <player> remove <flag>”

Remove a flag from a player.

  • Permission: journey.command.flag (level 3)

Backpacks

Section titled “Backpacks”

/journey backpack open <player>

Section titled “/journey backpack open <player>”

Open a player’s quest backpack.

  • Permission: journey.command.backpack (level 2)

/journey backpack list <player>

Section titled “/journey backpack list <player>”

List all items in a player’s backpack.

  • Permission: journey.command.backpack (level 2)

/journey backpack give <player> <item> [amount]

Section titled “/journey backpack give <player> <item> [amount]”

Add an item to a player’s backpack.

  • Permission: journey.command.backpack (level 2)

/journey backpack remove <player> <slot>

Section titled “/journey backpack remove <player> <slot>”

Remove an item from a backpack slot.

  • Permission: journey.command.backpack (level 2)

/journey backpack clear <player>

Section titled “/journey backpack clear <player>”

Clear all backpack items.

  • Permission: journey.command.backpack (level 2)

/journey backpack get <player> <slot>

Section titled “/journey backpack get <player> <slot>”

Get info about an item in a slot.

  • Permission: journey.command.backpack (level 2)

/journey backpack setslots <player> <slots>

Section titled “/journey backpack setslots <player> <slots>”

Set maximum backpack slot count (1-54).

  • Permission: journey.command.backpack (level 2)

/journey backpack return <player>

Section titled “/journey backpack return <player>”

Return backpack item to player’s inventory.

  • Permission: journey.command.backpack (level 2)

/journey backpack giveConfigured <player> <backpack_id>

Section titled “/journey backpack giveConfigured <player> <backpack_id>”

Give a pre-configured backpack.

  • Permission: journey.command.backpack (level 2)

/journey backpack listConfigured

Section titled “/journey backpack listConfigured”

List all configured backpack templates.

  • Permission: journey.command.backpack (level 2)

Task Items

Section titled “Task Items”

/journey taskitem give <player> <task_id> [item] [behavior]

Section titled “/journey taskitem give <player> <task_id> [item] [behavior]”

Create a task-bound item.

  • Permission: journey.command.taskitem (level 2)
  • behavior: REMOVE_ITEM or KEEP_ITEM
  • Example: /journey taskitem give @p journey:quest_task minecraft:paper

/journey taskitem list

Section titled “/journey taskitem list”

List all available task items.

  • Permission: journey.command.taskitem (level 2)

/givetaskitem <player> <item> <task> [behavior]

Section titled “/givetaskitem <player> <item> <task> [behavior]”

Simplified task item command.

  • Permission: journey.command.givetaskitem (level 2)

Interactables

Section titled “Interactables”

/journey interactable summon <id> <pos>

Section titled “/journey interactable summon <id> <pos>”

Summon an interactable entity at a position.

  • Permission: journey.command.interactable (level 3)

Entity Visibility

Section titled “Entity Visibility”

/journey npcvisibility <player> show <npc>

Section titled “/journey npcvisibility <player> show <npc>”

Make an NPC visible to a player.

  • Permission: journey.command.npcvisibility (level 2)

/journey npcvisibility <player> hide <npc>

Section titled “/journey npcvisibility <player> hide <npc>”

Hide an NPC from a player.

  • Permission: journey.command.npcvisibility (level 2)

/journey npcvisibility <player> check <npc>

Section titled “/journey npcvisibility <player> check <npc>”

Check if a player can see an NPC.

  • Permission: journey.command.npcvisibility (level 2)

/journey npcvisibility <player> setcondition <npc> <condition>

Section titled “/journey npcvisibility <player> setcondition <npc> <condition>”

Set a Molang visibility condition for an NPC.

  • Permission: journey.command.npcvisibility (level 2)

/journey npcvisibility register <npc> [condition]

Section titled “/journey npcvisibility register <npc> [condition]”

Register an NPC with the visibility system.

  • Permission: journey.command.npcvisibility (level 2)

/journey npcvisibility update <npc>

Section titled “/journey npcvisibility update <npc>”

Refresh NPC visibility for all players.

  • Permission: journey.command.npcvisibility (level 2)

/journey npcvisibility list

Section titled “/journey npcvisibility list”

List all NPC visibility configurations.

  • Permission: journey.command.npcvisibility (level 2)

/journey visibility test <player> <entity>

Section titled “/journey visibility test <player> <entity>”

Check if a player can see an entity.

  • Permission: journey.command.visibility (level 2)

/journey visibility seeall

Section titled “/journey visibility seeall”

Toggle admin see-all mode (view all managed entities regardless of visibility rules).

  • Permission: journey.command.visibility (level 2)

/journey visibility status <entity>

Section titled “/journey visibility status <entity>”

Show an entity’s visibility configuration.

  • Permission: journey.command.visibility (level 2)

/journey visibility info <entity>

Section titled “/journey visibility info <entity>”

Show detailed visibility information including owner, group, and condition.

  • Permission: journey.command.visibility (level 2)

/journey visibility cleanup

Section titled “/journey visibility cleanup”

Remove visibility data for entities that no longer exist.

  • Permission: journey.command.visibility (level 2)

/mspawnnpc <npc_id> <pos> [for <owner>] [visibility <type>]

Section titled “/mspawnnpc <npc_id> <pos> [for <owner>] [visibility <type>]”

Spawn a managed NPC with visibility controls.

  • Permission: journey.command.mspawnnpc (level 2)
  • visibility: OWNER_ONLY, GLOBAL_WHEN_OWNER_ONLINE, CONDITIONAL, AREA_RESTRICTED, ALWAYS_VISIBLE
  • Example: /mspawnnpc professor_oak ~ ~ ~ for Notch visibility OWNER_ONLY

/msummon <entity_type> <pos> [for <owner>] [visibility <type>]

Section titled “/msummon <entity_type> <pos> [for <owner>] [visibility <type>]”

Summon a managed entity with visibility controls.

  • Permission: journey.command.msummon (level 2)
  • Example: /msummon cobblemon:npc ~ ~ ~ visibility CONDITIONAL condition "q.player.has_flag('badge_1')"

/journey summon <entity> <pos> [owner] [visibility_type] [zone_uuids...]

Section titled “/journey summon <entity> <pos> [owner] [visibility_type] [zone_uuids...]”

Summon an entity with visibility controls (legacy syntax).

  • Permission: journey.command.summon (level 2)

/journey summon clear <player>

Section titled “/journey summon clear <player>”

Remove all entities summoned by a player.

  • Permission: journey.command.summon (level 2)

Zones

Section titled “Zones”

/zone create <name>

Section titled “/zone create <name>”

Create a new zone.

  • Permission: journey.command.zone (level 2)

/zone delete <name>

Section titled “/zone delete <name>”

Delete a zone.

  • Permission: journey.command.zone (level 2)

/zone list

Section titled “/zone list”

List all zones.

  • Permission: journey.command.zone (level 2)

/zonemanager

Section titled “/zonemanager”

Open the visual zone editor GUI.

  • Permission: journey.command.zonemanager (level 2)

Paths

Section titled “Paths”

/pathmanager

Section titled “/pathmanager”

Open the NPC path editor GUI.

  • Permission: journey.command.pathmanager (level 2)

Markers

Section titled “Markers”

/journey marker update <player>

Section titled “/journey marker update <player>”

Force-refresh all markers for a player.

  • Permission: journey.command.marker (level 2)

Packages

Section titled “Packages”

/journey package list

Section titled “/journey package list”

List all quest packages.

  • Permission: journey.command.package (level 2)

/journey package info <package>

Section titled “/journey package info <package>”

Show package details.

  • Permission: journey.command.package (level 2)

/journey package enable <package>

Section titled “/journey package enable <package>”

Enable a quest package.

  • Permission: journey.command.package (level 2)

/journey package disable <package>

Section titled “/journey package disable <package>”

Disable a quest package.

  • Permission: journey.command.package (level 2)

/journey package reload

Section titled “/journey package reload”

Reload all packages from disk.

  • Permission: journey.command.package (level 2)

/journey package stats

Section titled “/journey package stats”

Show package statistics.

  • Permission: journey.command.package (level 2)

Party System

Section titled “Party System”

/party

Section titled “/party”

Open party management UI (creates party if not in one).

  • Permission: journey.command.party (level 0)

/party create

Section titled “/party create”

Open party creation UI.

  • Permission: journey.command.party (level 0)

/party invites

Section titled “/party invites”

View and manage pending invites.

  • Permission: journey.command.party (level 0)

/party leave

Section titled “/party leave”

Leave your current party.

  • Permission: journey.command.party (level 0)

/party info

Section titled “/party info”

Display current party information.

  • Permission: journey.command.party (level 0)

/party disband

Section titled “/party disband”

Disband the party (leader or admin only).

  • Permission: journey.party.disband (level 2)

Permissions

Section titled “Permissions”

/journey permissions refresh [player]

Section titled “/journey permissions refresh [player]”

Refresh edit permissions for client features.

  • Permission: journey.command.permissions (level 2)

/journey permissions check [player]

Section titled “/journey permissions check [player]”

Check current edit permissions.

  • Permission: journey.command.permissions (level 2)

System

Section titled “System”

/journey reload

Section titled “/journey reload”

Reload all Journey configurations from disk.

  • Permission: journey.command.admin (level 3)

/journey dump-molang

Section titled “/journey dump-molang”

Export a JSON file containing all registered MoLang queries, events, and conditions. Output: config/journey/molang-dump.json. See MoLang Schema Dump.

  • Permission: journey.command.admin (level 3)

/ceremony dump-molang

Section titled “/ceremony dump-molang”

Export Ceremony’s MoLang schema (separate from Journey’s dump). Useful for debugging Ceremony-specific queries.

  • Permission: ceremony.command.admin (level 3)

Permission Levels

Section titled “Permission Levels”

Journey uses the Fabric Permissions API with fallback to vanilla operator levels:

  • Level 0 — All players (bounty boards, party, journal)
  • Level 2 — Operators (zone management, NPC visibility, packages)
  • Level 3 — High-level operators (task admin, buff admin, flags, reload)

Use LuckPerms to assign specific permission nodes to non-operator players.

All Permission Nodes

Section titled “All Permission Nodes”

Player: journey.command.base, journey.command.journal, journey.command.track, journey.command.party, journey.command.bountyboard, journey.command.bountyboard.list, journey.command.createcontract

Management: journey.command.admin, journey.command.levelable, journey.command.levelable.switch, journey.command.levelable.respec, journey.command.buff, journey.command.flag, journey.command.backpack, journey.command.taskitem, journey.command.givetaskitem, journey.command.interactable, journey.command.npcvisibility, journey.command.visibility, journey.command.summon, journey.command.mspawnnpc, journey.command.msummon, journey.command.zone, journey.command.zonemanager, journey.command.pathmanager, journey.command.marker, journey.command.package, journey.command.permissions, journey.globaltask, journey.party.disband

Client Editing: journey.edit.paths, journey.edit.zones