Minecraft WorldEdit Operations Skill

Scope and Positioning

This skill is for operating WorldEdit on live or staging servers.
It is not for writing plugin code that integrates with WorldEdit APIs.

Routing Boundaries

Use when: the task is command-driven in-world editing with WorldEdit (selections, transforms, schematics, terrain shaping, rollback-safe workflows).
Do not use when: the task is Java plugin implementation (minecraft-plugin-dev).
Do not use when: the task is broad server deployment/tuning/proxy/backup strategy (minecraft-server-admin).
Do not use when: the task is EssentialsX command/economy/moderation workflows (minecraft-essentials-ops).

Platform and Setup Notes

WorldEdit is commonly used on:

Paper/Purpur/Folia servers via WorldEdit plugin
Fabric/NeoForge via mod variants

Operational best practice:

Apply large edits on staging or during maintenance windows.
Keep automatic backups before major region operations.
Use conservative selection + mask constraints before destructive commands.

Support Assets

Read references/safety-checklists.md before large pastes, destructive replacements, or any edit where rollback discipline matters more than speed.

Core Selection Workflow

Selection modes

Most common cuboid flow:

//wand
//pos1
//pos2
//size

Fast alternatives:

//hpos1
//hpos2
//chunk
//expand 20 up
//expand 20 down

Selection safety checks:

always run //size before //set, //replace, or //paste
use //distr to preview block composition before replacement

Region Operations

High-frequency operations

//set stone
//replace stone andesite
//replace water air
//walls stone_bricks
//overlay grass_block
//smooth 3

Masks and filtered replacements

Use masks to constrain scope:

//gmask #natural
//replace grass_block dirt
//gmask

Single-command mask approach:

//replace #stone !air
//replace !#leaves air

Pattern examples:

//set 70%stone,20%andesite,10%cobblestone
//replace dirt 60%coarse_dirt,40%podzol

Clipboard and Schematic Workflows

Clipboard basics

//copy
//rotate 90
//flip east
//paste -a

Use -a when you want to skip air blocks during paste.

Schematic workflow

//schem save spawn-hub-v3
//schem list
//schem load spawn-hub-v3
//paste -a

Operational guidance:

use versioned names (arena-mid-2026-03-27)
keep read-only archive copies for rollback
pair each major paste with an immediate backup checkpoint

Brushes and Terraforming

Practical brush setup

//brush sphere stone 4
//brush smooth 3
//brush raise 2
//brush lower 2
//mask #natural

Reset brush:

//none

Terraforming safety:

start with small radius (3-5) and iterate
keep masks active to avoid damaging structures
run periodic //undo checkpoints during long sessions

Undo, History, and Safety

History commands

//undo
//undo 5
//redo
//clearhistory

Safety policy for production operations:

Create backup checkpoint.
Perform one logical batch of edits.
Validate with visual walkthrough.
Continue or //undo immediately.

Do not chain many destructive edits without intermediate verification.

Practical Runbooks

Runbook: Spawn Editing Refresh

Select spawn zone and run //size.
Snapshot:

//copy
//schem save spawn-before-refresh

Apply constrained replacements and overlays.
Smooth terrain edges:

//smooth 2

Validate spawn safety (voids, lighting, navigation).
Save final state:

//schem save spawn-after-refresh

Runbook: Arena Reset Between Matches

Keep a pristine arena schematic.
After each match:

//schem load arena-pristine
//paste -a

Rebuild only arena boundary if needed.
Validate command blocks/signals associated with arena logic.

Runbook: Block Cleanup (Lag and Visual Noise)

Typical cleanup targets:

dropped scaffolding builds
accidental fluid spread
excessive leaf/log leftovers

Example cleanup sequence:

//replace lava air
//replace water air
//replace #leaves air

Always scope with selection/mask first to avoid map-wide accidental edits.

Runbook: Path Shaping and Terrain Blend

Select corridor/path footprint.
Build mixed surface:

//set 50%dirt_path,30%coarse_dirt,20%gravel

Blend edges with low-radius smooth brush.
Add retaining borders (stone_bricks, andesite) where elevation changes.

Operational Guardrails

Never run broad replacements from global/world scope.
Confirm selection size before every destructive command.
Keep a restoration schematic for each major build zone.
Coordinate edits with other staff to avoid overlapping operations.
Validate WorldEdit limits/permissions by role to prevent accidental mass edits.

minecraft-worldedit-ops