Tools for use in conjunction with WesterosBlocks and WorldEdit on the WesterosCraft server.

Commands /wctools cycler

• The first one is basically identical to the current cycler tool except that it automatically sets unconnect=true when applicable. /wctools extrude
• a variant of the cycler tool that toggles the blockstate for a wall, fence, pane, or stair block in a particular direction - either on the side facing the user for right click, or the opposite side for left click. /wctools paint <set>
• a paint tool that can paint over any block set with another block set

The paint command requires a list of blocksets to be provided in config/westerostools/blocksets.json. WesterosBlocks will automatically generate this file on server startup, so it gets dumped in config/westerosblocks/blocksets.json. Any time there's a block update, that file will need to be copied over to the westerostools directory

WesterosTools

A Fabric mod providing specialized build tools for the WesterosCraft server, designed to work alongside the WesterosBlocks modpack.

WorldEdit must be installed on the server for the mod to function. Tools are bound using WorldEdit's session system and respect WorldEdit's permission model.

Server Configuration

On first run, the mod creates a config directory at config/westerostools/. Two JSON files are read from this directory at server startup:

blocksets.json (required for Paint and Chisel)

Defines named block sets - groups of related block variants that belong to the same material family. The Paint and Chisel tools use this mapping to swap one variant for another within the same set.

{
  "blocksets": [
    {
      "id": "westerosblocks:mystone",
      "altname": "mystone",
      "blocks": [
        { "id": "westerosblocks:mystone", "variant": "solid" },
        { "id": "westerosblocks:mystone_stairs", "variant": "stairs" },
        { "id": "westerosblocks:mystone_slab", "variant": "slab" },
        { "id": "westerosblocks:mystone_wall", "variant": "wall" }
      ]
    }
  ]
}

• id: canonical set identifier (used in /wctool paint)
• altname: optional short alias for the set
• blocks: list of block definitions, each with a block id and a variant (see Variants below)

If blocksets.json is missing or empty, the mod will still load but Paint and Chisel will not be able to resolve block set relationships.

custom_states.json (optional)

Allows blocks that share the same block ID but differ only in block state properties to be treated as members of different sets. Useful for blocks whose variant is determined by a property value rather than a distinct block ID.

{
  "westerosblocks:mystone_set_a": {
    "westerosblocks:mystone_shared_block": "color:red"
  },
  "westerosblocks:mystone_set_b": {
    "westerosblocks:mystone_shared_block": "color:blue"
  }
}

The top-level keys are set IDs, the inner keys are block IDs, and the values are comma-separated property:value pairs that identify which state maps to that set.

Variants

The following variant identifiers are supported in blocksets.json:

Permissions

Tools use WorldEdit's permission system. Grant the following permission nodes through your permission plugin:

Commands and Tools

All commands are under /wctool. Each command binds a tool to the item currently held in the player's main hand. Use /tool unbind to remove a tool binding.

/wctool cycler - Block Data Cycler

A variant of WorldEdit's built-in data cycler that automatically sets the unconnect property to true whenever it is present on a block (used by WesterosBlocks custom blocks to suppress automatic neighbor-connection logic).

/wctool chisel - Chisel

Converts a block into a related variant from the same block set based on where the player clicks on the face. The clicked face is divided into a 3x3 UV grid (LOW/MID/HIGH on each axis), and the target variant is determined by a transition table.

• Left-click (primary): Sculpt mode - uses the sculpt transition table (SculptTransitions)
• Right-click (secondary): Chisel mode - uses the chisel transition table (ChiselTransitions)

Both modes resolve the source block's set from blocksets.json, find the target variant, carry over compatible block state properties, and automatically set unconnect=true if the target block supports it. Changes are recorded in WorldEdit's undo history.

Example (NORTH face grid, chisel mode):

HIGH | outer_left stair (W,top) | stair (N,top)    | outer_right stair (E,top) |
MID  | stair (W)                | wall (E+W)       | stair (E)                 |
LOW  | outer_right stair (W)    | stair (N,bottom) | outer_left stair (E)      |
      u=LOW (east)               u=MID              u=HIGH (west)

/wctool extrude - Extrude

Cycles directional block state properties in the direction the player is facing. Useful for extending wall connections, adjusting stair shapes, or toggling directional properties on WesterosBlocks custom blocks.

For blocks with a named directional property (e.g., north, south, east, west), the corresponding property is cycled. For stair blocks, the shape property is cycled among inner_left, inner_right, straight (forward) or outer_left, outer_right, straight (backward). Sets unconnect=true if present.

/wctool paint [blockset] <radius> - Paint

Paints blocks with a material from a block set, preserving the variant and block state of each target block.

/wctool paint                    # bind with no set selected
/wctool paint <radius>           # bind with radius, no set selected
/wctool paint <blockset>         # bind with a specific block set (radius 1)
/wctool paint <blockset> <radius># bind with a specific block set and radius

Behavior:

• Right-click samples the clicked block. If it belongs to a known set (via blocksets.json or custom_states.json), that set is selected. Otherwise the block is treated as a singleton and painting will replace blocks with that exact block ID.
• Left-click (single block): Replaces the clicked block with the corresponding variant from the selected set, copying compatible block state properties.
• Left-click (radius > 1): Paints all blocks within a sphere of the given radius. In radius mode, only blocks whose variant can be inferred (solid, stairs, slab, wall, or fence) are painted - air and other non-matching blocks are skipped.
• If custom_states.json defines a mapping for the source block ID, that mapping is applied instead of the standard variant lookup.

The <blockset> argument supports tab-completion from the loaded blocksets.json.