using-worldedit
Using WorldEdit
When to Use WorldEdit vs Schematics
| Task | Use WorldEdit | Use build_schematic |
|---|---|---|
| Flatten terrain | ✅ //set grass |
|
| Fill large area | ✅ //set stone |
|
| Spheres, cylinders | ✅ //sphere, //cyl |
|
| Copy/paste | ✅ //copy, //paste |
|
| Terrain smoothing | ✅ //smooth |
|
| Pattern fills | ✅ 50%stone,50%cobble |
|
| Structures with doors | ✅ | |
| Stairs, oriented blocks | ✅ | |
| Fine detail work | ✅ | |
| Precise block states | ✅ |
Rule of thumb: WorldEdit for bulk/terrain, Schematics for detailed structures.
WorldEdit via Client Bridge
Commands execute as the local player through the Fabric client bridge.
Key Rules:
- ✅ Use
//prefix for WorldEdit commands - ✅ Comma-separated coordinates:
//pos1 100,64,200 - ❌ Never use
execute aswrappers - ⛔ NEVER teleport the player
Selection Commands
//pos1 100,64,200 # First corner
//pos2 120,80,220 # Second corner
//expand 5 up # Expand up
//expand vert # Full height
//contract 3 north # Shrink from north
//shift 10 east # Move selection
//inset 2 # Shrink all sides
//outset 3 # Expand all sides
//sel cuboid|sphere|cyl|poly # Selection mode
//size # Show size
Region Commands
//set stone # Fill selection
//set 50%stone,50%cobblestone # Random mix
//replace dirt grass_block # Replace blocks
//walls stone # Only walls
//faces stone # All 6 faces
//hollow # Remove interior
//move 10 up # Move selection
//stack 5 north # Stack copies
Generation Commands
//sphere stone 10 # Solid sphere r=10
//hsphere stone 10 # Hollow sphere
//cyl stone 5 10 # Cylinder r=5 h=10
//hcyl stone 5 10 # Hollow cylinder
//pyramid stone 15 # Pyramid
//generate stone (x*x+y*y+z*z)<100 # Expression
Terrain Commands
//smooth 3 # Smooth terrain
//naturalize # Add dirt/stone layers
//flora 10 # Add flowers/grass
//forest 20 oak # Generate forest
//drain 10 # Remove water/lava
//fixwater 10 # Fix water flow
Clipboard Commands
//copy # Copy selection
//cut # Copy + clear
//paste # Paste at player
//paste -a # Paste, skip air
//rotate 90 # Rotate clipboard
//flip north # Mirror clipboard
Patterns
stone # Single block
50%stone,50%cobblestone # Random percentage
oak_stairs[facing=north] # With block state
Masks
-m stone # Only affect stone
-m !air # Exclude air
-m stone,cobble # Multiple blocks
Common Workflows
Terrain Prep for Building
build(commands=[
"//pos1 100,60,200",
"//pos2 150,70,250",
"//set grass_block",
"//smooth 2"
], description="Flatten area")
Create Platform
build(commands=[
"//pos1 100,64,200",
"//pos2 120,64,220",
"//set stone_bricks"
], description="Stone platform")
Forest Generation
//pos1 100,64,200
//pos2 200,64,300
//forest oak 5
Large Sphere
//pos1 95,70,195 # Center - radius
//pos2 115,90,215 # Center + radius
//sphere stone 10
Using build() for WorldEdit
build(commands=[
"//pos1 100,64,200",
"//pos2 120,80,220",
"//set stone_bricks",
"//walls oak_planks",
"//hollow"
], description="Basic shell")
⛔ Commands That DON'T Work via RCON
Brushes (require player click):
❌ //br sphere stone 5
❌ //br cyl stone 3 1
❌ //brush smooth 3
Tool bindings (require held item):
❌ //tool tree
❌ //tool info
Alternatives for trees:
✅ //forest oak 5 # Selection-based
✅ //forestgen 50 oak 5 # Standalone
History
//undo # Undo last
//redo # Redo
//undo 5 # Undo 5 actions
After WorldEdit: Add Details with Schematics
Typical workflow:
- Use WorldEdit to prepare terrain and create bulk structure
- Use
build_schematic()to add doors, stairs, furniture, details
# Step 1: WorldEdit for bulk
build(commands=[
"//pos1 100,64,200",
"//pos2 120,68,220",
"//set oak_planks",
"//hollow"
], description="House shell")
# Step 2: Schematic for details
build_schematic(
schematic={
"anchor": [100, 64, 220], # South wall
"palette": {
"Dl": "oak_door[facing=south,half=lower]",
"Du": "oak_door[facing=south,half=upper]",
"W": "oak_planks"
},
"layers": [
{"y": 1, "grid": [["W", "Dl", "W"]]},
{"y": 2, "grid": [["W", "Du", "W"]]}
]
},
description="Add door"
)
More from amenti-labs/vibecraft
placing-furniture
Places furniture and decorates Minecraft interiors using JSON schematics. Use when furnishing rooms, placing tables, chairs, beds, lamps, decorations, or designing interior spaces. Reference furniture_catalog.md for 80+ ready-to-use designs.
19creating-shapes
Creates procedural and organic shapes in Minecraft using VibeCraft MCP tools. Use when building spheres, domes, cylinders, pyramids, torus, arches, curves, spirals, organic shapes, statues, or any complex geometry that requires procedural generation.
4choosing-materials
Chooses Minecraft block materials, color palettes, and textures using VibeCraft MCP tools. Use when selecting materials for builds, creating color schemes, matching architectural styles, or asking about block combinations and palettes.
4building-with-schematics
PRIMARY BUILDING METHOD - Use for ALL construction tasks. Build structures using declarative JSON schematics with 2D layer grids. Describe WHAT to build, the server handles HOW. Supports COMPACT FORMAT (70% fewer tokens) with run-length encoding. Use this instead of WorldEdit commands for reliable, predictable builds.
4building-structures
Builds Minecraft structures using VibeCraft MCP tools. Use when building houses, castles, towers, cottages, temples, or any architectural structure. Works with build_schematic for precise control. Handles room dimensions, floor placement, wall construction, roofing, and architectural style matching.
4generating-terrain
Generates Minecraft terrain and landscapes using VibeCraft MCP tools. Use when creating hills, mountains, valleys, rivers, caves, cliffs, or natural terrain features. Handles procedural generation, noise functions, and terrain texturing.
3