⚡ ServerOptimiserX

Advanced Adaptive Minecraft Server Optimization

ServerOptimiserX is a production-focused server optimization plugin designed to reduce unnecessary server workload, improve stability, and keep your Minecraft server running efficiently.

Built for Paper and Folia, ServerOptimiserX uses adaptive optimization instead of blindly applying aggressive limits.

Optimize the server — without breaking the server.

---

🚀 Features

🧠 Adaptive Optimization

ServerOptimiserX continuously monitors server performance and dynamically adjusts its own optimization workload.

It can adapt to:

• TPS
• MSPT
• CPU pressure
• Memory pressure
• Chunk activity
• Entity activity
• Server workload

When the server is healthy, optimization stays lightweight.

When server load increases, the optimizer automatically prioritizes the most important performance areas.

---

💾 Memory Optimization

Monitor and reduce unnecessary memory pressure through:

• Internal cache management
• Automatic cache expiration
• Memory-pressure detection
• Resource cleanup
• Plugin-owned memory management
• Leak-oriented monitoring
• Adaptive optimization intensity

ServerOptimiserX does not pretend that repeatedly calling System.gc() magically frees server RAM.

Instead, it focuses on preventing unnecessary memory usage and managing resources safely.

---

🗺️ Smart Chunk Optimization

Optimize chunk-related workload through:

• Unused chunk detection
• Chunk activity monitoring
• Adaptive chunk processing
• Chunk loading pressure detection
• Chunk generation monitoring
• Batch processing
• Player-chunk protection
• Spawn protection

The plugin avoids blindly unloading chunks that are actively required by players or gameplay systems.

---

👾 Entity Optimization

Monitor and optimize excessive entity activity.

Supported areas include:

• Dropped items
• XP orbs
• Minecarts
• Boats
• Projectiles
• Mob density
• Falling blocks
• Entity-heavy areas

Optimization is designed to avoid blindly removing important gameplay entities.

---

🔴 Redstone Monitoring

Detect excessive redstone activity and identify potential performance hotspots.

Monitor:

• Redstone activity
• Observer activity
• Repeater activity
• Comparator activity
• Piston activity
• Block-update pressure

Normal redstone systems are not automatically disabled.

---

🏗️ Hopper Optimization

Monitor hopper-heavy areas and excessive item-transfer activity.

Features include:

• Hopper activity monitoring
• Transfer pressure detection
• Hopper-heavy area detection
• Adaptive processing

Designed to preserve normal storage systems and farms.

---

🌍 World Optimization

Per-world optimization support.

Example:

worlds:
  world:
    enabled: true

  world_nether:
    enabled: true

  world_the_end:
    enabled: true

Each world can have its own optimization settings.

---

📊 Real-Time Performance Monitoring

Monitor:

• TPS
• MSPT
• CPU
• Memory
• GC activity
• Loaded chunks
• Entities
• Block entities
• Hopper activity
• Redstone activity
• Server workload

Use:

/sox status

to view the current server performance state.

---

⚙️ Adaptive Batch Processing

Expensive operations are processed in controlled batches instead of performing huge operations at once.

Example:

Low MSPT
→ More optimization work

Medium MSPT
→ Reduced batch size

High MSPT
→ Minimal optimization workload

Critical MSPT
→ Emergency-safe monitoring

This prevents ServerOptimiserX itself from becoming a source of lag.

---

🚨 Emergency Performance Mode

When severe server pressure is detected, ServerOptimiserX can enter an emergency optimization state.

Possible actions include:

• Reducing internal scan frequency
• Reducing batch sizes
• Cleaning internal caches
• Prioritizing critical monitoring
• Detecting major performance pressure
• Alerting administrators

The goal is to stabilize the server without destroying gameplay.

---

🛡️ Farm & Gameplay Safety

ServerOptimiserX is designed with gameplay safety in mind.

It avoids blindly modifying:

• Farms
• Redstone machines
• Storage systems
• Villagers
• Important entities
• Player-active chunks
• Protected gameplay areas

Aggressive/destructive actions are configurable and should not be enabled blindly.

---

🌐 Paper + Folia

ServerOptimiserX is designed for both:

Paper

and

Folia

with platform-specific scheduler handling.

Folia's regionized threading model is respected instead of assuming that every operation can run through a traditional global Bukkit scheduler.

---

🧩 Version Support

Target compatibility:

Minecraft 1.21.x → 26.2

Paper 1.21.x → 26.2

Folia 1.21.x → 26.2

Version-specific functionality uses capability detection where possible to reduce compatibility issues.

---

🎮 Commands

/sox
/sox status
/sox optimize
/sox optimize now
/sox memory
/sox chunks
/sox entities
/sox redstone
/sox pistons
/sox hoppers
/sox world
/sox plugins
/sox report
/sox reload
/sox debug

---

🔐 Permissions

serveroptimiserx.admin
serveroptimiserx.status
serveroptimiserx.optimize
serveroptimiserx.reload
serveroptimiserx.debug
serveroptimiserx.report

---

⚡ Designed to Stay Lightweight

ServerOptimiserX is designed to avoid:

• Full-world scans every tick
• Unlimited background tasks
• Unbounded caches
• Unsafe asynchronous world modifications
• Aggressive garbage collection calls
• Unsafe Folia operations
• Large blocking operations

The optimizer continuously manages its own workload.

---

📈 Performance Philosophy

ServerOptimiserX follows:

Measure
   ↓
Analyze
   ↓
Identify Bottleneck
   ↓
Optimize
   ↓
Measure Again
   ↓
Adapt

Instead of blindly changing everything, the plugin attempts to optimize areas that actually contribute to server workload.

---

⚠️ Important

ServerOptimiserX is not a replacement for proper server configuration, sufficient CPU/RAM, or optimized server software.

Performance improvements depend heavily on:

• Server hardware
• Player count
• World size
• Plugins
• Mods
• Farms
• Entity counts
• View distance
• Simulation distance
• World generation
• Server configuration

Do not expect a plugin to eliminate every possible source of lag.

---

🛠️ Recommended Usage

For the safest setup:

1. Install ServerOptimiserX.
2. Start with conservative optimization settings.
3. Monitor TPS/MSPT.
4. Check /sox status.
5. Enable additional optimization features gradually.
6. Review reports before enabling aggressive options.

Always maintain regular server backups.

---

📜 License

License: [Choose your preferred license]

© Craftury