🏗️ WorldEdit for Endstone - Builder's Edition

A comprehensive WorldEdit plugin for Endstone with Builder's Menu, Build Areas, Blueprints, Zones, and Advanced Editing Tools

📋 Table of Contents

Features
Installation
Quick Start
How To Use
Configuration
Commands
Permissions
Usage Examples
Changelog

✨ Features

🎨 Core WorldEdit Functionality

Selection Tools - Wand-based or command-based region selection
Smooth Tool - Terrain smoothing with wooden hoe (sneak to configure, click to smooth at crosshair)
Shape Tool - Interactive shape spawning with wooden shovel (sneak to configure, click to spawn at crosshair)
Block Operations - Set, replace, walls, overlay, and more
Clipboard System - Copy, cut, and paste structures with rotation, flip, and offset support
History Management - Unlimited undo/redo support
Shape Generation - Spheres, cylinders, pyramids, squares (solid & hollow)
Schematic Support - Save/load .schem files with Java Edition compatibility
Schematic Preview - Visualize schematic placement with particle outlines before loading
Advanced Paste - Paste with rotation (90°, 180°, 270°), flip (X/Y/Z), and custom offsets
Async Operations - Large edits processed in chunks to prevent lag

🏗️ Builder's Menu System (NEW!)

Interactive Menu - /builder or /bmenu shows status, areas, and commands at a glance
Area Discovery - /myareas lists all accessible build zones
Real-time Info - /areainfo displays current location status
UI-Based Operations - Easy-to-use forms for selection, clipboard, and paste operations
Quick Access - All WorldEdit features accessible through intuitive menus

🔐 Build Area Management (NEW!)

Designated Build Zones - Operators create cuboid regions for builders
Permission Control - Non-operators restricted to assigned areas
Auto Creative Mode - Automatic gamemode switching on entry/exit
Multi-Builder Support - Assign multiple players per area
Area Notifications - Real-time messages when crossing boundaries
Teleportation - Quick travel to managed build areas

📘 Blueprint System (NEW!)

Save & Load - Save clipboard contents as reusable blueprints
Personal Library - Each player has their own blueprint collection
Shared Blueprints - Share blueprints with other players
Compression - Efficient storage with palette mapping and RLE compression
Metadata - Track author, creation date, and descriptions

🌍 Builder Zones (NEW!)

Temporary Zones - Create time-limited build areas
Zone Management - Operators can create and manage builder zones
Flexible Sizing - Configurable radius and duration
Zone Integration - Works seamlessly with build area system

📦 Installation

Prerequisites

Endstone server (version 0.5.0 or higher with Form API support)
Python 3.9+
nbtlib package (auto-installed with plugin)

Steps

Build the Plugin
```
pip install build
python -m build
```
This creates dist/endstone_worldedit-3.2.1-py3-none-any.whl

Install to Server

# Copy the .whl file to your server's plugins folder
cp dist/endstone_worldedit-3.2.1-py3-none-any.whl /path/to/server/plugins/

Restart Server

# Start or restart your Endstone server
# The plugin will auto-generate config files on first load

Verify Installation

Check server logs for: "WorldEditPlugin has been enabled!"

🚀 Quick Start

For Server Operators

Set up your first build area:

# 1. Get the selection wand
/wand

# 2. Select the area (left-click pos1, right-click pos2)
#    Or use commands:
/pos1
/pos2

# 3. Create the build area
/area create creative_zone

# 4. Add builders
/area addbuilder creative_zone Steve
/area addbuilder creative_zone Alex

# 5. Done! Builders can now use WorldEdit in this area

For Builders

Start building in your assigned areas:

# 1. Check where you can build
/myareas

# 2. Open the builder's menu
/bmenu

# 3. Get your wand
/wand

# 4. Go to your build area (you'll auto-switch to creative mode)

# 5. Make a selection and start editing!
/pos1
/pos2
/set stone

📖 How To Use

This section provides comprehensive guides for using all the tools, menus, and commands in WorldEdit.

🔨 Tools Guide

WorldEdit provides two main tools that make editing easier and more intuitive.

Selection Wand (Wooden Axe)

The selection wand is used to select regions for editing.

How to get it:

/wand          # Get the selection wand
# OR
/w             # Short alias

How to use it:

Left-Click a block → Sets Position 1 (first corner)
Right-Click a block → Sets Position 2 (opposite corner)
You'll see particles showing your selection
The selection forms a cuboid (rectangular box) between the two points

Example workflow:

1. Type /wand to get the wooden axe
2. Left-click a block at one corner of your desired area
   → Message: "Position 1 set to (100, 64, 200)"
3. Right-click a block at the opposite corner
   → Message: "Position 2 set to (150, 80, 250)"
4. You now have a 51x17x51 block selection!
5. Use any editing command: /set stone, /copy, etc.

Tips:

You can also set positions with commands: /pos1 and /pos2 (uses your current location)
Toggle selection particles on/off: /sel toggle
Clear your selection: /sel clear
Check selection info: /sel

Smooth Tool (Wooden Hoe)

The smooth tool is used to smooth terrain and remove rough edges at your crosshair location.

How to get it:

/smoothtool    # Get the smooth tool
# OR
/st            # Short alias

How to use it:

Step 1: Configure (Sneak + Right-Click)

Hold the wooden hoe
Sneak (crouch) and right-click
Configuration menu opens with these options:
- Radius (1-20): Area size to smooth at crosshair
- Aggressiveness: How strong the smoothing is
  - Gentle (1 iteration) - Very subtle
  - Light (2 iterations) - Slight smoothing
  - Medium (3 iterations) - Balanced ⭐ Recommended
  - Strong (5 iterations) - Heavy smoothing
  - Very Strong (7 iterations) - Very smooth
  - Extreme (10 iterations) - Nearly flat
