csharpfritz/aspire-minecraft/minecraft-block-facing

Context

When placing wall-mounted blocks (levers, torches, ladders, signs, wall banners) in Minecraft via RCON setblock commands, the facing property determines both the visual direction and which adjacent block provides structural support. Getting this wrong causes blocks to float or immediately pop off.

Patterns

1. Facing = extension direction. facing=X means the item visually extends/points in direction X.
2. Support = opposite of facing. The solid block the item attaches to is in the OPPOSITE direction from facing.
3. Position the item in empty space, not inside the wall. The item occupies its own block space; the support block is adjacent.

Direction reference (Minecraft coordinates):

• North = -Z, South = +Z, East = +X, West = -X

For a lever on a building's south-facing front wall (wall at Z-min side):

• Place lever at wallZ - 1 (one block in front of the wall)
• Use facing=north (lever extends toward camera/player)
• Support block is to the south at (wallZ - 1) + 1 = wallZ (the wall itself)

Examples

// Lever on front wall (Z-min side), one block in front of wall face
var leverZ = door.FaceZ - 1;
await rcon.SendCommandAsync(
    $"setblock {x} {y} {leverZ} minecraft:lever[face=wall,facing=north,powered=false]");
// Support block is at leverZ + 1 = door.FaceZ (the wall)

// Wall banner on east wall (X-max side)
var bannerX = wallX + 1;
await rcon.SendCommandAsync(
    $"setblock {bannerX} {y} {z} minecraft:purple_wall_banner[facing=east]");
// Support block at bannerX - 1 = wallX (the wall)

Anti-Patterns

• Placing the item AT the wall coordinate — replaces the wall block, and support direction points to interior air (floating item).
• Using `facing=south` when the wall is to the south — support would be to the north (away from wall), causing the item to float.
• Confusing `facing` with "the direction the wall is in" — facing is the direction the item EXTENDS, not where the wall is.

4. Door blocks

A door's facing property indicates where the FRONT face of the door points. For an entrance on a building wall, the door's front face should point into the building (toward the interior).

• Door on min-Z wall (north wall): Use facing=south — front face points south (into the building)
• Door on max-Z wall (south wall): Use facing=north — front face points north (into the building)
• Door on min-X wall (west wall): Use facing=east — front face points east (into the building)
• Door on max-X wall (east wall): Use facing=west — front face points west (into the building)

Wall signs near doors follow the same convention: facing points toward the viewer (into the room for interior signs).

// Door on south wall (max-Z), entrance facing into the building
await rcon.SendCommandAsync(
    $"setblock {midX} {y + 1} {z2} minecraft:oak_door[facing=north,half=lower,hinge=left]");
await rcon.SendCommandAsync(
    $"setblock {midX} {y + 2} {z2} minecraft:oak_door[facing=north,half=upper,hinge=left]");
 
// Interior welcome sign above the south-wall entrance (one block inside)
await rcon.SendCommandAsync(
    $"setblock {midX} {y + 4} {z2 - 1} minecraft:oak_wall_sign[facing=north]");

5. Stair blocks for ramps and bridges

Stairs have a facing property that controls the ascent direction. facing=X means the stair's full-block back faces direction X, and the step opens in the opposite direction.

For a south-to-north ramp (player walks toward +Z and goes up):

• Use facing=north — back faces north, step faces south, player steps up walking north

For a north-to-south ramp (player walks toward -Z and goes up):

• Use facing=south — back faces south, step faces north, player steps up walking south

// South approach ramp — player walks north (+Z) and ascends
await rcon.SendCommandAsync(
    $"fill {x1} {y} {z} {x2} {y} {z} minecraft:stone_brick_stairs[facing=north,half=bottom]");
 
// North exit ramp — symmetric descent (also works as approach from north)
await rcon.SendCommandAsync(
    $"fill {x1} {y} {z} {x2} {y} {z} minecraft:stone_brick_stairs[facing=south,half=bottom]");