Paper 1.21+  ·  Java 8+  ·  Folia ready

The Ultimate
Server Optimisation
Plugin

PerformanceX is a single plugin that replaces a dozen. 23 modules covering lag control, block logging, auto-backup, world pre-gen, custom item timers, benchmarking, and more — all configurable, hot-reloadable, and free.

Download PerformanceX Explore modules
PerformanceX v1.0.0
│ Platform · Paper 1.21.8
│ Modules · 23/23 enabled
│ Hooks · 16/16 active
 
TPS · 20.0 / 20.0 / 20.0
MSPT · 2.3ms
RAM · 1.4 GB / 4 GB
23
Optimisation Modules
16
Plugin Integrations
1
Plugin to Install
0ms
Reload Downtime
Free
Always
Modules

Everything your server needs

Every module is independently enabled, disabled, and hot-reloaded. Enable only what you need.

🧹

Item Clear

Scheduled ground-item sweeps with countdown warnings, family grouping, per-world control, and bypass permissions. Configurable include/exclude lists.

/px clear
⏱️

Item Despawn

Per-type custom despawn timers with floating hologram labels. Rarity tiers (legendary → common) with animated gradient text, particles, and sounds.

/px despawn
🐾

Mob Clear

Cap-based mob clearing with family detection, configurable warnings, world scope, and preview before clearing so you know exactly what will be removed.

/px clear mobs
🧠

Mob AI Throttler

Reduces AI tick frequency for distant or over-capped mobs. Configurable thresholds for full AI, reduced AI, and no AI — per mob family.

/px mobai
🐣

Spawn Limiter

Hard caps on passive, hostile, and aquatic spawns per world. Prevents lag spikes from spawn storms without nuking all your mobs.

/px spawns
💥

Anti-Lag Machine

Detects and suppresses common lag machines — flying machine patterns, hopper clocks, and entity cramming traps — without banning redstone outright.

/px lagmachine
📦

Chunk Manager

Aggressively unloads idle chunks, limits loaded chunk counts per world, and throttles chunk loading to keep memory under control.

/px chunks
🌾

Farm Limiter

Limits spawner output, crop growth ticks, and fluid spread in high-density farm areas. Keeps redstone farms from crushing your TPS.

/px farm
⚙️

Tile Entity Throttler

Reduces tick rates for hoppers, furnaces, and other tile entities when counts exceed configurable thresholds.

/px tiles
🏃

Collision Limiter

Activates a low-lag collision mode when TPS drops below a threshold, disabling player–player collision to reduce entity processing overhead.

/px collision
🧲

Item Merge

Expands the merge radius for ground items so stacks combine faster, dramatically reducing entity counts in high-loot areas.

Auto
🔍

Block Logger

CoreProtect-style block and container logging backed by embedded SQLite. Full lookup, inspect mode (click-to-query), and time-based rollback with WorldEdit selection support.

/px log
💾

Auto Backup

Scheduled ZIP backups of worlds and plugins with configurable storage backends (local, S3). Compression, retention, and live progress updates.

/px backup
🔄

Auto Restart

Scheduled restarts with countdown warnings, admin-presence cancel, backup delay integration, and launcher marker-file support for instant restarts.

/px restart
🌍

World Pre-Gen

Async chunk pre-generation with square/circle/diamond patterns, live progress, pause/resume, persistence across restarts, and Terra/Iris generator detection.

/px pregen
📊

Performance Monitor

Real-time TPS, MSPT, memory, entity counts, and hardware stats (CPU, RAM, OS, JVM) in a clean in-chat panel.

/px monitor
🏎️

Benchmark

CPU (single + multi-thread), RAM throughput, disk read/write, and network speed test. Estimates realistic concurrent player capacity for your hardware.

/px benchmark
🪝

Webhooks

Discord (and generic HTTP) webhook notifications for restarts, backups, player join/leave, and lag events. Fully templated payloads.

/px webhook
🔔

Notifications

Pluggable notification channels (chat, title, actionbar, bossbar) used by other modules for warnings and announcements.

/px notify
🔴

Redstone Limiter

Rate-limits redstone updates in dense areas. Configurable update budget per chunk per tick prevents cascading update loops.

/px redstone
💀

Mob Despawn

Custom per-family mob despawn ranges and timers. Prevents wilderness mob pileup while keeping named / tamed mobs safe.

/px mobdespawn
🌐

Speed Test

In-game network speed probe — download and upload — so you can verify your server's connection from within Minecraft without SSH.

/px speedtest
📁

Log Manager

Rotates, archives, and prunes server logs automatically. Prevents the logs/ directory from growing unbounded on busy servers.

/px logs
Featured Module

Block Logger & Rollback

Know exactly who did what, and undo it.

PerformanceX ships a full CoreProtect-style block logger backed by embedded SQLite — no external database required. Every block break, placement, and container interaction is recorded and queryable in seconds.

  • Click any block in inspect mode to see its full history
  • Roll back a player's actions by time, radius, or WorldEdit selection
  • Preview before applying — two-step confirm flow prevents accidents
  • Restore previously rolled-back blocks
  • Auto-purge old entries on a configurable schedule
  • Container take/put logging for chest grief detection
