| name | minecraft-worldedit-ops |
| description | Operate WorldEdit safely and efficiently for Minecraft 1.21.x server build/admin workflows. Covers selection mechanics, region operations, masks and patterns, clipboards and schematics, brushes and terraforming, undo/history safety, and practical runbooks for spawn edits, arena resets, block cleanup, and path shaping. Use for command-driven world operations, not plugin development. |
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.
Compatibility note: stable WorldEdit 7.4.x targets current 1.21.x servers.
For Minecraft 26.1.x, check the WorldEdit release notes first and stage-test any
beta or pre-release build before using it on production worlds.
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 #existing
//replace grass_block dirt
//gmask
Single-command mask approach:
//replace stone,andesite,diorite,granite smooth_stone
//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 #existing
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
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.
Run //clearhistory only after the edit is accepted, a backup or schematic
checkpoint exists, and the rollback window is closed.
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.
References
