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
# 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 |
/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
mvn clean package
Requires Maven and Java 21+.
License
See LICENSE file.
Download: SpigotMC | Website: xreatlabs.space
