Documentation · Masters Plugin

Commands to create maps

Reference for all the /masters map, /masters zone and /masters wand commands used to build a map from scratch, import it, or edit it. Does not cover match or arena administration.

All commands on this page require the masters.admin permission (granted to operators by default).
Bringing in a map from the original XML format? Use the XML → YML map converter to get a head start on its .yml file.

Creation flow

Typical order to build a King of the Hill map from scratch.

  1. /masters map create <name> [gameMode]
  2. /masters wand
  3. /masters map setspawn <BLUE|RED|OBS>
  4. /masters zone create <id> [name] - repeat for each zone, selecting with the wand
  5. /masters map kit <BLUE|RED> → arrange items → /masters map kit save
  6. (Optional) setdisplayname, settarget, creators, killreward, dropitems, settime, setweather, setworldtype, setzoneblocks
  7. /masters map save
HTF Hold the Flag: step 4 is replaced with /masters map flag add instead of zones.
Importing an already-built world: use /masters map import instead of /masters map create (same flow from step 3 onward).

Selection and zones

The wand defines the selection used by the zone commands. Only applies to KOTH maps.

CommandDescription
/masters wand Gives you the zone selection tool: left click = point 1, right click = point 2.
/masters zone create <id> [name] Creates a capture zone (KOTH) using the wand's current selection. The id can't contain dots.
/masters zone list Lists the zones already defined on the map being built/edited.
/masters zone delete <id> Deletes a zone from the map being edited.

Map lifecycle

Open, save, reload or delete a map's session/configuration.

CommandDescription
/masters map create <name> [gameMode] Starts building a new map (default gameMode: koth) in the world the player is standing in.
/masters map import <name> [gameMode] [void] Imports an already-built world (folder under maps/<name>, alongside plugins/ and world/) and starts the same editing flow. void can only be set here, not afterward.
/masters map edit <name> Reopens the editing session of an already-saved map to modify spawns, zones or other options.
/masters map save Saves the map being built/edited: clones the world to disk and writes its maps/<name>.yml file.
/masters map cancel Cancels the current creation/editing session without saving changes.
/masters map list Lists all configured maps, their game mode, zone/flag count and creators.
/masters map reload Reloads all maps from disk.
/masters map delete <name> Deletes a map's configuration (keeps the world files on disk).

Spawns, flag and map limits

Team spawn points, flag (HTF only) and world limits.

CommandDescription
/masters map setspawn <BLUE|RED|OBS> Sets that team's (or spectators') spawn point at the player's current position.
/masters map flag add Adds the current position as a possible flag spawn point. HTF
/masters map flag list Lists the defined flag spawn points. HTF
/masters map flag remove <index> Removes a flag spawn point by its index. HTF
/masters map setvoidy <y> Sets the Y height below which a player automatically dies (falling into the void).
/masters map setworldtype <void|normal> Sets whether new chunks generate as total void or the server's normal generator. On import, this is set directly in that command.

Scoring, display name and rewards

CommandDescription
/masters map settarget <points|default> Sets how many points/captures a team needs to win on this map. default inherits the global value (game.target-score).
/masters map setdisplayname <name...|clear|default> Sets the map's display name (spaces allowed), shown in TAB, chat and the countdown. clear/default goes back to showing the internal name.
/masters map creators <add|remove|set|clear|list> <name...> Manages the map's list of creators, shown in TAB and in /masters map list.
/masters map killreward <item:qty,...|none|default> Sets the items given per kill on this map. none = no reward; default inherits the global config (kill-rewards.*).
/masters map dropitems <item1,item2,...|none> Sets which items are dropped on death on this map (by default nothing drops).

Map environment

Time, weather and zone marker blocks.

CommandDescription
/masters map settime <preset|ticks|clear> Sets the map's time of day. Presets: day, noon, sunset, night, midnight, sunrise (or a tick count). clear returns to the normal cycle.
/masters map setweather <clear|rain|default> Sets the map's weather to always clear or always raining. default returns to the normal cycle.
/masters map setzoneblocks <blue_block> <red_block>|clear Overrides the floor blocks used to mark zone control on this map. clear returns to the global value. KOTH

Kits per map

The exact kit (armor + inventory) each team receives on this map.

CommandDescription
/masters map kit <BLUE|RED> Starts capturing that team's exact kit: empties the admin's inventory so they can build it by hand (armor, hotbar, everything).
/masters map kit save Saves the current inventory as the kit for the team being edited and restores the admin's original inventory.
/masters map kit cancel Cancels the kit capture in progress and restores the admin's original inventory without saving.

Map file (example)

This is what maps/<name>.yml looks like after running the full flow (this example is an HTF map, hence the flag-spawns instead of zones). The team-spawns and kits blocks are written automatically by map setspawn and map kit save - they aren't edited by hand. 

# generated by: map create -> wand+setspawn -> flag add x3 -> map kit save x2 -> map save
name: desert
display-name: Desert Sanctuary
game-mode: htf
world-template: desert
min-players: 2
max-players-per-team: 5
creators:
  - Strangey
  - Avaleer
kill-rewards:
  - <GOLDEN_APPLE:1>
time: day
rain: false
world-type: VOID

team-spawns:
  BLUE: { x: 8.59, y: 20.0, z: -53.63, yaw: -0.44, pitch: 2.54 }
  RED:  { x: 8.50, y: 20.0, z: 70.52,  yaw: -179.55, pitch: -0.45 }
  OBS:  { x: 8.47, y: 55.0, z: 8.37,   yaw: 87.59, pitch: 0.89 }

flag-spawns:
  '0': { x: 8.57,   y: 13.0, z: 8.53,  yaw: 0.59,   pitch: 1.34 }
  '1': { x: -14.48, y: 18.0, z: 8.42,  yaw: -87.90, pitch: 5.09 }
  '2': { x: 31.50,  y: 18.0, z: 8.32,  yaw: 90.44, pitch: 10.79 }

kits:
  BLUE:
    exact-helmet:    { id: minecraft:leather_helmet,   count: 1 }
    exact-chestplate: { id: minecraft:leather_chestplate, count: 1 }
    exact-leggings:  { id: minecraft:chainmail_leggings, count: 1 }
    exact-boots:     { id: minecraft:iron_boots,       count: 1 }
    exact-slots:
      '0':  { id: minecraft:stone_sword,  count: 1 }
      '1':  { id: minecraft:bow,          count: 1 }
      '2':  { id: minecraft:golden_apple, count: 1 }
      '3':  { id: minecraft:cooked_beef,  count: 8 }
      '28': { id: minecraft:arrow,        count: 12 }
  RED:
    # same structure as BLUE