Skip to main content
skill CX Codex

minecraft-worldedit-ops — Claude Code skill: what it does

minecraft-worldedit-ops is a Claude Code skill for safe WorldEdit command sequences in Minecraft 26.x and 1.21.x. It covers selections, masks, schematics, brushes, terrain shaping and rollback.

MIT 201 installs ★ 211 updated 2026-10-30

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add Jahrome907/minecraft-agent-skills --skill minecraft-worldedit-ops -a claude-code
Open on GitHub

What minecraft-worldedit-ops does

The skill walks through WorldEdit's command flow: //wand, //pos1///pos2 and //size for region selection, //replace and //set with masks and weighted patterns like 70%stone,20%andesite,10%cobblestone, plus //copy, //schem save/load, //paste -n for preview-before-paste, and /brush for terrain brushes. It also packages runbooks for spawn refreshes, arena resets between matches, cleanup of lag-causing blocks and path shaping with mixed surface materials.

The skill stays scoped to live command-driven editing, not plugin code against the WorldEdit API — that work routes to separate skills from the same author (minecraft-plugin-dev, minecraft-server-admin, minecraft-essentials-ops). Before large pastes or destructive replacements it points to references/safety-checklists.md and insists on matching the flags between a //paste -n preview and the real paste, since mismatched flags make the preview misleading.

Picking the right WorldEdit build means matching the exact server version and loader on the official downloads page, and checking Folia support separately rather than assuming it from Paper compatibility.

What it helps with

  • select a region and verify its size before replacing blocks
  • filter block replacement with masks and weighted patterns
  • save and preview-paste a schematic with //paste -n
  • undo a brush-based terrain edit with //undo
  • reset an arena to its pristine state between matches

Example prompts for the agent

  • Select the spawn zone, save //schem save spawn-before-refresh, then smooth edges with //smooth 2
  • Reset the arena by loading //schem load arena-pristine and previewing with //paste -n -o
  • Clean up spilled lava and water in the current selection using //replace lava air and //replace water air

How to install minecraft-worldedit-ops

1Skills CLI (Vercel)

npx skills add Jahrome907/minecraft-agent-skills --skill minecraft-worldedit-ops -a claude-code

2Manually: put the files in place

~/.claude/skills/minecraft-worldedit-ops/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/minecraft-worldedit-ops/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about minecraft-worldedit-ops

How do I install minecraft-worldedit-ops in Claude Code?

Run npx skills add Jahrome907/minecraft-agent-skills --skill minecraft-worldedit-ops -a claude-code; the skill is then placed at ~/.claude/skills/minecraft-worldedit-ops/SKILL.md.

What does minecraft-worldedit-ops do?

It sequences WorldEdit commands for selections, masked replacements, schematic handling and brush-based terrain shaping, with preview and backup steps around destructive edits.

How does minecraft-worldedit-ops differ from the plugin-dev skill?

This skill covers live, command-driven world editing, while writing Java code that integrates with the WorldEdit API belongs to the separate minecraft-plugin-dev skill.

Source text

SKILL.md · MIT
---
name: minecraft-worldedit-ops
description: "Operate WorldEdit safely for Minecraft 26.x and 1.21.x selections, region edits, masks, schematics, brushes, terrain shaping, and rollback. Use for command-driven world editing, not plugin development or general server administration."
---

# 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 servers via WorldEdit plugin
- Fabric/NeoForge via mod variants

Operational best practice:
1. Apply large edits on staging or during maintenance windows.
2. Keep automatic backups before major region operations.
3. Use conservative selection + mask constraints before destructive commands.

