🧠 RamOptimiserX

Advanced RAM & JVM Memory Optimization for Minecraft Servers

RamOptimiserX is an advanced, lightweight and adaptive memory-management plugin for Minecraft servers running Paper and Folia.

It continuously monitors JVM memory usage, garbage collection, memory pressure and server performance, then performs safe optimization of resources that the plugin can actually control.

Monitor. Analyze. Optimize. Stabilize.

RamOptimiserX does not pretend that repeatedly calling System.gc() can magically free all server RAM. Instead, it focuses on real memory-management techniques such as cache cleanup, resource lifecycle management, bounded history, memory-pressure detection and adaptive workload control.

---

🚀 Core Features

🧠 Advanced JVM Memory Monitor

Monitor real JVM memory statistics:

• Used Heap
• Committed Heap
• Maximum Heap
• Free Heap
• Heap Utilization
• Non-Heap Memory
• Metaspace
• Memory Pools
• Garbage Collection Count
• Garbage Collection Time
• JVM Uptime

View current information with:

/ramx status

---

📊 Intelligent Memory Pressure Detection

RamOptimiserX calculates the current memory-pressure state using multiple JVM metrics.

NORMAL
LOW
MEDIUM
HIGH
CRITICAL

The system can consider:

• Heap utilization
• Memory growth rate
• GC frequency
• GC duration
• Memory pool pressure
• Available heap
• Recent server performance

This prevents the plugin from reacting aggressively to a single temporary memory spike.

---

⚡ Adaptive Optimization

RamOptimiserX automatically changes its optimization intensity depending on the server's current memory condition.

NORMAL
   ↓
Light monitoring

LOW
   ↓
Normal optimization

MEDIUM
   ↓
Increase safe cleanup

HIGH
   ↓
Aggressive safe resource cleanup

CRITICAL
   ↓
Emergency memory management

When memory pressure becomes severe, RamOptimiserX can also reduce its own background workload so the optimizer does not become another source of server lag.

---

🧹 Safe Resource Cleanup

RamOptimiserX can safely manage resources owned by the plugin itself.

Examples:

• Expired cache entries
• Temporary data
• Internal queues
• Old tracking data
• Expired snapshots
• Bounded history
• Unused internal objects

It does not randomly clear memory belonging to other plugins.

---

♻️ Smart Cache Management

RamOptimiserX uses controlled caches with:

• Maximum sizes
• TTL expiration
• Automatic cleanup
• Memory-pressure cleanup
• Bounded storage
• Automatic stale-entry removal

This prevents the plugin itself from becoming a source of memory growth.

---

🔍 Memory Growth Detection

The plugin monitors memory trends over time.

Example:

2.1 GB
2.3 GB
2.5 GB
2.7 GB
2.9 GB
3.1 GB

If memory continues growing abnormally across multiple GC cycles, RamOptimiserX can report:

POSSIBLE_MEMORY_GROWTH

It does not falsely claim that a confirmed memory leak exists when the JVM simply has not returned memory to the operating system.

---

♻️ Garbage Collection Monitoring

Monitor:

• GC collections
• GC duration
• Collection frequency
• GC pressure
• Memory before/after GC

States:

NORMAL_GC
HIGH_GC
GC_PRESSURE
SEVERE_GC_PRESSURE

Important

RamOptimiserX does not spam System.gc().

Manual GC is optional and disabled by default.

The plugin prioritizes safe resource cleanup and allocation reduction over forced garbage collection.

---

📈 Memory History

Maintain bounded rolling memory history.

Available time windows:

1 Minute
5 Minutes
15 Minutes
30 Minutes
1 Hour

The history uses bounded storage so the monitoring system itself cannot grow indefinitely.

---

📸 Memory Snapshots

Create a snapshot using:

/ramx snapshot

Snapshots can contain:

• Timestamp
• Used Heap
• Committed Heap
• Maximum Heap
• Heap Usage %
• GC Count
• GC Time
• Memory Pools
• TPS
• MSPT
• Memory Pressure

Snapshots are stored inside:

plugins/RamOptimiserX/snapshots/

---

📋 Detailed Memory Reports

Generate a complete server memory report:

/ramx report

Example:

RamOptimiserX Memory Report
────────────────────────────

Heap
Used:       3.10 GB
Committed:  4.00 GB
Maximum:    8.00 GB
Usage:      38.7%

GC
Collections: 124
GC Time:     4.2s

Pressure:
NORMAL

TPS:
19.97

MSPT:
28

Optimization:
ACTIVE

---

🚨 Emergency Memory Mode

When the server reaches critical memory pressure, RamOptimiserX can enter:

EMERGENCY MEMORY MODE

It can:

• Clean expired internal caches
• Remove temporary plugin data
• Reduce internal monitoring workload
• Reduce unnecessary background processing
• Create a memory snapshot
• Alert administrators
• Record the memory event

