minecraft-agent-skills: Skill for Claude Code

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

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

Fast alternatives:

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