RegionEdit

---

📖 Overview

Overview: RegionEdit is a powerful world editing plugin with a variety of tools and features. It's optimized for Paper and Folia servers, supports asynchronous operations, custom blocks, and a comprehensive API. It's the best alternative to worldedit/FAWE.

Why RegionEdit?

• 🚀 Folia Optimized: Full support for Folia's regionized threading
• ⚡ Async Operations: All heavy operations are non-blocking
• 🎨 Custom Blocks: Seamless integration with Nexo and other custom block plugins
• 🔧 Comprehensive API: Everything accessible for developers
• 📦 Modern Schematics: JSON-based format with custom block support
• 🎯 WorldEdit syntax: Familiar commands and syntax

✨ Features

Core Features

• ✅ Selections: Cuboid, sphere, polygon, and more
• ✅ Clipboard: Copy, cut, paste with transformations
• ✅ History: Unlimited undo/redo with configurable limits
• ✅ Templates: Various template types for editing
• ✅ Masks: Many mask types for filtering blocks
• ✅ Brushes: Includes tools for drawing in the world
• ✅ Schemas: Modern JSON format with support for custom blocks
• ✅ Expressions: Mathematical expressions for advanced operations
• ✅ Custom Blocks: Full support for furniture and Nexo blocks

Advanced Features

• 🔄 Async Everything: All operations use async module
• 🧩 Extensible: Easy to add custom patterns, masks, and brushes
• 🎯 Precise Control: Expression-based masks and patterns
• 📊 Performance: Optimized chunk batching and caching
• 🔐 Thread Safe: Works perfectly on Folia's regionized threads
• 🌍 Multi-World: Full support for multiple worlds

🚀 Installation

Requirements

• Minecraft Server 1.20+
• Paper and Folia
• Java 21+

Steps

1. Download the latest RegionEdit.jar from Releases
2. Place the jar in your server's plugins folder
3. Restart your server
4. Configure in plugins/RegionEdit/config.yml
5. Enjoy!

Optional Dependencies

• Nexo: For custom block support

📝 Commands

Selection Commands

//pos1, //pos2          - Set selection positions
//hpos1, //hpos2        - Set positions to targeted block (NOT WORK)
//wand                  - Get selection wand
//sel <type>            - Choose selection type (NOT WORK)
//expand                - Expand selection
//contract <amount>     - Contract selection (NOT WORK)
//shift <amount>        - Shift selection (NOT WORK)

Region Commands

//set <pattern>         - Fill selection with pattern
//replace <from> <to>   - Replace blocks
//overlay <pattern>     - Overlay pattern on surface (NOT WORK)
//walls <pattern>       - Build walls (NOT WORK)
//smooth [iterations]   - Smooth terrain (NOT WORK)
//stack <count>         - Stack clipboard (NOT WORK)

Clipboard Commands

//copy                  - Copy selection
//cut                   - Cut selection (NOT WORK)
//paste                 - Paste clipboard
//clipform              - transform paste

Schematic Commands

//schem save <name>     - Save schematic
//schem load <name>     - Load schematic
//schem list            - List schematics
//schem remove <name>   - Delete schematic

Generation Commands

//sphere <pattern> <radius>     - Generate sphere (NOT WORK)
//cyl <pattern> <radius>        - Generate cylinder (NOT WORK)
//pyramid <pattern> <size>      - Generate pyramid (NOT WORK)
//generate <pattern> <expr>     - Generate with expression (NOT WORK)

History Commands

//undo [times]          - Undo operations
//redo [times]          - Redo operations
//clearhistory          - Clear history

🎨 Pattern Examples

stone                           - Single block
50%stone,50%dirt               - Random pattern
##wool                         - Random wool colors
#clipboard                     - Clipboard pattern
^acacia_stairs                 - Type apply
^[waterlogged=false]           - State apply
*oak_log                       - Random states
stone,##wool,nexo:custom_id    - combined pattern

🎭 Mask Examples

stone                         - Block mask
!air                          - Everything except air
#existing                     - Non-air blocks
#surface                      - Surface blocks
%50                           - 50% of blocks
=y<64                         - Blocks below Y=64
stone <air                    - Stone with air above

🔧 API

RegionEdit provides a comprehensive API for developers:

🔌 Custom Block Integration

RegionEdit supports custom blocks from various plugins:

Nexo Integration

// Automatically detected and enabled
// Custom blocks and furniture are fully supported in:
// - Selections
// - Clipboard
// - Schematics
// - All operations

🎯 Performance

RegionEdit is designed for performance:

• Async Operations: All heavy operations are non-blocking
• Folia Optimized: Proper regionized threading on Folia
• Memory Efficient: Smart caching and cleanup
• Scalable: Handles operations from small to massive

Benchmarks

• Small operations (< 100000 blocks): < 50ms
• Medium operations (100000-1000000 blocks): < 500ms
• Large operations (1000000+ blocks): Async, no lag

📄 License

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

📞 Support

• Issues: GitHub Issues
• Discord: Join our Discord
• Telegram: @Izumlisov

🗺️ Roadmap

• [x] Core functionality
• [x] Pattern system
• [x] Mask system
• [x] Expression parser
• [x] Schematic system
• [x] Custom block support
• [ ] Brush system
• [x] Folia optimization
• [ ] GUI interface & Mod interface
• [ ] Web schematic browser
• [x] More integrations
• [ ] Advanced brushes
• [ ] Cloud schematics
• [ ] Structure animations

📊 Statistics

• Lines of Code: 14,880+
• Supported Versions: 1.20 - 1.22+

---