XreatOptimizer

# XreatOptimizer > Advanced performance optimization for Minecraft servers (1.8-1.21.11+) XreatOptimizer is a Bukkit/Spigot performance plugin that improves server TPS through intelligent runtime adjustments. It uses a **Level 2 control loop** to coordinate multiple optimization systems based on real-time server metrics. --- ## Quick Facts | | | |---|---| | **Supported Versions** | Minecraft 1.8 - 1.21.11+ | | **Server Types** | Spigot, Paper, Purpur, and forks | | **Java Required** | Java 11+ runtime (Java 21+ recommended for 1.21.x) | | **Memory Footprint** | ~5-10MB base + monitoring overhead | ## What It Does - **Monitors** TPS, memory, entities, chunks in real-time - **Adjusts** optimization profile automatically based on server load - **Lowers** view distance when server is under pressure - **Activates** low-power mode when server is empty - **Merges** nearby dropped items and XP orbs (optional) - **Removes** old items with countdown warnings (optional) - **Provides** web dashboard and Prometheus metrics (optional) ## Safe by Default Riskier features are **disabled by default**. You must explicitly enable them. **Enabled:** - Performance monitoring - Automatic profile management - Memory saver - Dynamic view distance - Empty-server low-power mode **Disabled (opt-in):** - Item removal - Auto clear - Hibernation - Predictive loading - Redstone/hopper optimization - Dashboard & Prometheus - AI throttling - Automatic chunk unloading - Stack fusion ## Installation ``` 1. Put XreatOptimizer.jar in plugins/ 2. Restart server 3. Edit plugins/XreatOptimizer/config.yml (optional) 4. Run /xreatopt stats to verify ``` ## Commands | Command | Description | |---|---| | `/xreatopt stats` | Show live performance metrics | | `/xreatopt report` | Quick performance summary | | `/xreatopt boost` | Run manual optimization pass | | `/xreatopt reload` | Reload configuration | | `/xreatgui` | Open control panel | **Aliases:** `/xreat`, `/xopt`, `/xoptgui` ## Permissions | Permission | Default | Description | |---|---|---| | `xreatopt.view` | op | View stats and use GUI | | `xreatopt.admin` | op | Use admin commands | ## Configuration ```yaml # Core level2_control: enabled: true # Empty server mode empty_server: enabled: true delay_seconds: 30 # Optional features (disabled by default) item_removal: enabled: false auto_clear: enabled: false hibernate: enabled: false predictive_loading: enabled: false web_dashboard: enabled: false metrics: prometheus: enabled: false advanced_entity_optimizer: stack_fusion: false ``` ## Web Dashboard When enabled, the dashboard serves: | Endpoint | Description | |---|---| | `/` | Main dashboard | | `/api/stats` | Current metrics (TPS, memory, entities, etc.) | | `/api/history` | Historical data (`?range=recent|hourly|daily`) | | `/api/config` | Feature flags and thresholds | | `/api/system` | Server overview | **Authentication:** Set `web_dashboard.auth_token` to require authentication via `?token=YOUR_TOKEN` or `Authorization: Bearer YOUR_TOKEN`. ## Common Questions **Q: Why does my server use so much RAM?** A: Java servers inherently use significant memory. The memory shown includes the entire JVM (heap + non-heap like JIT compilation, metaspace, thread stacks). XreatOptimizer's actual footprint is ~5-10MB. **Q: Will this delete my world data?** A: No. XreatOptimizer never deletes world data, chunks, or player data. It only adjusts runtime parameters like view distance and entity AI. **Q: Can I use this with other optimization plugins?** A: Test on a staging server first. Multiple optimization plugins can conflict. **Q: Does this work on the latest Minecraft version?** A: Yes. The plugin actively supports Minecraft 1.8 through 1.21.11+ on Spigot, Paper, and Purpur. ## Building ```bash mvn clean package ``` Requires Maven and Java 21+. ## License See LICENSE file. --- **Download:** (https://www.spigotmc.org/) | **Website:** (https://xreatlabs.space)