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

No gallery available for this project.

Version	Minecraft	Loader	Download
XreatOptimizer 1.2.1 1.2.1	1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11	paper, purpur, spigot	Download
XreatOptimizer 1.2.0 1.2.0	1.8, 1.8.1, 1.8.2, 1.8.3, 1.8.4, 1.8.5, 1.8.6, 1.8.7, 1.8.8, 1.8.9, 1.9, 1.9.1, 1.9.2, 1.9.3, 1.9.4, 1.10, 1.10.1, 1.10.2, 1.11, 1.11.1, 1.11.2, 1.12, 1.12.1, 1.12.2, 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11	paper, purpur, spigot	Download
XreatOptimizer 1.1.0 1.1.0	1.8, 1.8.1, 1.8.2, 1.8.3, 1.8.4, 1.8.5, 1.8.6, 1.8.7, 1.8.8, 1.8.9, 1.9, 1.9.1, 1.9.2, 1.9.3, 1.9.4, 1.10, 1.10.1, 1.10.2, 1.11, 1.11.1, 1.11.2, 1.12, 1.12.1, 1.12.2, 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10	paper, purpur, spigot	Download