- Use Current Selection: Toggle to use wand selection instead of radius
Submit your settings
You'll see: "✓ Smooth Tool Configured!"

Step 2: Execute (Right-Click while Standing)

Hold the wooden hoe
Look at the terrain you want to smooth (aim with crosshair)
Right-click (while standing, not sneaking)
Terrain smooths instantly at your crosshair location!
No menu popup - just smooth!

Example workflow:

# First time setup
1. /smoothtool                    # Get the tool
2. Sneak + Right-click            # Configure
   - Radius: 10
   - Aggressiveness: Medium
   - Use Selection: OFF
3. Submit                         # Settings saved

# Now use it repeatedly
4. Look at rough terrain          # Aim with crosshair
5. Right-click (standing)         # Smooths at crosshair!
6. Look at another spot
7. Right-click again              # Smooths there too!
8. Keep smoothing different areas by aiming and clicking!

# Change settings anytime
9. Sneak + Right-click            # Menu shows current settings
10. Change to: Radius 5, Strong
11. Submit
12. Right-click (standing)        # Uses new settings

Two modes:

Radius Mode (Default):

Creates a cube at your crosshair based on radius
Perfect for smoothing specific terrain spots
Precise targeting with crosshair

Selection Mode:

Uses your wand selection (pos1/pos2)
Perfect for smoothing large specific areas
More precise control

Tips:

Start with "Medium" aggressiveness and adjust from there
Larger radius = more area smoothed at once
You can undo smoothing with /undo
Settings are saved per player - each player has their own configuration
Aim carefully - the smooth happens exactly where you're looking!

Shape Tool (Wooden Shovel)

The shape tool allows you to spawn configured shapes at your crosshair location.

How to get it:

/shapetool     # Get the shape tool
# OR
/sht           # Short alias

How to use it:

Step 1: Configure (Sneak + Right-Click)

Hold the wooden shovel
Sneak (crouch) and right-click
Shape selection menu opens with these options:
- Sphere - Solid sphere
- Hollow Sphere - Hollow sphere shell
- Cylinder - Solid cylinder
- Hollow Cylinder - Hollow cylinder shell
- Square - Solid rectangular prism (cuboid)
- Hollow Square - Hollow box
- Pyramid - Solid pyramid
- Hollow Pyramid - Hollow pyramid shell
Select a shape type
Configure the shape:
- Block Type: What block to build with (e.g., stone, glass)
- Size parameters: Radius, height, width, etc. (depends on shape)
Submit your settings
You'll see: "Shape tool configured: [Shape Type]"

Step 2: Spawn Shape (Right-Click while Standing)

Hold the wooden shovel
Look where you want to spawn the shape (aim with crosshair)
Right-click (while standing, not sneaking)
Shape spawns instantly at your crosshair location!

Example workflow:

# Create a glass sphere
1. /shapetool                     # Get the tool
2. Sneak + Right-click            # Open menu
3. Select "Sphere"                # Choose shape type
4. Configure:
   - Block Type: glass
   - Radius: 10
5. Submit                         # Settings saved

# Spawn it
6. Look at where you want it     # Aim with crosshair
7. Right-click (standing)         # Spawns glass sphere!

# Spawn more in different locations
8. Look at another spot
9. Right-click                    # Another sphere!
10. Keep spawning by aiming and clicking!

# Change to a different shape
11. Sneak + Right-click           # Open menu
12. Select "Hollow Cylinder"      # New shape
13. Configure:
    - Block Type: stone_bricks
    - Radius: 5
    - Height: 20
14. Submit
15. Right-click (standing)        # Spawns cylinder!

Available Shapes:

Shape	Parameters	Description
Sphere	Block, Radius	Solid sphere centered at crosshair
Hollow Sphere	Block, Radius	Hollow sphere shell
Cylinder	Block, Radius, Height	Solid cylinder (vertical)
Hollow Cylinder	Block, Radius, Height	Hollow cylinder shell
Square	Block, Width, Height, Length	Solid rectangular prism
Hollow Square	Block, Width, Height, Length	Hollow box
Pyramid	Block, Size	Solid pyramid
Hollow Pyramid	Block, Size	Hollow pyramid shell

Tips:

Shapes spawn at your crosshair - aim carefully!
You can undo shape placement with /undo
Settings are saved per player - each player has their own configuration
Great for quickly building structures without selections
Combine different shapes to create complex structures

📱 Menu System

WorldEdit includes an interactive menu system for easy access to all features.

Main Builder Menu

How to open:

/builder       # Main command
# OR
/bmenu         # Alternative
# OR
/b             # Short alias

What you'll see:

The main menu shows:

