UltraOptimize

A powerful, comprehensive optimization plugin for Minecraft servers (Spigot/Paper) that automatically manages chunks, entities, and performance to keep your server running smoothly.

🚀 Features

Core Optimization

• Auto-Optimization: Automatically removes excess entities when TPS drops
• Smart Entity Management: Merge nearby items and XP orbs to reduce lag
• Chunk Management: Intelligent chunk loading/unloading with aggressive cleanup
• Performance Monitoring: Real-time TPS tracking and memory management
• Spawn Chunk Preloading: Preload spawn chunks in spiral or square patterns Paper-Specific Features
• Region File Optimization: Defragment and clean region files
• Watchdog Monitor: Automatic hang detection with emergency mode
• Incremental Saving: Reduce lag from world saves Entity Optimization
• Clear items, mobs, XP orbs, and arrows
• Automatic item merging within configurable radius
• Exempt specific entity types from removal
• Per-chunk entity limits with spawn blocking Chunk Features
• Aggressive chunk unloading for empty chunks
• Configurable unload radius around players
• Async chunk loading support (1.13+)
• Chunk preloading with configurable patterns
• Max loaded chunks limit Performance Features
• Redstone optimization (limit excessive updates)
• Hopper optimization with tick rate adjustment
• Dynamic view distance adjustment (1.14+)

📋 Requirements

1. Minecraft: 1.13+
2. Server: Spigot (recommended), Paper (recommended), or compatible forks
3. Java: 8 or higher

📦 Installation

1. Download the latest UltraOptimize.jar from releases
2. Place it in your server's plugins folder
3. Start or restart your server
4. Configure settings in plugins/UltraOptimize/config.yml
5. Reload with /uo reload

🎮 Commands

Basic Commands

• /uo or /ultraoptimize - Show help menu
• /uo reload - Reload configuration
• /uo stats - Show detailed server statistics
• /uo info - Show plugin configuration
• /uo report - Generate performance analysis report Optimization Commands
• /uo optimize - Run manual optimization
• /uo auto - Toggle auto-optimization on/off
• /uo gc - Force garbage collection
• /uo merge - Merge nearby items and XP orbs Entity Commands
• /uo clear items - Remove all dropped items
• /uo clear mobs - Remove all hostile mobs
• /uo clear xp - Remove all XP orbs
• /uo clear arrows - Remove all arrows
• /uo clear all - Remove all entities (except players) Chunk Commands
• /uo chunks unload - Unload empty chunks
• /uo chunks info - Show chunk statistics
• /uo preload info - Show preloading status
• /uo preload restart - Restart spawn chunk preloading Paper-Only Commands
• /uo paper stats - Paper optimization statistics
• /uo paper optimize - Run Paper optimization
• /uo paper watchdog status - Watchdog monitor status
• /uo paper watchdog reset - Reset hang counter
• /uo paper regions stats - Region file statistics
• /uo paper regions optimize [world] - Optimize region files
• /uo paper regions clean [world] - Remove empty region files

🔐 Permissions

• ultraoptimize.* - All permissions
• ultraoptimize.reload - Reload configuration
• ultraoptimize.clear - Clear entities
• ultraoptimize.optimize - Run optimizations
• ultraoptimize.stats - View statistics
• ultraoptimize.chunks - Manage chunks
• ultraoptimize.preload - Chunk preloading commands
• ultraoptimize.gc - Force garbage collection
• ultraoptimize.auto - Toggle auto-optimization
• ultraoptimize.merge - Merge entities
• ultraoptimize.view - Manage view distance
• ultraoptimize.report - Generate reports
• ultraoptimize.info - View plugin info
• ultraoptimize.paper - Paper-specific commands
• ultraoptimize.notify - Receive optimization notifications

please refer to the wiki for more information.