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 <block>: Fills the entire selection with the specified block type
• /replace <from> <to>: Replaces specific blocks in the selection with others
• /outline <block>: Creates a frame around the selection
• /walls <block>: 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 <radius> <pattern>: Creates perfect spheres
• /cylinder <radius> <height> <pattern>: Cylinder generation
• /pyramid <size> <pattern>: Pyramids of various sizes
• /dome <radius> <pattern>: Create domes (hemispheres)
• /cone <radius> <height> <pattern>: Create cones
• /line <pattern>: Straight lines between two points
• Hollow variants: All shapes also available as hollow versions

🌍 Terrain Generation

• /generate cave: Procedural cave systems
• /generate mountain <pattern>: Natural mountain formations
• /generate forest: Automatic forest vegetation
• /generate islands <pattern>: Floating islands
• /generate maze <pattern>: Maze generation
• /generate temple <pattern>: Temple structures
• /generate ruins <pattern>: Destroyed buildings
• /generate ore_veins <pattern>: Ore veins with realistic distribution

🔧 Advanced Operations

• /smooth [iterations]: Terrain smoothing with configurable iterations
• /naturalize <top> <filler>: Natural terrain layering
• /deform <expression>: Mathematical terrain deformation
• /fix <fluid>: Repair fluid sources
• /flora <type> <density>: Automatic plant and tree generation
• /erode <intensity>: Natural erosion simulation
• /gradient <type> <pattern1> <pattern2>: Color gradients and transitions

🛠️ Builder Utilities

• /drain [water|lava]: Removes water or lava from the selection
• /overlay <block>: Places blocks on surfaces within the selection
• /dome <radius> <pattern>: Creates domes (hemispheres)
• /cone <radius> <height> <pattern>: 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 <water|lava>: 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 <degrees>: Rotate the clipboard content
• /flip <axis>: Mirror the clipboard content
• /move <dx> <dy> <dz>: 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 <pattern>: 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 <name>: Save the current selection as a schematic
• /schem load <name>: Load and place a schematic
• /schem list: Show all available schematics
• /schem preview <name>: 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:

# 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:

// 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:

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:

   # 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

# Selection tools
/wand              # Get wooden axe
/pos1              # Current position as Pos1
/pos2              # Current position as Pos2
/size              # Show selection size

# Basic operations
/set <block>       # Fill selection
/replace <from> <to> # Replace blocks
/copy              # Copy selection
/paste             # Paste
/undo              # Undo
/redo              # Redo
/info              # Show selection information

# Builder utilities
/drain [water|lava]     # Remove water/lava
/overlay <block>        # Place blocks on surfaces
/dome <radius> <block> # Create dome
/cone <radius> <height> <block> # Create cone
/green [density]        # Place vegetation
/snow [thickness]       # Add snow
/thaw                  # Remove snow/ice
/extinguish            # Extinguish fire
/butcher [radius]       # Remove entities
/fillfluid <water|lava> # 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

/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+