blockwright
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| BLOCKWRIGHT_WORLD | No | Overworld folder name. Defaults to level-name from server.properties, or 'world' if not set. | |
| BLOCKWRIGHT_BOUNDS | No | World bounds as x1,y1,z1,x2,y2,z2. Writes outside this box are refused. | |
| BLOCKWRIGHT_RCON_HOST | No | RCON host. Defaults to 127.0.0.1. | 127.0.0.1 |
| BLOCKWRIGHT_RCON_PORT | No | RCON port. Defaults to the rcon.port value from server.properties, or 25575 if not set. | |
| BLOCKWRIGHT_FILL_LIMIT | No | Blocks per fill command. Defaults to 32768. | 32768 |
| BLOCKWRIGHT_MAX_VOXELS | No | Upper bound on how many voxels place_shape will generate before rejecting the request as too large. Defaults to 5000000. | 5000000 |
| BLOCKWRIGHT_MC_VERSION | No | Override for the Minecraft version when there is no server folder. | |
| BLOCKWRIGHT_SERVER_DIR | No | Path to the Minecraft server folder. Enables reading server.properties, level.dat, region files, WorldEdit schematic folder, and structure-template path used for big pastes and snapshots. If set, RCON port, password, level name, and Minecraft version are read from server.properties/level.dat automatically. | |
| BLOCKWRIGHT_ALLOW_ADMIN | No | Set to '1' or 'true' to let run_command run administrative commands (stop, op, ban, whitelist, kick, reload). | |
| BLOCKWRIGHT_BLUEMAP_URL | No | Optional BlueMap URL shown in server_info so the assistant can point the user at the map. | |
| BLOCKWRIGHT_PREVIEW_DIR | No | Where preview HTML files go. Defaults to ~/.cache/blockwright/previews. | |
| BLOCKWRIGHT_DATA_VERSION | No | Override for the Minecraft data version when there is no server folder. | |
| BLOCKWRIGHT_TEMPLATE_MAX | No | Template tile size. Defaults to 48. | 48 |
| BLOCKWRIGHT_RCON_PASSWORD | No | RCON password. Required one way or the other: either from server.properties (when BLOCKWRIGHT_SERVER_DIR is set) or supplied directly via this variable. | |
| BLOCKWRIGHT_SCHEMATIC_DIR | No | Directory where relative schematic paths resolve. Defaults to plugins/WorldEdit/schematics if present, otherwise the current working directory. | |
| BLOCKWRIGHT_SAVE_COALESCE_MS | No | Reads skip save-all flush when nothing was written and the last save is younger than this many milliseconds. Defaults to 30000. | 30000 |
| BLOCKWRIGHT_STRUCTURE_THRESHOLD | No | Above this many commands, a build is placed as structure templates instead. Defaults to 400. | 400 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| server_infoB | Minecraft version, player count, whether world reads/snapshots are available, and the effective blockwright configuration. |
| get_playersA | Names, worlds, block positions, look direction and gamemode of online players. Use to pick a build site near someone. |
| run_commandA | Run a raw server console command and return its output. Administrative commands (stop, op, ban, whitelist, kick, reload…) are refused unless BLOCKWRIGHT_ALLOW_ADMIN=1. Prefer the build tools; use this for things like time, weather, tp, give, say. |
| fillA | Fill a box with one block. Modes: replace (optionally only blocks matching replace_filter), keep (only air), destroy (drop items), hollow (walls + air inside), outline (walls only, interior untouched). Splits over the 32768-block command limit automatically. |
| buildA | Place a structure described as layers of characters. palette maps one character to a block state; rows run north→south (z), characters west→east (x); y is height above origin. Space leaves the world alone. Extra single blocks go in "blocks". Rotation keeps the min corner at origin. Run with dry_run=true first, and preview before that. |
| place_shapeC | Sphere, dome, cylinder, cone, pyramid, line or circle, filled or hollow. Radius r gives a diameter of 2r+1. |
| paste_schematicA | Paste a Sponge .schem or vanilla structure .nbt. By default origin is where the schematic's min corner lands; use_offset=true adds the file's stored offset like WorldEdit //paste. ignore_air skips air so the surroundings survive. |
| schematic_infoB | Format, size, offset, DataVersion, block counts and block-entity count of a .schem/.nbt file. |
| schematic_writeA | Save a build spec or a shape as a .schem (Sponge v3) or .nbt (vanilla structure) file without touching any server. Relative paths go to the schematic dir. |
| previewB | Render a build spec, a shape, or a schematic as ASCII layer slices (returned) and as a self-contained 3D HTML viewer (path returned; send that file to the user). Set context>0 to include the surrounding world blocks so the design is shown in place. Nothing is changed in the world. |
| read_regionA | Block counts for a box, plus ASCII layer slices when the box is small (≤4096 blocks) or full=true. Use after building to verify the result. |
| get_blockC | The block state at a position. |
| get_heightmapA | Surface y and surface block for an x/z rectangle, as a sampled grid (rows = z north→south, columns = x west→east). The site-scouting tool: find flat ground and the y to build at (surface y + 1). |
| save_schematicB | Copy a box from the world into a .schem (Sponge v3) or .nbt (structure) file, block entities included. |
| list_snapshotsA | Snapshots taken before writes, newest first, with ids for undo. |
| undoA | Restore the newest snapshot(s) taken before writes (or a specific id from list_snapshots). Each restored snapshot is removed from the list. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| build-workflow | Step-by-step workflow for building something on the server safely: scout, preview, dry run, build, verify, undo. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| palette-guide | Block palettes per style, proportions, texturing and block-state cheatsheet |
TDQS
Scored across 16 tools
Most tools map to a distinct workflow step: reading world state, previewing designs, writing blocks, managing schematics, and undoing. A few could be confused at a glance—save_schematic vs schematic_write and preview vs read_region—but the descriptions clearly separate them.
There is a recognizable pattern with get_* for queries and verb_noun for many actions, but bare verbs like fill, build, undo, and preview plus the reversed schematic_info and schematic_write break the pattern. The names are still readable and meaningful, just not fully consistent.
Sixteen tools is somewhat high, but each one earns its place across querying, editing, previewing, schematics, and undo. There is no obvious redundancy, and the count feels appropriate for a Minecraft world-building server.
The toolset covers the core build-verify-undo-schematic lifecycle well: inspect terrain, build with multiple methods, preview designs, read results, save/paste schematics, and undo writes. Minor gaps like no schematic file listing or paste rotation are workarounds rather than dead ends.