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