All commands are run as kinswardctl <command> [args...]. Add --json for raw JSON output.
| Command |
Description |
ping |
Test connection |
info |
Server info (version, uptime) |
game-info |
Extended game info (seed, player position, loaded chunks) |
perf |
Per-system timing breakdown |
| Command |
Description |
state |
Player position, z-level, inventory, hotbar |
blocked |
All blocked movement directions |
can-move <dir> |
Check if movement in a direction is possible |
kinswardctl can-move north
| Command |
Description |
move <dir> |
Move in a cardinal direction (north/south/east/west) |
move-delta <dx> <dy> |
Move by tile offset |
stairs <dir> |
Use stairs (up/down) |
teleport <x> <y> <z> |
Teleport to coordinates |
kinswardctl move-delta 3 0
kinswardctl teleport 10 5 2
| Command |
Description |
block <x> <y> <z> |
Block info at coordinates |
surfaces <x> <y> |
Walkable z-levels at (x, y) |
layer -z <z> -x <min>:<max> -y <min>:<max> |
Top-down XY view of a z-level |
cross-section -y <y> -x <min>:<max> -z <min>:<max> |
Side XZ view |
volume -x <min>:<max> -y <min>:<max> -z <min>:<max> |
3D volume snapshot |
nearby <radius> |
Items near the player |
fov <radius> |
Field of view visibility map |
kinswardctl layer -z 1 -x -5:5 -y -5:5
kinswardctl cross-section -y 0 -x -10:10 -z -2:3
kinswardctl volume -x -3:3 -y -3:3 -z 0:2
| Command |
Description |
mine-block <x> <y> <z> |
Remove a block |
place-block <x> <y> <z> <item_id> |
Place a block from inventory |
set-block <x> <y> <z> <block_type> |
Set block type directly |
fill -x <min>:<max> -y <min>:<max> -z <z> <block_type> |
Fill area with a block type |
rebuild-surfaces |
Rebuild the surface index |
kinswardctl mine-block 5 5 1
kinswardctl place-block 5 5 1 100
kinswardctl set-block 5 5 1 40
kinswardctl fill -x -5:5 -y -5:5 -z 1 40
kinswardctl rebuild-surfaces
| Command |
Description |
pickup-nearest |
Pick up the nearest item |
drop-from-slot <slot> [count] |
Drop items from a slot |
select-hotbar <slot> |
Select a hotbar slot (0-9) |
inventory |
Full inventory of the focused entity |
kinswardctl pickup-nearest
kinswardctl drop-from-slot 0 5
kinswardctl select-hotbar 3
| Command |
Description |
registry <kind> |
List all entries (blocks / items / floor-covers) |
lookup <kind> <query> |
Search by name or ID |
kinswardctl registry blocks
kinswardctl registry items
kinswardctl lookup blocks stone
kinswardctl lookup items 100
| Command |
Description |
units |
List all units |
unit-info <entity_id> |
Detailed unit info |
unit-move <entity_id> <x> <y> <z> |
Queue move command |
unit-build <entity_id> <x> <y> <z> <item_id> |
Queue build command |
unit-demolish <entity_id> <x> <y> <z> |
Queue demolish command |
unit-pickup <entity_id> <target_entity_id> |
Queue pickup command |
unit-plan <entity_id> <waypoints...> |
Multi-waypoint route (x,y,z format) |
unit-queue-clear <entity_id> |
Clear command queue |
unit-stop <entity_id> |
Immediate stop |
unit-cancel-task <entity_id> [--tile x,y,z] [--index N] |
Cancel specific task |
unit-follow <follower_id> <target_id> |
Make unit follow another |
kinswardctl unit-info 4294967305
kinswardctl unit-move 4294967305 10 5 1
kinswardctl unit-build 4294967305 10 5 1 100
kinswardctl unit-demolish 4294967305 10 5 1
kinswardctl unit-plan 4294967305 5,0,1 5,5,1 0,5,1
kinswardctl unit-queue-clear 4294967305
kinswardctl unit-follow 4294967305 4294967306
| Command |
Description |
traits |
List all available traits |
unit-add-trait <entity_id> <trait_id> |
Add a trait to a unit |
unit-remove-trait <entity_id> <trait_id> |
Remove a trait from a unit |
Trait IDs: hardy, quicklearner, clumsy, nightowl, strongback, keen, frail, firstborn.
kinswardctl unit-add-trait 4294967305 hardy
kinswardctl unit-remove-trait 4294967305 clumsy
| Command |
Description |
spawn <race> <x> <y> <z> [options] |
Spawn a unit |
possess [entity_id] |
Possess a unit (no ID = release) |
Races: dwarf, goblin, skeleton, human, deer, wolf.
Options for spawn: --name <name>, --faction <faction> (default: colony), --controlled.
Factions: colony, hostile, neutral, wild.
kinswardctl spawn dwarf 10 5 1 --name "Urist" --faction colony --controlled
kinswardctl spawn goblin 5 5 1 --faction hostile
kinswardctl possess 4294967305
| Command |
Description |
zone-demolish --units <ids> -x <min>:<max> -y <min>:<max> -z <z> [--append] |
Bulk demolish |
zone-build --units <ids> -x <min>:<max> -y <min>:<max> -z <z> --item <id> [--append] |
Bulk build |
zone-cancel [--units <ids>] -x <min>:<max> -y <min>:<max> -z <z> |
Cancel zone tasks |
kinswardctl zone-demolish --units 4294967305,4294967306 -x -5:5 -y -5:5 -z 1
kinswardctl zone-build --units 4294967305 -x 0:10 -y 0:10 -z 1 --item 100
kinswardctl zone-cancel -x -5:5 -y -5:5 -z 1
Use --append to add to existing task queues instead of replacing them.
| Command |
Description |
companion-list |
List all companions |
companion-behavior <entity_id> <behavior> |
Set behavior (follow/station) |
companion-call-all |
Set all companions to Follow |
companion-dismiss-all |
Set all companions to Station |
kinswardctl companion-list
kinswardctl companion-behavior 4294967305 follow
kinswardctl companion-call-all
kinswardctl companion-dismiss-all
| Command |
Description |
tasks [--status <filter>] |
List tasks (all/pending/assigned/blocked) |
task-add <kind> <x> <y> <z> [--item <id>] [--target <id>] |
Create a task |
task-cancel <task_id> |
Cancel a task |
task-cancel-zone -x <min>:<max> -y <min>:<max> -z <z> |
Cancel all tasks in zone |
kinswardctl tasks --status pending
kinswardctl task-add build 10 5 1 --item 100
kinswardctl task-add demolish 10 5 1
kinswardctl task-cancel 42
kinswardctl task-cancel-zone -x -5:5 -y -5:5 -z 1
| Command |
Description |
region-map <layer> [options] |
Export region map layer |
Layers: elevation, temperature, rainfall, wind, drainage, rivers, geology, fertility, vegetation, plates, biome.
Options: --format <png/ascii/stats>, --path <output>, --size <N>, --width <N>, -x <N>, -y <N>.
kinswardctl region-map elevation
kinswardctl region-map elevation --format png --path elevation.png --size 1024
kinswardctl region-map rivers --format ascii
kinswardctl region-map biome --format stats
| Command |
Description |
recipes [--station <name>] [--all] |
List crafting recipes (default: available only) |
nearby-station |
Check which crafting station is nearby |
craft <recipe_id> |
Craft a recipe by ID |
kinswardctl recipes # available recipes
kinswardctl recipes --all # all recipes
kinswardctl recipes --station FURNACE --all # recipes for a station
kinswardctl nearby-station
| Command |
Description |
save [name] |
Save the world (default: world_{seed}) |
load <name> |
Load a saved world |
saves |
List all save slots |
delete-save <name> |
Delete a save slot |
kinswardctl save my_world
kinswardctl load quicksave
kinswardctl delete-save old_save
| Command |
Description |
switch-mode <mode> |
Switch game mode (adventure / overseer / map) |
set-tool-mode <mode> |
Set overseer tool mode (auto / force-build / force-demolish / force-pickup / force-cancel) |
set-active-z <z> |
Set the active z-level for rendering |
kinswardctl switch-mode overseer
kinswardctl switch-mode adventure
kinswardctl set-tool-mode auto
kinswardctl set-active-z 0
| Command |
Description |
camera-move <x> <y> |
Move camera by tile offset (overseer mode) |
camera-zoom <level> |
Set camera zoom level (0.1–20.0) |
kinswardctl camera-move 5 5
kinswardctl camera-move -10 0
kinswardctl camera-zoom 2.0
| Command |
Description |
select <entity_id> |
Select a unit |
deselect-all |
Deselect all units |
selection |
Query current selection and focus |
kinswardctl select 4294967305
| Command |
Description |
set-floor-cover <x> <y> <z> <cover> |
Set a floor cover at coordinates |
remove-floor-cover <x> <y> <z> |
Remove a floor cover |
Cover names: carpet, blood_stain, puddle.
kinswardctl set-floor-cover 5 5 0 carpet
kinswardctl remove-floor-cover 5 5 0
| Command |
Description |
light <x> <y> <z> |
Query light value at coordinates (0.0–1.0) |
Send arbitrary JSON directly to the TCP server:
kinswardctl raw '{"cmd":"Ping"}'
kinswardctl raw '{"cmd":"QueryState"}'