# Inspect a block — just click it
/px log inspect on
 
# Roll back a griefer's last 2 hours
/px log rollback 2h p:Griefer
 
# Roll back in a 50 block radius
/px log rollback 1h r:50
 
# Use WorldEdit selection as area
/px log rollback 6h --sel
 
# Apply the preview
/px log rollback confirm
 
# Check history of a specific player
/px log lookup Steve t:1d a:break
Featured Module

Item Despawn & Rarity Labels

# item-rarity.yml — custom tier definitions
tiers:
  legendary:
    display: "<gradient:#FFD700:#FF6B35>Legendary"
    label_frames:
      - "✦ <name> ✦ <time>"
      - "★ <name> ★ <time>"
    drop_sound: ENTITY_ENDER_DRAGON_GROWL
 
# item-despawn.yml — per-type timers
defaults:
  duration_seconds: 300
overrides:
  minecraft:diamond:
    duration_seconds: 1800
  minecraft:netherite_ingot:
    duration_seconds: -1 # never

Give every item its own destiny.

Configure exactly how long each item type lives on the ground — from 5 seconds for junk to never-expire for netherite. A floating hologram label counts down in real-time above every tracked item.

  • Per-material, per-world, and global default timers
  • Animated rarity labels — legendary items get a gold shimmer effect
  • Particles and custom sounds on legendary/epic drops
  • Labels hide when no players are nearby to save render budget
  • Compatible with RoseStacker, ItemsAdder, and DropHeads
  • Timers survive server restarts via PDC persistence
Commands

One plugin, clean commands

All commands live under /px. Every module registers its own sub-command when it loads.

Core
/px helpgrouped command reference
/px moduleslist all modules + status
/px reload [module]hot-reload config
/px enable <module>enable a module
/px disable <module>disable a module
/px versionplatform info
/px debug [section]live diagnostics
Performance
/px monitorTPS, MSPT, hardware
/px statusmodule summary
/px benchmark runfull CPU/RAM/disk/net
/px benchmark quickCPU + RAM only
/px speedtestnetwork speed probe
Block Logger
/px log inspect [on|off]click-to-query mode
/px log lookup <player>search history
/px log rollback <time>preview undo
/px log rollback confirmapply rollback
/px log restore <player>undo rollback
/px log statusDB size & entries
/px log purge [days]delete old entries
Clearing
/px clear itemsclear ground items
/px clear mobsclear mobs
/px clear entitiesall entity types
/px clear allitems + mobs + entities
/px clear items here <r>radius clear
Server Management
/px backup nowimmediate backup
/px backup statusschedule & backends
/px backup progresslive progress
/px restart now10s countdown restart
/px restart in <time>schedule restart
/px restore listbrowse backups
World
/px pregen start <world> <r>start pre-gen
/px pregen pausepause job
/px pregen resumeresume job
/px pregen statusprogress + ETA
/px pregen cancelstop job
Integrations

Works with your existing plugins

PerformanceX detects compatible plugins at startup and enables deeper integration automatically — no extra config required.

WorldEdit
Lands
PlaceholderAPI
RoseStacker
ItemsAdder
DropHeads
TreeFeller
VeinMiner
Multiverse
FancyWaystones
ArmorStandTools
ArmoredElytra
SafariNet
XPickup
Terra
Iris
Configuration

One config per module

Every module gets its own YAML file in plugins/PerformanceX/modules/. Enable or disable modules in the root config.yml.

# config.yml — master module toggles
modules:
  item-clear: true
  item-despawn: true
  mob-ai-throttler: true
  spawn-limiter: true
  anti-lag-machine: true
  block-logger: true
  auto-backup: true
  auto-restart: true
  world-pregen: true
  benchmark: true
  # ... 13 more modules

Designed for server admins, not developers.

Every option is documented inline. Every module can be hot-reloaded without restarting the server. Wrong config? /px reload and it's fixed instantly.

  • All config files auto-generated on first run
  • Hot-reload any single module with /px reload <id>
  • Per-world overrides supported across multiple modules
  • MiniMessage formatting in all user-facing messages
  • Granular permission nodes per command
  • PlaceholderAPI expansion included
Permissions

Granular permission nodes

PermissionDescriptionDefault
performancex.adminFull access to all PX commandsop
performancex.command.logBlock Logger lookup & statusop
performancex.command.rollbackLog rollback & restoreop
performancex.command.backupBackup commandsop
performancex.command.restartRestart schedulingop
performancex.command.pregenWorld pre-generationop
performancex.command.benchmarkHardware benchmarkop
performancex.command.monitorPerformance monitorop
performancex.command.clearManual clear commandsop
performancex.bypass.itemclearItems near this player are protected from clearsfalse
performancex.bypass.itemdespawnDropped items bypass custom despawn timersfalse

Free. Forever.

Drop the JAR in your plugins/ folder, start your server, and every config file is generated automatically. No licence keys, no accounts.

The Launcher is optional — use it for automatic crash-restart and clean restart-without-crash signalling.
Requires Paper (or a Paper fork) 1.21 or later.