Your current build area (if you're in one)
Your selection status (pos1/pos2)
Quick access buttons to all features

Menu Categories:

Selection Tools
- Set Position 1 (at your location)
- Set Position 2 (at your location)
- Get Selection Wand (wooden axe)
- Get Smooth Tool (wooden hoe)
- Clear Selection
Clipboard
- Copy (copy selection to clipboard)
- Cut (cut selection to clipboard)
- Paste (paste clipboard at your location)
- Advanced Paste (with rotation, flip, offset options)
Editing
- Set Blocks (fill selection with a block)
- Replace Blocks (replace one block type with another)
- Walls (create walls around selection)
- Overlay (place blocks on top surface)
Transform
- Rotate 90° (rotate selection clockwise)
- Rotate 180° (rotate selection 180 degrees)
- Rotate 270° (rotate selection counter-clockwise)
- Flip X (flip selection left/right)
- Flip Y (flip selection up/down)
- Flip Z (flip selection forward/backward)
Shapes
- Sphere (solid sphere)
- Hollow Sphere
- Cylinder (solid cylinder)
- Hollow Cylinder
- Square (solid rectangular prism)
- Hollow Square (hollow box)
- Pyramid (solid pyramid)
- Hollow Pyramid
Schematics
- Save Schematic (save selection to file)
- Load & Place Schematic (load and paste)
- List Schematics (view all saved schematics)
Build Areas (Operators only)
- Create Build Area (from coordinates)
- Add Builder to Area (grant access)
- List Build Areas
- Manage Areas
Undo/Redo
- Undo Last Action
- Redo Last Action
- Shows number of available undo/redo actions

Example menu workflow:

1. /builder                       # Open menu
2. Click "Selection Tools"        # Opens selection submenu
3. Click "Get Selection Wand"     # Receive wooden axe
4. Close menu and select area with wand
5. /builder                       # Open menu again
6. Click "Editing"                # Opens editing submenu
7. Click "Set Blocks"             # Opens form
8. Enter "stone"                  # Block type
9. Submit                         # Selection fills with stone!

📝 Commands Reference

This section provides detailed command usage with examples.

Selection Commands

Set positions manually:

/pos1          # Set position 1 at your current location
/pos2          # Set position 2 at your current location

# Example:
# Stand at one corner
/pos1          # → "Position 1 set to (100, 64, 200)"
# Walk to opposite corner
/pos2          # → "Position 2 set to (150, 80, 250)"

Check selection:

/sel           # Show selection info
# Output: "Selection: 51x17x51 (44,217 blocks)"

/sel clear     # Clear your selection
/sel toggle    # Toggle selection particles on/off

Editing Commands

Fill selection with blocks:

/set <block>

# Examples:
/set stone                    # Fill with stone
/set glass                    # Fill with glass
/set minecraft:oak_planks     # Full block ID

Replace blocks:

/replace <from_block> <to_block>

# Examples:
/replace dirt grass           # Replace all dirt with grass
/replace stone cobblestone    # Replace stone with cobblestone
/replace air water            # Fill air spaces with water

Create walls:

/walls <block>

# Example:
/walls stone_bricks           # Create walls around selection
# Only places blocks on the outer edges

Overlay blocks:

/overlay <block>

# Example:
/overlay grass                # Place grass on top surface
# Only affects the top layer of blocks

Smooth terrain:

/smooth [iterations]

# Examples:
/smooth                       # Smooth once (gentle)
/smooth 3                     # Smooth 3 times (medium)
/smooth 10                    # Smooth 10 times (extreme)

# Note: Requires a selection first

Transform Commands

Rotate selection:

/rotate <degrees>

# Examples:
/rotate 90                    # Rotate 90° clockwise
/rotate 180                   # Rotate 180°
/rotate 270                   # Rotate 270° clockwise (90° counter-clockwise)
/rotate -90                   # Same as 270°

# Note: Rotates around Y-axis (vertical)
# Selection must be made first

Flip selection:

/flip [x|y|z]

# Examples:
/flip x                       # Flip left/right
/flip y                       # Flip up/down
/flip z                       # Flip forward/backward
/flip                         # Flip along Z-axis (default)

# Note: Flips the selection in place
# Selection must be made first

Example workflow:

1. Select a structure with wand
2. /rotate 90                 # Rotate it 90 degrees
3. /flip x                    # Flip it horizontally
4. /undo                      # Oops, undo the flip
5. /flip z                    # Flip it the other way

Clipboard Commands

Copy selection:

/copy

# Example workflow:
1. Select area with wand
2. /copy                      # → "Copied 1,234 blocks"
3. Walk to new location
4. /paste                     # Paste it there

Cut selection:

/cut

# Example:
1. Select area with wand
2. /cut                       # → "Cut 1,234 blocks" (area becomes air)
3. Walk to new location
4. /paste                     # Paste it there

Paste clipboard:

/paste [options]

# Basic paste:
/paste                        # Paste at your location

# Advanced paste with transformations:
/paste -r 90                  # Paste with 90° rotation
/paste -r 180 -fx             # Paste rotated 180° and flipped on X-axis
/paste -o 5,0,3               # Paste offset by 5 blocks east, 3 blocks south
/paste -r 90 -fx -fz -o 0,10,0  # Combine rotation, flips, and offset

# Options:
#   -r <degrees>    Rotate (0, 90, 180, 270)
#   -fx             Flip on X-axis (East/West)
#   -fy             Flip on Y-axis (Up/Down)
#   -fz             Flip on Z-axis (North/South)
#   -o x,y,z        Offset from current position
#   -a              Include air blocks
#   -e              Paste entities (placeholder)
#   -b              Paste biomes (placeholder)

# Example workflow:
1. /copy or /cut first
2. Walk to where you want to paste
3. /paste -r 90 -o 0,5,0      # Paste rotated 90°, 5 blocks up

Shape Commands

Create spheres:

/sphere <block> <radius>
/hsphere <block> <radius>     # Hollow version

# Examples:
/sphere glass 10              # 10-block radius glass sphere
/hsphere stone 15             # 15-block radius hollow stone sphere

Create cylinders:

/cyl <block> <radius> [height]
/hcyl <block> <radius> [height]   # Hollow version

# Examples:
/cyl stone 5                  # 5-block radius cylinder (default height)
/cyl stone 5 10               # 5-block radius, 10 blocks tall
/hcyl glass 8 20              # Hollow glass cylinder

Create pyramids:

/pyramid <block> <size>
/hpyramid <block> <size>      # Hollow version

# Examples:
/pyramid sandstone 10         # 10-block tall solid pyramid
/hpyramid glass 15            # 15-block tall hollow pyramid

Create squares (rectangular prisms):

Use the menu: /builder → Shapes → Square
Configure width, height, length
Choose solid or hollow

Blueprint Commands

What are blueprints? Blueprints are personal clipboard saves. Unlike schematics (which save selections), blueprints save your clipboard directly. This makes them perfect for:

Saving builds you've copied
Creating a library of reusable structures
Sharing builds with other players (via shared folder)

Save clipboard as blueprint:

/blueprint save <name>
# or
/bp save <name>

# Example:
1. /copy                      # Copy something
2. /blueprint save my_tower   # Save clipboard as blueprint
   → "Blueprint 'my_tower' saved!"
   → "Use /blueprint load my_tower to load it"

Load blueprint:

/blueprint load <name>
# or
/bp load <name>

# Example:
/blueprint load my_tower      # Loads blueprint into clipboard
   → "Blueprint 'my_tower' loaded into clipboard!"
   → "Author: PlayerName"
   → "Use /paste to place it"

List your blueprints:

/blueprint list
# or
/bp list

# Output:
# Your Blueprints (5 total):
#   - my_tower
#   - castle_wall
#   - fountain
#   - bridge
#   - statue
# Use /blueprint load <name> to load a blueprint

Delete blueprint:

/blueprint delete <name>
# or
/bp delete <name>

# Example:
/blueprint delete old_build   # Deletes the blueprint
   → "Blueprint 'old_build' deleted!"

Load shared blueprints:

/blueprint shared list        # List shared blueprints
/blueprint shared load <name> # Load a shared blueprint

# Example:
/blueprint shared list
   → Shared Blueprints (3 total):
   →   - admin_spawn
   →   - event_arena
   →   - shop_template

/blueprint shared load admin_spawn
   → "Shared blueprint 'admin_spawn' loaded!"
   → "Author: AdminName"

Blueprint vs Schematic:

Blueprints: Save clipboard (personal, JSON format, fast)
Schematics: Save selection (NBT format, compatible with other tools)

Schematic Commands

Save selection as schematic:

/schem save <name>

# Example:
1. Select your build with wand
2. /schem save my_house       # Saves to plugins/WorldEdit/schematics/my_house.schem

Preview schematic before loading:

/schem preview <name>

# Example:
/schem preview my_house       # Shows particle outline where it will be placed
# Output:
# Schematic preview enabled for 'my_house'
# Dimensions: 20x15x25 blocks
# Position: (100, 64, 200) to (120, 79, 225)
# Move to adjust position, then use /schem load my_house to place
# Use /schem clearpreview to remove preview

# The preview follows you as you move!
# Golden/cyan particles show exactly where the schematic will be placed
# Walk around to find the perfect spot

Load schematic:

/schem load <name> [-c]

# Direct placement (old behavior):
/schem load my_house          # Loads and places directly at your location

# Load to clipboard (NEW):
/schem load my_house -c       # Loads to clipboard for advanced paste
# Then use /paste with transformations:
/paste -r 90                  # Paste with 90° rotation
/paste -r 180 -fx -o 5,0,0    # Paste rotated, flipped, and offset

# Preview automatically clears after loading

Clear preview:

/schem clearpreview

# Example:
/schem clearpreview           # Removes the particle preview

List schematics:

/schem list

# Output:
# Available schematics:
#   - my_house.schem
#   - tower.schem
#   - bridge.schem

Complete workflow with preview:

# 1. Preview the schematic
/schem preview my_castle

# 2. Walk around - the preview follows you!
#    Golden particles show where it will be placed

# 3. Find the perfect spot

# 4. Load it
/schem load my_castle         # Places exactly where preview showed

# Alternative: Clear preview without loading
/schem clearpreview           # Remove preview if you change your mind

History Commands

Undo/Redo:

/undo          # Undo last action
/redo          # Redo last undone action

# Example:
/set stone     # Fill selection with stone
/undo          # Oops! Undo it
/redo          # Actually, redo it
/undo          # Changed my mind again

Build Area Commands (Operators Only)

Create build area:

# Method 1: Using menu (recommended)
/builder → Build Areas → Create Build Area
# Enter coordinates for corner 1 and corner 2

# Method 2: Using selection
1. Select area with wand
2. /area create <name>

# Example:
/area create spawn_plaza

Manage builders:

/area addbuilder <area_name> <player_name>
/area removebuilder <area_name> <player_name>

# Examples:
/area addbuilder spawn_plaza Steve
/area addbuilder spawn_plaza Alex
/area removebuilder spawn_plaza Steve

List and info:

/area list                    # List all build areas
/area info <name>             # Show area details
/myareas                      # Show areas you can access (all players)
/areainfo                     # Show current area info (all players)

Teleport:

/area tp <name>

# Example:
/area tp spawn_plaza          # Teleport to the area

⚙️ Configuration

The plugin creates plugins/WorldEdit/config.json on first run:

{
    "async-threshold": 5000,
    "particle-type": "minecraft:endrod",
    "particle-density-step": 5,
    "schematic-path": "plugins/WorldEdit/schematics",
    "block_translation_map": {
        "cobblestone_stairs": "stone_stairs",
        "rooted_dirt": "dirt",
        "sugar_cane": "reeds"
    },
    "build_areas": {
        "enabled": true,
        "restrict_non_operators": true,
        "auto_creative_mode": true,
        "show_area_messages": true
    }
}

Configuration Options

Option	Type	Default	Description
`async-threshold`	int	5000	Block count threshold for async processing
`particle-type`	string	`minecraft:endrod`	Particle for selection visualization
`particle-density-step`	int	5	Distance between selection particles
`schematic-path`	string	`plugins/WorldEdit/schematics`	Schematic storage directory
`block_translation_map`	object	{...}	Java→Bedrock block name translations

Build Area Settings

Option	Type	Default	Description
`enabled`	boolean	true	Enable/disable build area system
`restrict_non_operators`	boolean	true	Restrict non-ops to assigned areas only
`auto_creative_mode`	boolean	true	Auto-switch to creative in build areas
`show_area_messages`	boolean	true	Show entry/exit notifications

📝 Commands

🔧 Selection Commands

Command	Aliases	Description	Permission
`/wand`	`/w`	Get the selection wand (wooden axe)	`worldedit.command.wand`
`/smoothtool`	`/st`	Get the smooth tool (wooden hoe)	`worldedit.command.smoothtool`
`/shapetool`	`/sht`	Get the shape tool (wooden shovel)	`worldedit.command.shapetool`
`/pos1`	-	Set position 1 to your location	`worldedit.command.pos1`
`/pos2`	-	Set position 2 to your location	`worldedit.command.pos2`
`/sel`	-	Show selection info	`worldedit.command.sel`
`/sel clear`	`/deselect`	Clear current selection	`worldedit.command.sel`
`/sel toggle`	-	Toggle selection particles	`worldedit.command.sel`

Wand Usage:

Left-Click a block → Set Position 1
Right-Click a block → Set Position 2

Smooth Tool Usage:

Sneak + Right-Click → Configure settings (radius, aggressiveness)
Right-Click (standing) → Execute smooth at crosshair

Shape Tool Usage:

Sneak + Right-Click → Configure shape (type, block, size)
Right-Click (standing) → Spawn shape at crosshair

✏️ Editing Commands

Command	Description	Permission
`/set <block>`	Fill selection with a block	`worldedit.command.set`
`/replace <from> <to>`	Replace blocks in selection	`worldedit.command.replace`
`/walls <block>`	Create walls around selection	`worldedit.command.walls`
`/overlay <block>`	Overlay blocks on top surface	`worldedit.command.overlay`
`/smooth [iterations]`	Smooth terrain in selection	`worldedit.command.smooth`

🔄 Transform Commands

Command	Description	Permission
`/rotate <degrees>`	Rotate selection around Y-axis (90, 180, 270)	`worldedit.command.rotate`
`/flip [x\|y\|z]`	Flip selection along an axis	`worldedit.command.flip`

Transform Notes:

Rotation is around the Y-axis (vertical) in 90-degree increments
Flip axes: X = left/right, Y = up/down, Z = forward/backward
Both commands modify the selection in place
Use /undo to revert if needed

📋 Clipboard Commands

Command	Description	Permission
`/copy`	Copy selection to clipboard	`worldedit.command.copy`
`/cut`	Cut selection to clipboard	`worldedit.command.cut`
`/paste [options]`	Paste clipboard with optional transformations	`worldedit.command.paste`

Paste Options:

-r <degrees> - Rotate (0, 90, 180, 270)
-fx / -fy / -fz - Flip on X/Y/Z axis
-o x,y,z - Offset from current position
-a - Include air blocks
-e - Paste entities (placeholder)
-b - Paste biomes (placeholder)

↩️ History Commands

Command	Description	Permission
`/undo`	Undo last action	`worldedit.command.undo`
`/redo`	Redo last undone action	`worldedit.command.redo`

🔮 Shape Generation Commands

Command	Description	Permission
`/sphere <block> <radius>`	Create solid sphere	`worldedit.command.sphere`
`/hsphere <block> <radius>`	Create hollow sphere	`worldedit.command.hsphere`
`/cyl <block> <radius> [height]`	Create solid cylinder	`worldedit.command.cyl`
`/hcyl <block> <radius> [height]`	Create hollow cylinder	`worldedit.command.hcyl`
`/pyramid <block> <size>`	Create solid pyramid	`worldedit.command.pyramid`
`/hpyramid <block> <size>`	Create hollow pyramid	`worldedit.command.pyramid`

Note: Squares (rectangular prisms) are available through the menu: /builder → Shapes → Square

📦 Blueprint Commands

Command	Description	Permission
`/blueprint save <name>`	Save clipboard as blueprint	`worldedit.command.blueprint`
`/blueprint load <name>`	Load blueprint into clipboard	`worldedit.command.blueprint`
`/blueprint list`	List your blueprints	`worldedit.command.blueprint`
`/blueprint delete <name>`	Delete a blueprint	`worldedit.command.blueprint`
`/blueprint shared list`	List shared blueprints	`worldedit.command.blueprint`
`/blueprint shared load <name>`	Load shared blueprint	`worldedit.command.blueprint`

Aliases: /bp can be used instead of /blueprint

Blueprint Notes:

Blueprints save your clipboard (not selection)
Personal blueprints are stored per-player
Shared blueprints are accessible to all players
Use blueprints for quick save/load of copied structures

💾 Schematic Commands

Command	Description	Permission
`/schem save <name>`	Save selection as schematic	`worldedit.command.schem`
`/schem load <name> [-c]`	Load schematic (use -c for clipboard)	`worldedit.command.schem`
`/schem list`	List available schematics	`worldedit.command.schem`
`/schem preview <name>`	Preview schematic placement with particles	`worldedit.command.schem`
`/schem clearpreview`	Clear active schematic preview	`worldedit.command.schem`

Schematic Loading:

/schem load <name> - Direct placement at your location (old behavior)
/schem load <name> -c - Load to clipboard for advanced paste with transformations
After loading to clipboard, use /paste with rotation, flip, and offset options

Schematic Preview:

Preview shows golden/cyan particles outlining where the schematic will be placed
Preview follows your position as you move - find the perfect spot!
Automatically clears when you load the schematic
Different particle color than selection (easy to distinguish)

🏗️ Build Area Commands (Operators)

Command	Description	Permission
`/area create <name>`	Create build area from selection	`worldedit.admin.area`
`/area delete <name>`	Delete a build area	`worldedit.admin.area`
`/area list`	List all build areas	`worldedit.admin.area`
`/area info <name>`	Show area details	`worldedit.admin.area`
`/area addbuilder <area> <player>`	Grant player access to area	`worldedit.admin.area`
`/area removebuilder <area> <player>`	Remove player access	`worldedit.admin.area`
`/area tp <name>`	Teleport to build area	`worldedit.admin.area`

👷 Builder Menu Commands

Command	Aliases	Description	Permission
`/builder`	`/b`, `/bmenu`, `/buildermenu`	Open interactive builder's menu	None (all players)
`/bmenu`	-	Open interactive builder's menu (legacy)	`worldedit.builder.menu`
`/myareas`	-	List your accessible build areas	`worldedit.builder.menu`
`/areainfo`	-	Show current area information	`worldedit.builder.menu`

Builder Menu Features:

Selection Menu - Set pos1/pos2 with one click
Clipboard Menu - Copy, cut, paste operations
Blueprint Menu - Save and load blueprints
Zone Menu - View and manage builder zones (operators only)
Undo Menu - Quick undo/redo access

🔐 Permissions

Permission Hierarchy

worldedit.*                    # All permissions (operators)
├── worldedit.admin.*          # Admin permissions
│   └── worldedit.admin.area   # Build area management
├── worldedit.builder.*        # Builder permissions
│   └── worldedit.builder.menu # Builder menu access
└── worldedit.command.*        # All command permissions
    ├── worldedit.command.wand
    ├── worldedit.command.smoothtool
    ├── worldedit.command.pos1
    ├── worldedit.command.pos2
    ├── worldedit.command.sel
    ├── worldedit.command.set
    ├── worldedit.command.replace
    ├── worldedit.command.smooth
    ├── worldedit.command.rotate
    ├── worldedit.command.flip
    ├── worldedit.command.copy
    ├── worldedit.command.cut
    ├── worldedit.command.paste
    ├── worldedit.command.undo
    ├── worldedit.command.redo
    ├── worldedit.command.walls
    ├── worldedit.command.overlay
    ├── worldedit.command.sphere
    ├── worldedit.command.hsphere
    ├── worldedit.command.cyl
    ├── worldedit.command.hcyl
    ├── worldedit.command.pyramid
    ├── worldedit.command.schem
    └── worldedit.command.blueprint

Default Permissions

Operators: All permissions (worldedit.*)
Non-Operators: No permissions by default (must be granted individually)

Recommended Permission Sets

For Trusted Builders:

permissions:
  - worldedit.builder.menu
  - worldedit.command.wand
  - worldedit.command.pos1
  - worldedit.command.pos2
  - worldedit.command.sel
  - worldedit.command.set
  - worldedit.command.replace
  - worldedit.command.copy
  - worldedit.command.paste
  - worldedit.command.undo
  - worldedit.command.redo

For Advanced Builders:

permissions:
  - worldedit.builder.menu
  - worldedit.command.*  # All editing commands

💡 Usage Examples

Example 1: Building a House Foundation

# 1. Get your wand
/wand

# 2. Select the foundation area
# Left-click one corner, right-click opposite corner

# 3. Fill with stone
/set stone

# 4. Create walls (4 blocks high)
/pos1
/pos2 ~0 ~4 ~0
/walls stone_bricks

# 5. Add a floor
/overlay oak_planks

Example 2: Creating a Sphere Monument

# 1. Stand where you want the center
/sphere glass 10

# 2. Make it hollow
/undo
/hsphere glass 10

# 3. Add a glowing core
/sphere glowstone 3

Example 3: Copying and Pasting a Structure

# 1. Select the structure
/pos1
/pos2

# 2. Copy it
/copy

# 3. Move to new location
# (walk to where you want to paste)

# 4. Paste it
/paste

# 5. Oops, wrong spot? Undo!
/undo

# 6. Move and paste again
/paste

Example 4: Setting Up a Build Area (Operators)

# Scenario: Create a creative build zone for your build team

# 1. Select the area boundaries
/pos1
/pos2

# 2. Create the build area
/area create creative_plaza

# 3. Add your builders
/area addbuilder creative_plaza Steve
/area addbuilder creative_plaza Alex
/area addbuilder creative_plaza Notch

# 4. Check the area info
/area info creative_plaza

# 5. Teleport to the area
/area tp creative_plaza

# Now Steve, Alex, and Notch can use WorldEdit in this area!
# They'll automatically switch to creative mode when they enter.

Example 5: Builder Workflow

# As a builder named Steve:

# 1. Check your assigned areas
/myareas
# Output: You have access to 2 build areas:
#   - creative_plaza (overworld)
#   - spawn_design (overworld)

# 2. Open the builder's menu
/bmenu
# Shows: Current area, selection status, clipboard, commands

# 3. Walk into creative_plaza
# Auto-message: "Entered build area: creative_plaza"
# Auto-message: "Creative mode enabled"

# 4. Start building!
/wand
/pos1
/pos2
/set quartz_block

# 5. Leave the area
# Auto-message: "Left build area: creative_plaza"
# Auto-message: "Gamemode restored"

Example 6: Replacing Blocks in a Region

# Replace all dirt with grass in your selection
/pos1
/pos2
/replace dirt grass

# Replace all stone variants with smooth stone
/replace stone smooth_stone
/replace cobblestone smooth_stone
/replace stone_bricks smooth_stone

Example 7: Using Schematics

# Save a building
/pos1
/pos2
/schem save my_house

# List all schematics
/schem list

# Load it somewhere else
# (move to new location)
/schem load my_house
/paste

# The schematic is now in your clipboard!

📊 Changelog

Version 3.3.0 - Container Support via Structure Files (Current)

🎉 NEW FEATURE: Container Preservation for Schematics!

🎁 Schematic saves now preserve container contents!
- Uses Minecraft Bedrock's /structure save and /structure load commands
- Hybrid system: Saves both .schem (blocks) and .mcstructure (containers) files
- Automatically attempts to use .mcstructure when loading for full data preservation

🔨 How It Works:

/schem save <name> - Saves BOTH formats:
- name.schem - Sponge format (blocks only, for compatibility)
- name.mcstructure - Bedrock format (with containers, entities, NBT data!)
/schem load <name> - Attempts to use .mcstructure first
- If structure load succeeds: Preserves chest contents, furnace items, etc.
- If structure load fails: Falls back to .schem file (blocks only)
- Use -c flag to load to clipboard (uses .schem format)

✨ What's Preserved (when using structure files):

✅ Chest contents (regular, trapped, ender)
✅ Furnace items and fuel (furnace, blast furnace, smoker)
✅ Hopper contents
✅ Dispenser/Dropper contents
✅ Brewing stand potions
✅ Lectern books
✅ Shulker box contents
✅ Item frames and armor stands
✅ All other block entities!

📝 Important Notes:

Copy/Paste commands do NOT preserve containers (use schematics instead)
Structure files are saved in <world>/structures/ folder
Clipboard mode (/schem load -c) uses .schem format (no containers)
Direct placement (/schem load) attempts structure load (with containers)

🔧 Technical Details:

Added structure_utils.py module for structure command wrappers
RapidNBT dependency ready for future enhancements
Backward compatible with existing .schem files
Graceful fallback if structure commands fail

Version 3.2.1 - Rotation & Transformation Fix

🐛 Critical Bug Fixes

🔧 FIXED: Schematic rotation not working in builder menu
- /schem load now supports -c flag to load to clipboard instead of direct placement
- Builder menu "Quick Load" now properly loads schematics to clipboard
- Builder menu "Load & Place" now uses clipboard loading + paste transformations
🔧 FIXED: Paste command rotation and transformation flags not working
- Complete rewrite of /paste command with full transformation support
- Added -r <degrees> flag for rotation (0, 90, 180, 270)
- Added -fx, -fy, -fz flags for flipping on X, Y, Z axes
- Added -o x,y,z flag for custom offset positioning
- Added -a, -e, -b flags for air blocks, entities, and biomes
🔧 FIXED: Rotation toggles in builder menu had no effect
- Rotation, flip, and offset options now properly applied when pasting
- All transformation options in "Load & Place" form now functional

🔨 Improvements

📈 Enhanced /paste command with comprehensive transformation options
📈 Enhanced /copy command with optional flags: -a (include air), -e (entities), -b (biomes)
📈 Improved schematic workflow: load to clipboard → transform → paste
📈 Better separation between direct placement and clipboard-based operations
📈 Consistent transformation behavior across all paste operations
📈 CRITICAL FIX: All builder menu operations now call command handlers directly
- Bypasses Endstone's command parser to avoid syntax validation errors
- Commands with flags (copy, paste, rotate, flip, schem) use direct handler calls
- Eliminates "Syntax error: Unexpected '-a'" and similar errors
📈 CRITICAL FIX: Removed usages field from command definitions with parameters
- Endstone was treating <parameter> placeholders as literal strings
- Commands now accept any arguments and validate internally
📈 Added comprehensive debug logging to console for troubleshooting command execution

📝 Documentation

📚 Updated /paste command documentation with all transformation flags
📚 Updated /schem load documentation with clipboard flag
📚 Added examples for rotation, flip, and offset combinations
📚 Clarified schematic loading modes (direct vs clipboard)

Version 3.2.0 - Interactive Tools & Preview Update

🎉 Major Features

✨ NEW: Blueprint system for personal clipboard saves
- /blueprint save <name> - Save clipboard as blueprint
- /blueprint load <name> - Load blueprint into clipboard
- /blueprint list - List your blueprints
- /blueprint delete <name> - Delete blueprint
- /blueprint shared list/load - Access shared blueprints
- Fully functional menu integration
- Personal and shared blueprint folders
✨ NEW: Shape Tool system with wooden shovel for interactive shape spawning
- Sneak + Right-click to configure shape (type, block, size)
- Right-click (standing) to spawn shape at crosshair location
- 8 shape types: Sphere, Hollow Sphere, Cylinder, Hollow Cylinder, Square, Hollow Square, Pyramid, Hollow Pyramid
- Per-player settings persistence
- Crosshair-based targeting for precise placement
✨ NEW: /shapetool (alias /sht) command to get the shape tool
✨ NEW: Schematic Preview system for precise placement
- /schem preview <name> - Shows particle outline of schematic
- Preview follows player position in real-time
- Golden/cyan soul fire flame particles (distinct from selection particles)
- Shows dimensions and coordinates
- /schem clearpreview - Remove active preview
- Auto-clears when schematic is loaded
✨ UPDATED: Smooth Tool behavior changed to match Shape Tool
- Sneak + Right-click to configure (was: Right-click)
- Right-click (standing) to execute smooth at crosshair (was: Left-click)
- Crosshair-based targeting for precise smoothing
- Settings still persist per player

🔨 Improvements

📈 Consistent tool interaction pattern across all tools (sneak to configure, click to execute)
📈 Crosshair-based targeting for smooth and shape tools - aim where you want to build!
📈 Schematic placement workflow - preview before loading for perfect positioning
📈 Better visual feedback with distinct particle types for different features
📈 Improved tool usability - configure once, use many times

📝 Documentation

📚 Added Shape Tool comprehensive guide
📚 Updated Smooth Tool documentation with new sneak/stand behavior
📚 Added Schematic Preview documentation with examples
📚 Updated command reference tables
📚 Added workflow examples for new features

Version 3.1.0 - Tools & Shapes Update

🎉 Major Features

✨ NEW: Smooth Tool system with wooden hoe for terrain smoothing
- Right-click to configure (radius, aggressiveness, selection mode)
- Left-click to execute smooth with saved settings
- 6 aggressiveness levels from Gentle to Extreme
- Per-player settings persistence
✨ NEW: /smoothtool command to get the smooth tool
✨ NEW: /smooth [iterations] command for manual terrain smoothing
✨ NEW: Transform commands for rotating and flipping selections
- /rotate <degrees> - Rotate selection 90°, 180°, or 270°
- /flip [x|y|z] - Flip selection along any axis
- Transform menu in builder UI for easy access
✨ NEW: Pyramid shapes - /pyramid and /hpyramid commands
✨ NEW: Square shapes (rectangular prisms) via menu - solid and hollow
✨ NEW: Interactive menu system completely redesigned
- 9 main categories: Selection, Clipboard, Editing, Transform, Shapes, Schematics, Build Areas, Undo/Redo
- Transform menu with rotate and flip operations
- Advanced paste controls with rotation, flip, and offset
- Schematic loading with full placement controls
- Build area creation with coordinate inputs

🐛 Bug Fixes

🔧 FIXED: Selection detection in menu (UUID key mismatch)
🔧 FIXED: Square shape command syntax errors
🔧 FIXED: ModalForm content attribute error
🔧 FIXED: Build area creation now uses coordinate inputs instead of selection

🔨 Improvements

📈 Smooth tool workflow - configure once, use many times
📈 All shape commands now working (spheres, cylinders, pyramids, squares)
📈 Enhanced menu system with better organization
📈 Improved error messages and user feedback
📈 Better tool integration (wand + smooth tool)

📝 Documentation

📚 Comprehensive "How To Use" section added to README
📚 Complete tools guide (Selection Wand & Smooth Tool)
📚 Detailed menu system documentation
📚 Commands reference with examples
📚 Updated permissions list

Version 3.0.0 - Builder's Edition

🎉 Major Features

✨ NEW: Builder's Menu system with /bmenu, /myareas, and /areainfo commands
✨ NEW: Build Area Management system for operators (/area command suite)
✨ NEW: Automatic creative mode switching when entering/exiting build areas
✨ NEW: Permission-based area restrictions for non-operators
✨ NEW: Real-time area entry/exit notifications
✨ NEW: Multi-builder support with per-area access control

🐛 Bug Fixes

🔧 FIXED: ValueError: byte must be in range(0, 256) when saving schematics with large palettes
🔧 FIXED: Implemented proper varint encoding for Sponge Schematic v2 format

🔨 Improvements

📈 Enhanced permission system with granular area-based checks
📈 Improved configuration system with build area settings
📈 Better error messages directing players to available commands
📈 Optimized area checking with periodic position tracking

Version 2.0.2 - Previous Release

Features

Core WorldEdit functionality (set, replace, copy, paste, etc.)
Schematic support (save/load .schem files)
Shape generation (spheres, cylinders)
Undo/redo system
Selection visualization with particles
Block translation map for Java Edition compatibility

🤝 Contributing

Contributions are welcome! Here's how you can help:

Report Bugs: Open an issue with detailed reproduction steps
Suggest Features: Share your ideas in the issues section
Submit Pull Requests: Fork the repo and submit PRs for review
Improve Documentation: Help make the docs clearer and more comprehensive

Development Setup

# Clone the repository
git clone https://github.com/iciency/WorldEdit.git
cd WorldEdit

# Install development dependencies
pip install -e .

# Run tests (if available)
pytest

# Build the plugin
python -m build

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Endstone Team - For creating the amazing Endstone server platform
WorldEdit - Original inspiration from the Java Edition plugin
Contributors - Everyone who has helped improve this plugin

📞 Support

Issues: GitHub Issues
Discussions: GitHub Discussions
Discord: Join the Endstone Discord for community support

Made with ❤️ for the Endstone community

⭐ Star this repo if you find it useful!

Name		Name	Last commit message	Last commit date
Latest commit History 32 Commits
src/endstone_worldedit		src/endstone_worldedit
.gitattributes		.gitattributes
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
pyproject.toml		pyproject.toml

Folders and files

Latest commit

History

Repository files navigation

🏗️ WorldEdit for Endstone - Builder's Edition

📋 Table of Contents

✨ Features

🎨 Core WorldEdit Functionality

🏗️ Builder's Menu System (NEW!)

🔐 Build Area Management (NEW!)

📘 Blueprint System (NEW!)

🌍 Builder Zones (NEW!)

📦 Installation

Prerequisites

Steps

🚀 Quick Start

For Server Operators

For Builders

📖 How To Use

🔨 Tools Guide

Selection Wand (Wooden Axe)

Smooth Tool (Wooden Hoe)

Shape Tool (Wooden Shovel)

📱 Menu System

Main Builder Menu

📝 Commands Reference

Selection Commands

Editing Commands

Transform Commands

Clipboard Commands

Shape Commands

Blueprint Commands

Schematic Commands

History Commands

Build Area Commands (Operators Only)

⚙️ Configuration

Configuration Options

Build Area Settings

📝 Commands

🔧 Selection Commands

✏️ Editing Commands

🔄 Transform Commands

📋 Clipboard Commands

↩️ History Commands

🔮 Shape Generation Commands

📦 Blueprint Commands

💾 Schematic Commands

🏗️ Build Area Commands (Operators)

👷 Builder Menu Commands

🔐 Permissions

Permission Hierarchy

Default Permissions

Recommended Permission Sets

💡 Usage Examples

Example 1: Building a House Foundation

Example 2: Creating a Sphere Monument

Example 3: Copying and Pasting a Structure

Example 4: Setting Up a Build Area (Operators)

Example 5: Builder Workflow

Example 6: Replacing Blocks in a Region

Example 7: Using Schematics

📊 Changelog

Version 3.3.0 - Container Support via Structure Files (Current)

Version 3.2.1 - Rotation & Transformation Fix

Version 3.2.0 - Interactive Tools & Preview Update

Version 3.1.0 - Tools & Shapes Update

Version 3.0.0 - Builder's Edition

Version 2.0.2 - Previous Release

🤝 Contributing

Development Setup

📄 License

🙏 Acknowledgments

📞 Support

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Packages