PerformanceX 1.0.28

PerformanceX

The all-in-one performance suite for Minecraft servers.





Folia · Paper · Spigot · Purpur · MC 1.8.8 — 26.1.x · Java 8+

What is PerformanceX?

PerformanceX is a modular server performance suite — 29 independent modules that replace a dozen separate plugins with a single, zero-dependency JAR. Every module is self-contained: enable what you need, disable what you don't. No module depends on another. No restarts required to toggle anything.

It ships with smart defaults that work immediately on most servers. If a ClearLagg replacement is all you need, two modules and you're done. If you want AI throttling, lag machine detection, automatic backups, block logging, and Discord webhooks — it does all of that too. If you are genuinely struggling with LAG on your server! Just throw PerformanceX on there and it should do the job without you needing to configure it. It does the job for most communities out there as it's designed around Survival servers by default. Configure it to your hearts content. It's powerful and does exactly what most servers NEED! Completely free!

Drop it in. Run `/px status`. You're done.

⏱ Item Despawn — The Headline Feature

Per-item-type configurable despawn timers with a floating countdown label hovering above every dropped item in real-time. The label shows item name, stack count, and time remaining.

Four rarity tiers come pre-configured:

Everything else uses the default 5-minute timer. Every timer is configurable per item type, per world, and per integration.

Label rendering — picks the best automatically:

1. 
   

   text_display

   
   
   — native TextDisplay entities (MC 1.19.4+, cleanest)
2. 
   

   armor_stand

   
   
   — invisible ArmorStand fallback, works back to 1.8.8
3. 
   

   custom_name

   
   
   — item entity nametag, zero extra entities
4. 
   

   auto

   
   
   — selects best option for your server version at startup

Label format is fully MiniMessage-customizable:

label_format: " x | "
renderer: auto   # text_display → armor_stand → custom_name

Smart integrations:

1. Timer resets when RoseStacker/StackMob stack size changes
2. Per-world duration overrides (resource world = 30s, End = 10m)
3. Labels auto-hide when no player is in range (bandwidth savings)
4. Per-custom-item keys for ItemsAdder, DropHeads, ArmoredElytra, TreeFeller, Veinminer

🧹 Item Clear — ClearLagg Replacement

Scheduled and on-demand ground item removal that won't eat your valuables.

schedule: "every 15m"
warnings: ["5m", "1m", "30s", "10s", "5s"]
include: ["minecraft:*"]
exclude:
  - "minecraft:nether_star"
  - "minecraft:diamond"
  - "itemsadder:*"

1. Per-type include/exclude with wildcards (
   
   
   

   minecraft:netherite_*

   
   
   )
2. Lands-claim awareness — items inside claimed land are never cleared
3. Bypass-permission proximity guards — items near staff are protected
4. 
   

   /px clear

   
   
   ·
   
   
   

   /px clear here 64

   
   
   ·
   
   
   

   /px clear world

   
   

⊕ Item Merge

Actively merges nearby identical ground items into stacks on a configurable sweep interval. Vanilla only merges at spawn — this catches items that land apart and wouldn't otherwise combine.

1. Configurable merge radius (default: 8 blocks, cross-chunk)
2. Respects max stack sizes per item type
3. Blacklist specific materials (enchanted books, etc.)
4. Players get every item — there are just fewer ground entities

🕐 Mob Despawn

Per-mob-type despawn timers with smart skip rules that protect every mob that matters:

1. Named mobs (nametag or plugin), tamed animals, leashed mobs
2. Mobs in vehicles, carrying passengers, or with the vanilla persistent flag
3. SafariNet captures, Lands-claimed mobs

minecraft:phantom:    90
minecraft:zombie:     300
minecraft:pillager:   600

🗑 Mob Clear

Hard caps per chunk by mob family with intelligent culling:

Shares skip rules with Mob Despawn — a protected mob is never cleared.

🧠 Mob AI Throttler — 30-50% TPS Savings

Mob AI accounts for 30-50% of server tick time. This module disables AI for mobs far from players using three configurable distance zones:

Per-family overrides — tune hostile, passive, villager, and boss ranges independently.

Lag-aware mode: When TPS drops below 16.0, all ranges automatically shrink — more mobs freeze, server recovers. Zones restore when TPS recovers.

Always exempt: Named, tamed, leashed, and boss mobs (Wither, Ender Dragon) always have full AI regardless of distance.

🐾 Spawn Limiter

Per-chunk spawn budgets — prevents mob accumulation before it starts instead of cleaning up after.

📦 Entity Limiter

Per-chunk or per-world caps for non-mob entities:

XP Orb Merging: Nearby orbs merge into one with the combined value.

💥 Collision Limiter

Disables entity-entity collision checks for configurable types.

1. Always disabled: Armor Stands, Item Frames, Dropped Items, Projectiles
2. Lag-aware: TPS < 16.0 disables all mob collisions automatically

⚡ Redstone Limiter

Detects and throttles redstone clocks and high-frequency circuits.

🚨 Lag Actions — 3-Tier Auto-Response

📊 Performance Monitor

Live dashboard via

/px monitor

:

1. TPS — 1m, 5m, 15m rolling averages
2. MSPT — milliseconds per tick
3. Heap — JVM memory usage
4. Entities — total loaded entities
5. Chunks — total loaded chunks

💾 Auto Backup

Scheduled world backups to 5 storage backends simultaneously:

📋 Block Logger

CoreProtect-style activity logging with SQLite + MySQL support.

/px log lookup x:100 y:64 z:200 r:10 t:1h
/px log rollback player:Steve r:20 t:7d

🔔 Webhooks

Real-time notifications for 20 event types to Discord, Slack, or any HTTP endpoint.

📱 Geyser Support — Bedrock Compatibility

PerformanceX automatically adapts entity rendering for Bedrock players.

🌐 16 Integrations

1. RoseStacker
2. StackMob
3. ItemsAdder
4. DropHeads
5. SafariNet
6. Lands
7. WorldGuard
8. PlaceholderAPI
9. LuckPerms
10. Vault
11. EssentialsX
12. MythicMobs
13. Citizens
14. Dynmap / BlueMap
15. Folia
16. ProtocolLib

📊 PlaceholderAPI Placeholders

%performancex_tps%

%performancex_mspt%

%performancex_entities%

Permissions

performancex.admin

performancex.notifications

Configuration

PerformanceX uses a simple three-file pattern:

[LIST=1]

config.yml

— master module toggles

modules/.yml

— per-module settings

worlds/.yml

— per-world overrides

/px reload

— apply changes instantly
[/LIST]

modules:
  item-despawn: true
  item-clear: true
  mob-ai-throttler: true
  lag-actions: true
  auto-backup: true

Platform Support

Quick Start

[LIST=1]Drop

PerformanceX.jar

into your

plugins/

folderStart the serverRun

/px status

Edit configsRun

/px reload

[/LIST]

Statistics