# HyCore World Edit - Terrain Editing Tools for Hytale

**Powerful world editing commands for builders and server admins.**

HyCore World Edit brings essential terrain manipulation tools to your Hytale server. Select regions, generate shapes, copy/paste structures, and modify terrain with familiar WorldEdit-style commands.

---

## Features

### Selection Tools

- **Wand Tool** - Left-click for pos1, right-click for pos2

- **Chunk Selection** - Select an entire chunk instantly

- **Raycast Selection** - Set positions by looking at blocks

- **Selection Manipulation** - Expand, contract, shift, inset, outset

### Region Operations

- **//set** - Fill your selection with any block

- **//replace** - Replace specific blocks within selection

- **//walls** - Create walls around selection

- **//faces** - Create all 6 faces of selection

- **//hollow** - Hollow out your selection

- **//outline** - Create an outline of your selection

- **//move** - Move your selection in any direction

- **//stack** - Repeat your selection multiple times

- **//overlay** - Place blocks on top of existing terrain

- **//line** - Draw lines between positions

- **//naturalize** - Add natural terrain layers

### Shape Generation

- **//sphere** & **//hsphere** - Solid and hollow spheres

- **//cyl** & **//hcyl** - Solid and hollow cylinders

- **//pyramid** & **//hpyramid** - Solid and hollow pyramids

- **//cone** - Create cones

### Clipboard System

- **//copy** - Copy selection to your clipboard

- **//paste** - Paste clipboard at your position

- Per-player clipboards with position offset support

### History System

- **//undo** - Revert your last operation

- **//redo** - Restore an undone operation

- Per-player history tracking

---

## Commands

### Selection Commands

| Command | Description |

|---------|-------------|

| `//wand` | Get the selection wand tool |

| `//pos1` | Set position 1 at your feet |

| `//pos2` | Set position 2 at your feet |

| `//hpos1` | Set position 1 at targeted block |

| `//hpos2` | Set position 2 at targeted block |

| `//chunk` | Select the chunk you're standing in |

| `//expand <amount> [direction]` | Expand selection |

| `//contract <amount> [direction]` | Contract selection |

| `//shift <amount> [direction]` | Shift selection |

| `//outset <amount>` | Expand in all directions |

| `//inset <amount>` | Contract in all directions |

| `//size` | Show selection dimensions |

| `//count <block>` | Count specific blocks in selection |

### Region Commands

| Command | Description |

|---------|-------------|

| `//set <block>` | Fill selection with a block |

| `//replace <from> <to>` | Replace blocks in selection |

| `//walls <block>` | Create walls around selection |

| `//faces <block>` | Create all faces of selection |

| `//outline <block>` | Create selection outline |

| `//hollow` | Hollow out the selection |

| `//center <block>` | Set the center block(s) |

| `//move <amount> [direction]` | Move selection contents |

| `//stack <count> [direction]` | Stack selection repeatedly |

| `//overlay <block>` | Place blocks on top of terrain |

| `//line <block>` | Draw a line between positions |

| `//naturalize` | Apply natural terrain layers |

### Generation Commands

| Command | Description |

|---------|-------------|

| `//sphere <block> <radius>` | Create a solid sphere |

| `//hsphere <block> <radius>` | Create a hollow sphere |

| `//cyl <block> <radius> <height>` | Create a solid cylinder |

| `//hcyl <block> <radius> <height>` | Create a hollow cylinder |

| `//pyramid <block> <size>` | Create a solid pyramid |

| `//hpyramid <block> <size>` | Create a hollow pyramid |

| `//cone <block> <radius> <height>` | Create a cone |

### Clipboard Commands

| Command | Description |

|---------|-------------|

| `//copy` | Copy selection to clipboard |

| `//paste` | Paste clipboard at your position |

### History Commands

| Command | Description |

|---------|-------------|

| `//undo` | Undo last operation |

| `//redo` | Redo last undone operation |

---

## Installation

1. Download `HyCore-WorldEdit.jar`

2. Place in your server's `plugins/` folder

3. Restart your server

4. Use `//wand` to get started

---

## Permissions

| Permission | Description |

|------------|-------------|

| `worldedit.wand` | Use the selection wand |

| `worldedit.selection` | Selection commands (pos1, pos2, expand, etc.) |

| `worldedit.region` | Region commands (set, replace, walls, etc.) |

| `worldedit.generation` | Generation commands (sphere, cyl, pyramid, etc.) |

| `worldedit.clipboard` | Clipboard commands (copy, paste) |

| `worldedit.history` | History commands (undo, redo) |

| `worldedit.*` | All WorldEdit permissions |

**Note:** Integrates with HyCore permissions if installed.

---

## Limits

To prevent server lag, the following limits are enforced:

- **Max Selection Size:** 50,000 blocks

- **Max Radius:** 100 blocks

- **Max Height:** 256 blocks

- **Max Stack Count:** 100

---

## Directions

Many commands support directional arguments:

- `north`, `south`, `east`, `west`

- `up`, `down`

- Or use player facing direction by default

---

## Why HyCore World Edit?

- **Familiar Commands** - Similar syntax to Minecraft's WorldEdit

- **Performance Focused** - Built-in limits prevent lag

- **Per-Player Sessions** - Selections, clipboards, and history are separate

- **Undo/Redo Support** - Safely experiment with changes

- **Easy Setup** - Works out of the box

---

## Requirements

- Hytale Server

- Java 21+

- HyCore (optional, for permission integration)

---

## Support

- [GitHub Issues](https://github.com/Galaxyz7/HyCore-WorldEdit/issues) - Bug reports & feature requests

---

**Made with love for the Hytale community.**

HyCore - World Edit