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.