It will NOT:

❌ Delete worlds ❌ Delete chunks ❌ Delete player data ❌ Delete inventories ❌ Kill plugins ❌ Randomly remove mobs ❌ Randomly remove farms ❌ Force unlimited garbage collection

---

🌍 Chunk Memory Monitoring

RamOptimiserX can monitor:

• Loaded chunks
• Chunk growth
• Per-world chunk counts
• Chunk activity
• Memory pressure related to chunk growth

Important

High RAM usage does not automatically mean chunks should be unloaded.

The plugin avoids blindly unloading chunks required by:

• Players
• Farms
• Redstone
• Plugins
• Force-loaded systems
• Active gameplay

---

👾 Entity Memory Monitoring

Monitor entity growth and density.

Examples:

• Dropped items
• XP orbs
• Minecarts
• Boats
• Mobs
• Falling blocks
• Projectiles

If unusual growth is detected, RamOptimiserX can notify administrators.

It does not use random entity deletion as a fake RAM optimization method.

---

📊 Server Performance Correlation

RamOptimiserX can correlate memory pressure with:

• TPS
• MSPT
• GC time
• Entity count
• Chunk count

Example:

Memory:
78% → 87% → 94%

GC:
Increasing

MSPT:
30 → 55 → 90

Result:
CRITICAL MEMORY PRESSURE

This provides a more useful picture than looking at RAM percentage alone.

---

⚡ Manual Optimization

Run:

/ramx optimize now

RamOptimiserX performs safe optimization of resources under its control.

After optimization it reports actual measurements.

Example:

Before:
Used Heap: 4.21 GB

Internal cleanup:
142 MB of plugin-owned data released

After:
Used Heap: 4.08 GB

Actual JVM memory reclamation remains dependent on the JVM's garbage collector.

---

🛡️ Gameplay Safety

RamOptimiserX is designed to optimize memory without breaking normal Minecraft gameplay.

It does NOT optimize RAM by blindly deleting:

• Farms
• Crops
• Villagers
• Redstone
• Pistons
• Hoppers
• Storage systems
• Player entities
• Important mobs
• Minecarts
• Boats

Memory management is resource-based, not destructive gameplay manipulation.

---

🎮 Commands

/ramx
/ramx status
/ramx optimize
/ramx optimize now
/ramx memory
/ramx gc
/ramx gcinfo
/ramx snapshot
/ramx snapshots
/ramx report
/ramx plugins
/ramx history
/ramx reload
/ramx debug
/ramx version

Alias:

/ramoptimiserx

---

🔐 Permissions

ramoptimiserx.admin
ramoptimiserx.status
ramoptimiserx.optimize
ramoptimiserx.snapshot
ramoptimiserx.report
ramoptimiserx.reload
ramoptimiserx.debug

---

🌐 Paper & Folia

RamOptimiserX is designed for:

Paper

Minecraft 1.21.x → 26.2

Folia

Minecraft 1.21.x → 26.2

The plugin uses platform-aware scheduling and respects Folia's regionized threading architecture.

---

⚡ Lightweight Architecture

RamOptimiserX is designed to have minimal overhead.

It avoids:

• Full-world scans every tick
• Unlimited tasks
• Unlimited threads
• Unlimited history
• Continuous forced GC
• Constant entity enumeration
• Constant chunk scanning
• Large blocking operations

Instead it uses:

• Lightweight JVM monitoring
• Rolling counters
• Bounded collections
• Adaptive intervals
• Rate limiting
• Safe asynchronous processing
• Platform-aware scheduling

---

🔧 Configuration

Everything is configurable through:

plugins/RamOptimiserX/config.yml

You can configure:

• Memory thresholds
• Monitoring intervals
• Cleanup intervals
• GC monitoring
• Automatic optimization
• Emergency mode
• Snapshot retention
• Alerts
• Debug mode

---

🎯 Design Philosophy

MONITOR
   ↓
ANALYZE
   ↓
IDENTIFY PRESSURE
   ↓
CLEAN SAFE RESOURCES
   ↓
MEASURE AGAIN
   ↓
ADAPT

RamOptimiserX does not blindly change server behavior.

It attempts to identify actual memory pressure first, then applies the safest available optimization.

---

⚠️ Important

RamOptimiserX cannot magically make a server use less RAM than the JVM requires.

Actual memory usage depends on:

• Java version
• JVM configuration
• Server software
• Player count
• Worlds
• Chunks
• Entities
• Plugins
• Mods
• Farms
• Server configuration
• Garbage collector

For best results, use RamOptimiserX together with a properly configured JVM and optimized Paper/Folia server configuration.

Always maintain regular backups.

---

📦 Compatibility

Minecraft: 1.21.x → 26.2

Platforms:

• Paper
• Folia

Plugin: RamOptimiserX

Author: Craftury