OptiX

A PaperMC server performance plugin designed for low-end hardware and free-tier hosting. Uses adaptive tick governance, chunk degradation, packet optimization, and OpenCL GPU compute to squeeze maximum performance out of limited resources.

Features

Tick Governor

• Adaptive Tick Throttling — dynamically scales back subsystems under load
• Budget Allocator — distributes MSPT budget across features
• Server State Tracking — detects and reacts to lag spikes proactively

Performance Optimizers

Module	Description
Entity AI Optimizer	Reduces CPU cost of mob AI ticking
Projectile Tick Manager	Throttles projectile updates
Item Entity Optimizer	Merges/limits ground items
Vehicle Processor	Optimizes minecart/boat physics
Hopper Batcher	Coalesces item transfers into batches
Redstone Controller	Rate-limits redstone updates
Particle Limiter	Caps particle effects
Mob Cap Manager	Dynamic mob cap enforcement
Block Entity Tick Scheduler	Schedules tile entity ticks
Player View Distance Manager	Per-player adaptive render distance
Memory Manager	GC-aware memory pressure handling
Tick Budget Enforcer	Hard MSPT limits per subsystem

Chunk Management

• Chunk Heat Map — tracks chunk activity with configurable decay
• Chunk Degradation — gradually reduces processing in cold chunks (random tick, mob AI, hopper, block update)
• Spawn Preloading — batches chunk loads around world spawn

Packet Optimization

• Packet Throttle Manager — rate-limits redundant network traffic
• Packet Optimizer — reduces packet overhead
• Mob Spawn Throttle — prevents client packet bursts during low TPS
• Entity Packet Smoother — staggers entity spawn packets on player join

Monitoring

• Lag Monitor — real-time MSPT/TPS tracking
• Server Metrics Collector — resource usage stats
• GC Monitor — garbage collection metrics
• Stress Predictor — proactive load forecasting
• Tile Entity Tracker — tracks active tile entities

GPU Compute (OpenCL)

• GPU Mob Processor — offloads mob pathfinding to GPU
• GPU Update Pipeline — batched GPU compute tasks
• OpenCL integration via JOCL (Java OpenCL bindings)

Commands

• /opt — main command interface
• /status — live server performance dashboard
• /governor — tick governor controls
• /entity — entity management
• /chunk — chunk management

Requirements

• PaperMC 1.18.2+
• Java 17+
• PacketEvents 2.9.3 (optional, for packet features)
• OpenCL runtime (optional, for GPU features)

Build

./gradlew shadowJar

Output: build/libs/OptiX-<version>-all.jar

License

12Tae12 Protective License, see here.