Select the build listed for the exact server version and loader on the
[official downloads page](https://enginehub.org/worldedit#downloads). Verify
Folia support separately; do not infer it from Paper compatibility. Stage-test
the selected build before using it on production worlds.

## References

- 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:

```text
//wand
//pos1
//pos2
//size
```

Fast alternatives:

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

Selection safety checks:
- always run `//size` before `//set` or `//replace`
- before `//paste`, preview its destination with `//paste -n` using the same
  placement flags planned for the real paste (for example, `//paste -n -a` or
  `//paste -n -o`), then run `//size` and inspect the selected destination
- use `//distr` to preview block composition before replacement

---

## Region Operations

### High-frequency operations

```text
//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:

```text
//gmask #existing
//replace grass_block dirt
//gmask
```

Single-command mask approach:

```text
//replace stone,andesite,diorite,granite smooth_stone
//replace ##leaves air
```

Pattern examples:

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

---

## Clipboard and Schematic Workflows

### Clipboard basics

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

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

### Schematic workflow

```text
//schem save spawn-hub-v3
//schem list
//schem load spawn-hub-v3
//paste -n -a
//size
//paste -a
```

Operational guidance:
- use versioned names (`arena-mid-2026-03-27`)
- keep read-only archive copies for rollback
- `-n` changes the selection to the planned destination without placing blocks;
  keep `-a`, `-o`, and any other placement flags aligned between preview and
  actual paste
- pair each major paste with an immediate backup checkpoint

---

## Brushes and Terraforming

### Practical brush setup

```text
/brush sphere stone 4
/brush smooth 3
/brush raise sphere 2
/brush lower sphere 2
/mask #existing
```

Reset brush:

```text
/brush none
```

Terraforming safety:
- start with small radius (3-5) and iterate
- keep masks active to avoid damaging structures
- save periodic schematic or backup checkpoints; `//undo` reverts an edit

---

## Undo, History, and Safety

### History commands

```text
//undo
//undo 5
//redo
```

Safety policy for production operations:
1. Create backup checkpoint.
2. Perform one logical batch of edits.
3. Validate with visual walkthrough.
4. 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:

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

- Apply constrained replacements and overlays.
- Smooth terrain edges:

```text
//smooth 2
```

- Validate spawn safety (voids, lighting, navigation).
- Reselect the edited area if needed, then copy its final state before saving:

```text
//copy
//schem save spawn-after-refresh
```

## Runbook: Arena Reset Between Matches

- Keep a pristine arena schematic with its original placement recorded.
- After each match:

```text
//schem load arena-pristine
//paste -n -o
//size
//paste -o
```

- Inspect the selected destination after the preview, then paste with the same
  `-o` origin flag. Include air to remove player-added blocks; `-a` would leave
  those blocks behind. Entity and biome restoration require intentional
  copy/paste flags and separate verification.
- 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:

```text
//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:

```text
//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

- https://worldedit.enginehub.org/en/latest/commands/
- https://worldedit.enginehub.org/en/latest/
- https://worldedit.enginehub.org/en/latest/usage/
- https://worldedit.enginehub.org/en/latest/usage/regions/selections/
- https://worldedit.enginehub.org/en/latest/usage/general/masks/
- https://worldedit.enginehub.org/en/latest/usage/clipboard/
- https://worldedit.enginehub.org/en/latest/usage/tools/brushes/

© Jahrome907 · MIT · Jahrome907/minecraft-agent-skills

Similar skills

All skills for Game dev and 3D: Unity, Unreal, Godot, Blender →

From the same set13

The whole set →
minecraft-server-admin minecraft-server-admin runs the infrastructure side of Minecraft Java servers: Paper, Purpur, Folia, Velocity, Fabric, NeoForge. Useful when TPS drops or a proxy blocks logins. CX Codex +1 279installs minecraft-world-generation minecraft-world-generation is a Claude Code skill for building and debugging Minecraft world generation in datapacks, NeoForge, or Fabric. It activates for biome, dimension, structure, and worldgen registration tasks. CX Codex +1 269installs minecraft-plugin-dev minecraft-plugin-dev helps build, change, and debug Minecraft server plugins for Paper and Bukkit-derived servers. Useful for JavaPlugin APIs, events, commands, and configuration. CX Codex +1 267installs minecraft-multiloader minecraft-multiloader is a Claude Code skill that builds and maintains Architectury Minecraft mods for 26.x and 1.21.x across NeoForge and Fabric. It runs when both loaders need release artifacts. CX Codex +1 247installs minecraft-commands-scripting minecraft-commands-scripting writes and debugs Minecraft Java 26.x and 1.21.x commands, execute chains, scoreboards, and RCON scripts. Targets command logic directly without generating full datapack folder structures. CX Codex +1 241installs minecraft-ci-release minecraft-ci-release sets up CI and release plumbing for Minecraft mods and Paper plugins: workflow files, artifacts, versions, tags, GitHub Releases. CX Codex +1 238installs minecraft-imagegen minecraft-imagegen is a Claude Code skill for creating and editing Minecraft raster images. It handles pack icons, banners, texture concepts, and UI mockups when the requested asset is bitmap artwork. CX Codex +1 213installs minecraft-essentials-ops minecraft-essentials-ops guides administration of EssentialsX on Paper and Spigot Minecraft servers across version families 26.x and 1.21.x. CX Codex +1 185installs

Project sponsors

Companies that keep this analytics open