# SimpleEdit **A modern WorldEdit-inspired Paper plugin for Minecraft 26.1** ## 🌟 Overview SimpleEdit is a powerful and user-friendly world-editing plugin designed specifically for Paper servers. It provides all the essential functions that builders and server administrators need to edit their Minecraft worlds efficiently. The plugin combines the proven concepts of WorldEdit with a modern, optimized implementation. ## ⚡ Main Features ### 🎯 Selection System - **Wooden axe tool**: Classic selection by left and right clicking - **Position commands**: `/pos1` and `/pos2` for precise coordinate input - **Visual feedback**: Clear chat messages about selected areas - **Flexible selection**: Supports cubic areas of any size - **Selection expansion**: `/expand` and `/contract` for dynamic size adjustment - **Selection utilities**: `/size`, `/count`, `/center`, `/info` for information and navigation - **Info command**: `/info` shows detailed analysis (volume, size, position, block distribution) ### 🔨 Block Operations - **`/set `**: Fills the entire selection with the specified block type - **`/replace `**: Replaces specific blocks in the selection with others - **`/outline `**: Creates a frame around the selection - **`/walls `**: Fills the walls of the selection - **`/hollow`**: Removes the interior of the selection (hollow structures) - **Material support**: All Minecraft 26.1 blocks and materials - **Intelligent processing**: Efficient batch operations for large areas ### 🎨 Brush System - **Sphere Brush**: Spherical brush functionality - **Smooth Brush**: Terrain smoothing - **Replace Brush**: Block replacement within the brush area - **Schematic Brush**: Placement of saved structures - **Multi-tool support**: Different tools for different brushes - **Configurable sizes**: Adjustable brush radii ### 📐 Geometric Shapes - **`/sphere `**: Creates perfect spheres - **`/cylinder `**: Cylinder generation - **`/pyramid `**: Pyramids of various sizes - **`/dome `**: Create domes (hemispheres) - **`/cone `**: Create cones - **`/line `**: Straight lines between two points - **Hollow variants**: All shapes also available as hollow versions ### 🌍 Terrain Generation - **`/generate cave`**: Procedural cave systems - **`/generate mountain `**: Natural mountain formations - **`/generate forest`**: Automatic forest vegetation - **`/generate islands `**: Floating islands - **`/generate maze `**: Maze generation - **`/generate temple `**: Temple structures - **`/generate ruins `**: Destroyed buildings - **`/generate ore_veins `**: Ore veins with realistic distribution ### 🔧 Advanced Operations - **`/smooth [iterations]`**: Terrain smoothing with configurable iterations - **`/naturalize `**: Natural terrain layering - **`/deform `**: Mathematical terrain deformation - **`/fix `**: Repair fluid sources - **`/flora `**: Automatic plant and tree generation - **`/erode `**: Natural erosion simulation - **`/gradient `**: Color gradients and transitions ### 🛠️ Builder Utilities - **`/drain [water|lava]`**: Removes water or lava from the selection - **`/overlay `**: Places blocks on surfaces within the selection - **`/dome `**: Creates domes (hemispheres) - **`/cone `**: Creates cones - **`/green [density]`**: Places vegetation (grass, flowers, trees) on grass blocks - **`/snow [thickness]`**: Adds snow layers - **`/thaw`**: Removes snow and ice from the selection - **`/extinguish`**: Extinguishes all fire in the selection - **`/butcher [radius] [type]`**: Removes entities (mobs) in the selection - **`/fillfluid `**: Fills the selection with water or lava - **`/info`**: Shows detailed information about the selection (volume, size, block distribution) ### 📋 Copy & Paste System - **`/copy`**: Copy the selection to the clipboard - **`/cut`**: Cut and copy the selection - **`/paste`**: Paste the clipboard content - **`/rotate `**: Rotate the clipboard content - **`/flip `**: Mirror the clipboard content - **`/move `**: Move the selection ### 📚 History Management - **Individual history**: Each player has their own undo/redo history - **`/undo`**: Undoes the last action - **`/redo`**: Restores an undone action - **Multiple levels**: Supports multiple consecutive undo/redo actions - **Deterministic restoration**: Generate operations are restored exactly - **History GUI**: Visual overview of past actions ### 🎯 Mask System - **`/mask `**: Activate selective editing - **Block-based masks**: Edit only specific blocks - **Pattern-based masks**: Complex filter options - **Inverted masks**: Reverse the selection ### 📊 Schematics & Blueprints - **`/schem save `**: Save the current selection as a schematic - **`/schem load `**: Load and place a schematic - **`/schem list`**: Show all available schematics - **`/schem preview `**: Live preview before placement - **WorldEdit compatibility**: `.schem` files are supported - **Custom `.se.json` formats**: Optimized storage ## 🎮 Applications ### For Builders - **Terrain design**: Creation of complex landscapes with mountains, caves, and forests - **Structure building**: Fast creation of buildings, walls, and architectural elements - **Detail work**: Precise placement of individual blocks with brushes - **Creative freedom**: Experiment with patterns, color gradients, and mathematical shapes - **Error correction**: Complete undo/redo system for risk-free work ### For Server Administrators - **World maintenance**: Repair of griefing damage and terrain restoration - **Event preparation**: Quick creation of arenas, spawn areas, and event zones - **Performance optimization**: Terrain smoothing and optimization for better TPS - **Backup & recovery**: Safe world modifications with full recoverability - **Quality assurance**: Automated tests and validation of world changes ### For Map Makers - **Procedural generation**: Realistic cave systems, ore veins, and landscapes - **Structure placement**: Precise positioning of buildings and landmarks - **Biome management**: Adjustment of weather, temperature, and vegetation - **Large-scale editing**: Efficient editing of huge areas with async processing - **Version control**: Deterministic operations for reproducible builds ## 🔧 Technical Details - **Version**: 1.0-SNAPSHOT - **Minecraft version**: 26.1 - **Server software**: Paper (recommended) - **Java version**: Java 25 - **Performance**: Optimized for large selections and batch operations - **Async processing**: Parallel processing with configurable limits (8000 blocks/tick) - **Memory management**: Automatic garbage collection and resource cleanup - **Thread safety**: Fully thread-safe operations for multi-threading environments - **History system**: Deterministic undo/redo with seed-based restoration ## ⚙️ Configuration The plugin offers extensive configuration options in `config.yml`: ```yaml # Performance settings edits-per-tick: 8000 # Blocks per tick (default: 8000) max-history: 2000 # Maximum undo steps per player # Performance Settings performance: max-operation-size: 50000000 # Maximum blocks per operation (50M) chunk-batch-size: 8 # Chunks processed per tick block-batch-size: 1000 # Blocks per batch # Schematic Preview Settings preview: max-blocks: 20000 # Maximum non-air blocks for preview max-distance: 200.0 # Maximum distance from player batch-size: 50 # Blocks per batch auto-cleanup: true # Auto-cleanup previews glow-effect: true # Make preview blocks glow transparency: 0.98 # Block scale factor # Feature Flags features: enable-selection-outline: true # Show visual selection outline enable-operation-progress: true # Show progress updates enable-sound-feedback: true # Play sounds for operations enable-container-copy: true # Copy container contents enable-performance-monitoring: false # Track operation metrics # Limits & Safety limits: max-selection-size: 50000000 # Maximum blocks in selection (50M) max-operation-time: 300 # Maximum operation time (5 min) warn-on-large-operations: true # Warn player before large operations large-operation-threshold: 1000000 # Warn threshold (1M blocks) ``` ## 🚀 Advanced Features & APIs ### Plugin API SimpleEdit offers an extensive Java API for other plugins: ```java // Access to services SelectionManager selections = SimpleEdit.getInstance().getSelections(); HistoryManager history = SimpleEdit.getInstance().getHistory(); // Create custom operations EditOperation customOp = new CustomOperation(region, pattern); operations.start(playerId, customOp); ``` ### Pattern System Extensible pattern API for custom block generation: ```java public class CustomPattern implements Pattern { @Override public BlockData dataFor(int x, int y, int z, World world) { // Custom logic here return Material.DIAMOND_BLOCK.createBlockData(); } } ``` ### Event System Full integration with Bukkit's event API for maximum compatibility. ## 🔒 Security & Performance - **Memory leaks prevented**: Automatic cleanup of entity references - **Thread-safe collections**: ConcurrentHashMap for all multi-thread scenarios - **Input validation**: Extensive validation of all user input - **Exception handling**: Robust error handling with logging - **Performance monitoring**: Detailed TPS impact measurements - **Resource limits**: Configurable limits for all operations ## 🌐 Internationalization The plugin supports multiple languages with configurable language files. Currently available: - German (default) - English (planned) - Other languages on request ## 📊 Monitoring & Statistics Built-in monitoring features for server administrators: - **Performance monitoring**: Optional tracking of operation metrics (type, blocks, duration, B/s) - **Performance metrics**: TPS impact per operation - **Usage statistics**: Most used commands and operations - **Error tracking**: Automatic error reporting - **Player activity**: Overview of builder activities - **Info command**: Detailed analysis of selections with block distribution ## 📋 Installation & Usage ### Quick Start Guide 1. **Download the plugin**: Download the latest `.jar` file from the releases 2. **Server installation**: Place the plugin in the `plugins/` folder of the server 3. **Restart the server**: Restart the Paper server with `/restart` or do a full restart 4. **Getting started**: ```bash # Take a wooden axe (or use /wand for automatic granting) # Left click: set position 1 # Right click: set position 2 # /set stone # Fill the selection with stone ``` ### Basic Commands ```bash # Selection tools /wand # Get wooden axe /pos1 # Current position as Pos1 /pos2 # Current position as Pos2 /size # Show selection size # Basic operations /set # Fill selection /replace # Replace blocks /copy # Copy selection /paste # Paste /undo # Undo /redo # Redo /info # Show selection information # Builder utilities /drain [water|lava] # Remove water/lava /overlay # Place blocks on surfaces /dome # Create dome /cone # Create cone /green [density] # Place vegetation /snow [thickness] # Add snow /thaw # Remove snow/ice /extinguish # Extinguish fire /butcher [radius] # Remove entities /fillfluid # Fill with fluid # Advanced operations /generate sphere stone # Generate sphere /generate cave # Create cave /generate mountain natural:stone # Build mountain /brush sphere stone 5 # Set sphere brush /smooth # Smooth terrain /naturalize # Natural layering ``` ### GUI Menus SimpleEdit offers intuitive graphical menus for complex operations: - **`/simpleedit`**: Main menu with all features - **Brush configuration**: `/brush` menu for brush settings - **Pattern selection**: Automatic preview of available patterns - **History overview**: Visual representation of recent actions ## 🛠️ Troubleshooting ### Common Issues **Issue**: "Selection incomplete" ``` Solution: Make sure both positions (Pos1 & Pos2) are set Use /wand for an axe or /pos1 and /pos2 for manual coordinates ``` **Issue**: "Operation already running" ``` Solution: Wait for the current operation to finish or use /cancel ``` **Issue**: Performance problems with large operations ``` Solution: Reduce edits-per-tick in config.yml or use smaller selections ``` ### Debug Commands ```bash /progress # Shows progress of running operations /cancel # Cancels the current operation /help # Shows all available commands ``` ## 🤝 Contribution & Support ### Development SimpleEdit is open-source and available on GitHub. Contributions are welcome! ### Support - **GitHub Issues**: For bug reports and feature requests - **Discord**: Community support and discussions - **Documentation**: Full API documentation available ### License SimpleEdit is licensed under the MIT license and can be freely used and modified. ## 🎨 Why SimpleEdit? - **🚀 Performance**: Optimized async processing for millions of blocks (up to 50M blocks) - **🔄 Reliability**: Complete undo/redo system with deterministic restoration - **🎯 User-friendly**: Intuitive commands and graphical menus (`/simpleedit`) - **🔧 Extensible**: Extensive API for developers - **🛡️ Safe**: Thread-safe operations and memory leak protection - **🌍 Modern**: Built for Minecraft 26.1+ with Paper optimizations - **📊 Monitoring**: Detailed statistics and optional performance monitoring - **🛠️ Builder tools**: Extensive utilities for professional builders (Drain, Overlay, Dome, Cone, Green, Snow, etc.) - **📈 Analysis**: Detailed selection information with `/info` (block distribution, volume, size) - **⚙️ Configurable**: Extensive config options for performance, limits, and features **SimpleEdit is the ideal choice for anyone looking for a professional, powerful, and reliable world-editing tool for Minecraft!** ### 🆕 Latest Features - **Builder utilities**: Drain, Overlay, Dome, Cone, Green, Snow, Thaw, Extinguish, Butcher - **Info command**: Detailed selection analysis with block distribution - **Fill fluid**: Quick filling with water or lava - **Performance monitoring**: Optional tracking of operation metrics - **Improved GUI**: All new commands integrated into the BuildingGUI - **Better error handling**: Robust operation completion without multiple updates --- *Developed with ❤️ by oFlori(Flori) | Version 1.0-SNAPSHOT | Minecraft 26.1+*

SimpleEdit

Compatibility

Minecraft: Java Edition

Platforms

Creators

Details

Async für Performance

Schematic Preview

Pattern support

Auswahl anzeige