bkeditor command

The /bkeditor command is Brotkrumen’s in-game graph editing toolkit. Use it to create routes, place nodes, connect edges, manage selections, preview reference graphs, set visual presets, and define managed warps.

Most editor actions are player-only because they depend on your current location, view, selection, or active editor session.

At a glance

/bkeditor create <name>
/bkeditor edit <graphName>
/bkeditor rename <newName>
/bkeditor finish
/bkeditor cancel

/bkeditor preview
/bkeditor place
/bkeditor continue
/bkeditor undo [amount]

/bkeditor settings show
/bkeditor settings node-distance <blocks>
/bkeditor settings placement <mode>
/bkeditor settings continue-requires-node <enabled>
/bkeditor settings place-nodes-on-ground <enabled>
/bkeditor settings preset <presetName>
/bkeditor preset <renderer> <presetName>

/bkeditor view add <graphName>
/bkeditor view remove <graphName>
/bkeditor view clear

/bkeditor select node
/bkeditor select edge
/bkeditor selection show
/bkeditor selection clear
/bkeditor selection connections
/bkeditor selection teleport

/bkeditor edge connect <type>
/bkeditor edge traversal <traversal>
/bkeditor edge state <state>
/bkeditor edge remove

/bkeditor delete node
/bkeditor delete graph <graphName>

/bkeditor warp selected <key>
/bkeditor warp here <key>
/bkeditor warp remove <key>
/bkeditor warp list
/bkeditor warp list all
/bkeditor warp set cost <key> <cost>
/bkeditor warp set enabled <key> <enabled>
/bkeditor warp set permission <key> <required>

The editor flow

A typical editing session looks like this:

/bkeditor create forest_path
/bkeditor preview
/bkeditor place
/bkeditor continue
/bkeditor place
/bkeditor finish

Think of the editor as a small workspace attached to your player:

Open a session with create or edit.
Place nodes at your current position.
Connect and tune edges when needed.
Preview or reference other graphs while building.
Finish to persist your graph, or cancel to discard the active session.

Session commands

These commands control the lifecycle of your active editor session.

Command	What it does
`/bkeditor create <name>`	Starts a new graph editing session with the given graph name.
`/bkeditor edit <graphName>`	Opens an existing graph for editing. Graph names are suggested through tab completion.
`/bkeditor rename <newName>`	Renames the currently active graph.
`/bkeditor finish`	Finishes the active route creation or editing session and saves the result.
`/bkeditor cancel`	Cancels the active editor session.

Examples

/bkeditor create spawn_to_market
/bkeditor edit spawn_to_market
/bkeditor rename spawn_to_harbor
/bkeditor finish

Placement commands

Placement commands help you build the route in-world.

Command	What it does
`/bkeditor preview`	Shows a preview of the current editor state.
`/bkeditor place`	Places a node at your current location.
`/bkeditor continue`	Continues placement from the current editor state.
`/bkeditor undo`	Undoes the last editor action.
`/bkeditor undo <amount>`	Undoes multiple editor actions. The amount must be at least `1`.

Examples

/bkeditor place
/bkeditor undo
/bkeditor undo 3

Editor settings

Editor settings let you adjust how the active editing session behaves.

Command	What it does
`/bkeditor settings show`	Displays the current editor settings.
`/bkeditor settings node-distance <blocks>`	Sets the preferred distance between placed nodes. The value must be at least `1`.
`/bkeditor settings placement <mode>`	Changes the placement mode. Available values are suggested in-game.
`/bkeditor settings continue-requires-node <enabled>`	Controls whether `continue` requires a nearby node. Use `true` or `false`.
`/bkeditor settings place-nodes-on-ground <enabled>`	Controls whether new nodes snap to the highest block at the player’s X/Z position. Use `true` or `false`.
`/bkeditor settings preset <presetName>`	Applies a supported temporary editor preview preset for the active renderer. Preset names are suggested in-game.

The default editor settings are loaded from config keys such as:

editor:
  defaultNodeDistance: 10
  defaultPlacementMode: auto
  defaultEditPlacementMode: preview
  placeNodesOnGround: false
  continueRequiresNode: true
  defaultPreset: ember

Examples

/bkeditor settings show
/bkeditor settings node-distance 8
/bkeditor settings placement preview
/bkeditor settings continue-requires-node false
/bkeditor settings place-nodes-on-ground true
/bkeditor settings preset ember

Graph visual presets

The top-level preset command stores renderer-specific presets on the active graph.

Command	What it does
`/bkeditor preset <renderer> <presetName>`	Sets the active graph’s persistent preset for the selected renderer.

Supported renderer values are suggested in-game and include:

spellbookEffect
blockDisplay

Preset names come from presets.yml; the default bundled presets are ember and prism.

Examples

/bkeditor preset spellbookEffect ember
/bkeditor preset blockDisplay prism

Reference graph view

The view subcommands let you show other graphs as visual references while editing.

Command	What it does
`/bkeditor view add <graphName>`	Adds a graph to your reference view.
`/bkeditor view remove <graphName>`	Removes a graph from your reference view.
`/bkeditor view clear`	Clears all reference graphs from your view.

Examples

/bkeditor view add old_spawn_route
/bkeditor view remove old_spawn_route
/bkeditor view clear

Selection commands

Selections are used for node edits, edge edits, teleporting to graph elements, and inspecting connections.

Select something nearby

Command	What it does
`/bkeditor select node`	Selects a nearby node.
`/bkeditor select edge`	Selects a nearby edge.

Work with the current selection

Command	What it does
`/bkeditor selection show`	Shows the current selection.
`/bkeditor selection clear`	Clears the current selection.
`/bkeditor selection connections`	Lists the selected node’s connections.
`/bkeditor selection teleport`	Teleports you to the selected element, when possible.

Examples

/bkeditor select node
/bkeditor selection connections
/bkeditor selection teleport

Edge commands

Edges connect nodes and define how the graph can be traversed.

Command	What it does
`/bkeditor edge connect <type>`	Creates an edge between selected nodes using the given edge type.
`/bkeditor edge traversal <traversal>`	Updates traversal behavior for the selected edge.
`/bkeditor edge state <state>`	Updates the selected edge state.
`/bkeditor edge remove`	Removes the selected edge.

The available type, traversal, and state values are suggested through tab completion.

Common values are:

Argument	Values
`type`	`directed`, `undirected`
`traversal`	`normal`, `teleport`
`state`	`open`, `blocked`

Examples

/bkeditor edge connect directed
/bkeditor edge traversal teleport
/bkeditor edge state open
/bkeditor edge remove

Delete commands

Use delete commands carefully. They modify graph data directly.

Command	What it does
`/bkeditor delete node`	Deletes the currently selected node.
`/bkeditor delete graph <graphName>`	Deletes a persisted graph by name. Graph names are suggested in-game.

Examples

/bkeditor delete node
/bkeditor delete graph test_route

Warp commands

Managed warps can be attached to selected graph elements or to your current location.

Command	What it does
`/bkeditor warp selected <key>`	Creates a warp from the current selection.
`/bkeditor warp here <key>`	Creates a warp at your current location.
`/bkeditor warp remove <key>`	Removes a managed warp.
`/bkeditor warp list`	Lists managed warps for the active context.
`/bkeditor warp list all`	Lists all managed warps.
`/bkeditor warp set cost <key> <cost>`	Sets the warp cost. The cost must be `0.0` or higher.
`/bkeditor warp set enabled <key> <enabled>`	Enables or disables a warp. Use `true` or `false`.
`/bkeditor warp set permission <key> <required>`	Controls whether the warp requires permission. Use `true` or `false`.

Warps with required permissions only participate in /bk resolve for players who have the matching permission.

Examples

/bkeditor warp here harbor
/bkeditor warp selected market_gate
/bkeditor warp set cost harbor 25.0
/bkeditor warp set enabled harbor true
/bkeditor warp set permission harbor true
/bkeditor warp list all