placing-furniture

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Placing Furniture

放置家具

Critical: SCAN BEFORE PLACING

重要提示：放置前务必扫描

Avoid furniture embedded in floor!

python

undefined

避免家具嵌入地板中！

python

undefined

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).


**常见错误**：地板在Y=64处，家具放在Y=64会导致嵌入地板！请放在Y=65（地板上方）。

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

请查看本技能文件夹中的furniture_catalog.md获取80余种现成原理图：

类别	物品
坐具	椅子、扶手椅、长凳、凳子、沙发、王座
桌子	餐桌、咖啡桌、书桌、厨房操作台
卧室家具	床、床头柜、衣柜、梳妆台、高低床
储物家具	书架、柜子、橱柜、桶架
灯具	落地灯、吊灯、壁灯、隐藏式光源
厨房家具	水槽、炉灶、冰箱、操作台
浴室家具	马桶、浴缸、淋浴间、镜子
客厅家具	电视、壁炉、钢琴、地毯
办公家具	电脑、文件柜、办公椅
户外家具	烤架、露台桌、喷泉、邮箱

Quick Placement Examples

快速放置示例

Armchair

扶手椅

json

{"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"]]}

json

{"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)

餐桌（2x3）

json

{"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"]]}

json

{"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

落地灯

json

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

json

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

Hanging Chandelier

悬挂式吊灯

json

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

json

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

Kitchen Sink

厨房水槽

json

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

json

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

Toilet

马桶

json

{"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"]]}

json

{"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

简易壁炉

json

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

json

{"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

工作流程

python

undefined

python

undefined

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" )

undefined

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

undefined

Room Layouts

房间布局

Bedroom (5x6)

卧室（5x6）

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

床靠墙放置（床头贴墙）
床头柜置于床头旁
衣柜放在对面墙
灯具放在床头柜上
地毯铺在床边

Living Room (7x9)

客厅（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)

餐厅（7x9）

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

桌子居中放置
椅子围绕桌子摆放（朝向内侧）
吊灯置于桌子上方
柜子/餐边柜靠墙放置

Kitchen (5x7)

厨房（5x7）

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

操作台沿墙布置（L型或U型）
炉灶嵌入操作台
带杠杆龙头的水槽
冰箱放在角落
小桌子或岛台

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)

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

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

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

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

Lanterns

灯笼

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

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

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

放置家具时，请考虑其朝向：

朝向	说明
north	使用时玩家面朝北
south	使用时玩家面朝南
east	使用时玩家面朝东
west	使用时玩家面朝西

楼梯作为椅子：

facing

= 玩家坐下时的面朝方向 门/箱子：

facing

= 它们的开启方向

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)

桌子：周围留1格空间供移动
椅子：紧靠桌子边缘放置
床：通行侧留1格空间
走道：最小宽度为2格
天花板灯具：每4-5格放置一个以保证均匀照明
墙面装饰：置于视线高度（地板上方Y+1或Y+2处）

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

家具嵌入地板：务必先扫描，放在floor_placement_y指定的位置
朝向错误：楼梯的朝向为玩家坐下时的面朝方向
缺少状态参数：台阶务必指定
```
[type=bottom]
```
浮空家具：确保下方有实心方块支撑
布局拥挤：物品之间留出通行空间

Decorative Details

装饰细节

Rugs

地毯

json

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

json

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

Potted Plants

盆栽

json

{"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

json

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

可选种类：

potted_oak_sapling

、

potted_fern

、

potted_bamboo

、

potted_cactus

、

potted_red_tulip

、

potted_azure_bluet

Picture Frame

画框

json

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

json

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

Flower Vase

花瓶

json

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

json

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