# 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.**
The HyCore - World Edit Team
