Placing Furniture

Critical: SCAN BEFORE PLACING

Avoid furniture embedded in floor!

# 1. Scan area
scan = spatial_awareness_scan(center_x=100, center_y=65, center_z=200, radius=5, detail_level="medium")

# 2. Get placement Y from recommendations
placement_y = scan['recommendations']['floor_placement_y']  # e.g., 65

# 3. Place furniture AT that Y using build_schematic
build_schematic(
    schematic={
        "a": [100, placement_y, 200],
        "p": {"C": "oak_stairs[facing=south]", "L": "oak_wall_sign[facing=east]", "R": "oak_wall_sign[facing=west]"},
        "l": [[0, "L C R"]]
    },
    description="Armchair"
)

Common mistake: Floor at Y=64, furniture at Y=64 = EMBEDDED! Use Y=65 (ON floor).

Furniture Catalog

See furniture_catalog.md in this skill folder for 80+ ready-to-use schematics:

Category	Items
Seating	chair, armchair, bench, stool, sofa, throne
Tables	dining, coffee, desk, kitchen counter
Bedroom	bed, nightstand, wardrobe, dresser, bunk bed
Storage	bookshelf, cabinet, cupboard, barrel rack
Lighting	floor lamp, chandelier, wall sconce, hidden light
Kitchen	sink, stove, fridge, counter
Bathroom	toilet, bathtub, shower, mirror
Living Room	TV, fireplace, piano, rug
Office	computer, filing cabinet, office chair
Outdoor	grill, patio table, fountain, mailbox

Quick Placement Examples

Armchair

{"a": [X, Y, Z], "p": {"C": "oak_stairs[facing=south]", "L": "oak_wall_sign[facing=east]", "R": "oak_wall_sign[facing=west]"}, "l": [[0, "L C R"]]}

Dining Table (2x3)

{"a": [X, Y, Z], "p": {"F": "oak_fence", "S": "oak_slab[type=bottom]"}, "l": [[0, "F . F|. . .|F . F"], [1, "S S S|S S S|S S S"]]}

Floor Lamp

{"a": [X, Y, Z], "p": {"F": "oak_fence", "L": "lantern"}, "l": [[0, "F"], [1, "F"], [2, "L"]]}

Hanging Chandelier

{"a": [X, Y, Z], "p": {"C": "chain", "L": "lantern[hanging=true]"}, "l": [[0, "C"], [-1, "L"]]}

Kitchen Sink

{"a": [X, Y, Z], "p": {"H": "hopper[facing=down]", "L": "lever"}, "l": [[0, "H"], [1, "L"]]}

Toilet

{"a": [X, Y, Z], "p": {"H": "hopper[facing=down]", "T": "oak_trapdoor[facing=south,half=top,open=false]", "L": "lever"}, "l": [[0, "H"], [1, "T L"]]}

Simple Fireplace

{"a": [X, Y, Z], "p": {"S": "stone_bricks", "C": "campfire[lit=true]"}, "l": [[0, "S C S"], [1, "S . S"], [2, "S S S"]]}

Workflow

# 1. Scan room to get correct Y levels
scan = spatial_awareness_scan(center_x=X, center_y=Y, center_z=Z, radius=8, detail_level="medium")
floor_y = scan['recommendations']['floor_placement_y']
ceiling_y = scan['recommendations']['ceiling_placement_y']

# 2. Place floor furniture (tables, chairs, beds)
build_schematic(
    schematic={"a": [100, floor_y, 200], ...},
    description="Dining table"
)

# 3. Place ceiling fixtures (use negative Y offsets from ceiling)
build_schematic(
    schematic={"a": [100, ceiling_y, 200], "p": {"C": "chain", "L": "lantern[hanging=true]"}, "l": [[0, "C"], [-1, "L"]]},
    description="Hanging lantern"
)

# 4. Add wall decorations
build_schematic(
    schematic={"a": [100, floor_y + 1, 200], "p": {"T": "wall_torch[facing=south]"}, "l": [[0, "T"]]},
    description="Wall torch"
)

Room Layouts

Bedroom (5x6)

Bed against wall (head at wall)
Nightstand beside bed head
Wardrobe on opposite wall
Lamp on nightstand
Rug beside bed

Living Room (7x9)

Sofa against wall
Coffee table in front of sofa
Armchairs angled toward sofa
Bookshelf on side wall
Fireplace on focal wall
Chandelier centered

Dining Room (7x9)

Table centered
Chairs around table (facing inward)
Chandelier above table
Cabinet/sideboard against wall

Kitchen (5x7)

Counters along walls (L or U shape)
Stove recessed into counter
Sink with lever tap
Fridge in corner
Small table or island

Block State Reference

Stairs (seats, backs)

oak_stairs[facing=north,half=bottom]  # Player sits facing north
oak_stairs[facing=south,half=top]     # Upside-down (table legs)

Trapdoors (backs, doors, shelves)

oak_trapdoor[facing=south,half=bottom,open=true]   # Backrest
oak_trapdoor[facing=south,half=top,open=false]     # Lid/cover

Signs (armrests)

oak_wall_sign[facing=east]   # Sign on west side of block
oak_wall_sign[facing=west]   # Sign on east side of block

Slabs (tabletops, seats)

oak_slab[type=bottom]  # On floor
oak_slab[type=top]     # Near ceiling

Lanterns

lantern              # Standing
lantern[hanging=true] # Hanging from above

Wall Torches

wall_torch[facing=north]  # On south wall, points north
wall_torch[facing=south]  # On north wall, points south

Furniture Orientations

When placing furniture, consider which way it faces:

Facing	Meaning
north	Player faces north when using
south	Player faces south when using
east	Player faces east when using
west	Player faces west when using

Stairs as chairs: facing = direction player faces when sitting Doors/chests: facing = direction they open toward

Style Coordination

Style	Wood	Accents	Textiles
Rustic	Oak, Spruce	Barrels, lanterns	Brown carpet
Modern	Birch, Quartz	Sea lanterns	White carpet
Medieval	Dark Oak	Chains, anvils	Red carpet
Asian	Bamboo, Cherry	Paper lanterns	Cyan carpet
Nether	Crimson, Warped	Soul lanterns	Black carpet

Spacing Guidelines

Tables: 1 block clearance around for movement
Chairs: Push against table edge
Beds: 1 block on access side
Walkways: 2 blocks minimum width
Ceiling lights: Every 4-5 blocks for even lighting
Wall decor: Eye level (Y+1 or Y+2 from floor)

Common Mistakes

Furniture in floor: Always scan first, place ON floor_placement_y
Wrong facing: Stairs face where player looks when sitting
Missing states: Always specify [type=bottom] for slabs
Floating furniture: Ensure solid block beneath
Cramped layout: Leave walking space between items

Decorative Details

Rugs

{"a": [X, Y, Z], "p": {"C": "red_carpet"}, "l": [[0, "C*5|C*5|C*5"]]}

Potted Plants

{"a": [X, Y, Z], "p": {"P": "potted_fern"}, "l": [[0, "P"]]}

Options: potted_oak_sapling, potted_fern, potted_bamboo, potted_cactus, potted_red_tulip, potted_azure_bluet

Picture Frame

{"a": [X, Y, Z], "p": {"F": "item_frame[facing=south]"}, "l": [[0, "F"]]}

Flower Vase

{"a": [X, Y, Z], "p": {"P": "flower_pot", "F": "potted_poppy"}, "l": [[0, "F"]]}

placing-furniture