PerformanceX

v1.1.70 — Fabric /px Command: Performance Module Management

The Fabric /px command now exposes performance modules alongside integrations.

New subcommands:

• /px status — TPS (1m/5m/15m) + heap usage, outputs to server console/log
• /px modules [filter] — lists all 28 performance modules with on/off state

Updated subcommands:

• /px enable <id> — now checks performance modules first, falls back to integrations
• /px disable <id> — same priority order

This brings the Fabric command on par with the Sponge /px command added in v1.1.69.

v1.1.69 — Sponge /px Command

Added the /px command handler for the Sponge platform using the native Sponge Command API.

Subcommands:

• /px — plugin version + active module count
• /px status — live TPS (1m/5m/15m), heap usage with color-coded indicators
• /px modules — lists all 20 modules with on/off state
• /px enable <id> — enable a module at runtime
• /px disable <id> — disable a module at runtime
• /px reload — reload config.yml and re-apply enabled/disabled states without restarting

Permission node: performancex.admin

Also added SpongeModuleManager.reload() which keeps the monitor's TPS history intact and never disables the monitor itself.

v1.1.68 — Sponge Platform Expansion (final batch)

Two more Sponge performance modules, completing the Sponge expansion:

• item-merge — merges nearby identical ground item stacks using Keys.ITEM_STACK_SNAPSHOT and ItemType grouping. Reduces entity count at mob farms and quarry sites.
• hopper-limiter — throttles hopper transfer rates by injecting an NMS cooldownTime delay via reflection on HopperBlockEntity. Respects per-chunk caps and doubles the interval during lag.

Sponge now has 20 performance modules total, spanning entity management, world tuning, resource monitoring, and high-level lag response — all using Sponge API 12 natively.

v1.1.67 — Sponge Platform Expansion (continued)

Added 7 more performance modules for the Sponge platform:

Entity management

• entity-culling — remove excess mobs from player-empty areas during lag
• breeding-throttler — global baby mob count cap (uses Keys.IS_ADULT)
• projectile-limiter — cap in-flight Projectile entities globally
• item-frame-optimizer — cap ItemFrame entities per world, remove distant ones

World tuning

• explosion-optimizer — cap PrimedTNT entities per world (halved during lag)
• random-tick-optimizer — reduce randomTickSpeed gamerule during lag
• mob-griefing-optimizer — disable mobGriefing gamerule during lag, restore on recovery

Sponge now has 18 performance modules total. All use native Sponge API 12 (Keys, GameRules, Sponge entity interfaces) with no reflection required.

v1.1.66 — Sponge Platform Expansion

Added 11 performance modules for the Sponge platform:

Entity management

• entity-limiter — per-chunk mob caps (monsters/animals/ambient)
• mob-clear — periodic countdown mob sweep
• item-clear — periodic countdown ground item sweep
• mob-ai-throttler — disable AI on Creature entities far from players
• villager-optimizer — disable villager AI when no player is nearby
• spawn-limiter — global per-world mob caps

Resource monitoring

• ram-optimizer — heap monitoring + System.gc() hints
• cpu-stabilizer — system CPU load alerts

High-level response

• lag-actions — tiered automatic lag response (3 TPS tiers)
• auto-restart — scheduled server restarts with marker file

Plus SpongePerformanceMonitorModule (nanoTime TPS tracking, 1/5/15-min averages) that all lag-aware modules share.

All modules are opt-in via config/performancex/config.yml and individually tunable in config/performancex/modules/<id>.yml.

added perf-display module — placeable live-updating performance holograms. use /px display place [name] to anchor a hologram showing tps, mspt, ram, players, entities, and chunks. updates every second, survives reloads and restarts, stored in module config. uses textdisplay on 1.19.4+, armorstand fallback on older versions. also: fabric now has 28 performance modules (leaf-decay-optimizer, collision-limiter added this session).

fabric: added leaf-decay-optimizer (halt doLeafDecay gamerule during lag to stop leaf cascade block updates) and collision-limiter (set noPhysics=true on item entities, item frames, and projectiles to cut block-collision overhead). fabric now has 28 performance modules, matching forge parity.

fabric: added random-tick-optimizer (reduce randomTickSpeed gamerule during lag), view-distance-adjuster (dynamically shrink view distance under load), and spawn-tick-optimizer (scan-based probabilistic mob cull during lag). fabric now has 26 performance modules.

fabric: added hopper-limiter (throttle hopper transfer rate under load), explosion-optimizer (cap active TNT entities per dimension), and mob-griefing-optimizer (toggle mob griefing gamerule during lag). fabric now has 23 performance modules.

fabric: added item-merge (merges nearby identical ground item stacks), item-frame-optimizer (caps item frames per world, removes distant ones), and auto-backup (scheduled world backups with local/ftp backends). fabric now has 20 performance modules.

fabric now has 17 performance modules (entity limiter, mob clear, item clear, mob ai throttler, entity culling, spawn limiter, breeding throttler, projectile limiter, villager optimizer, ram optimizer, cpu stabilizer, lag actions, auto restart, dynamic sim distance, tick profiler, anti lag machine, performance monitor). 3 of those are fabric-exclusive (dynamic sim distance, tick profiler, anti lag machine). all 100% reflective, no loom required.

quality pass xx — placeholderapi.yml now documents all 13 previously undocumented placeholders: tps_1m, next_mobclear, items_tracked, modules_enabled, modules_total, integrations_active, integrations_total, lag_throttle_active, packets_throttled, random_tick_speed, disk_io_deferred, holograms. also added a note for the two dynamic placeholder patterns (module_ and integration_) which were working but completely invisible in the docs.

quality pass xix — webhooks.yml now documents all 10 previously undocumented events (disk_io_throttled, disk_io_resumed, ram_gc_threshold, ram_alert, ram_gc_scheduled, cpu_high, plugin_auto_disabled, server_hang, mythicmobs_boss_spawn, mythicmobs_boss_death) with their placeholder variables. also added all 10 as example entries in the main-discord endpoint block so you can just flip enabled: true without guessing the field names.

v1.1.57 — Quality Pass XVIII

Bug Fixes

• AutoConfig: The manual restart countdown (repeatGlobal task) was never cancelled before calling Bukkit.getServer().shutdown(). The task continued ticking through the shutdown sequence. Now the TaskHandle is stored in a final array ref and cancelled before shutdown() is dispatched.
• AutoConfig: backupDir.mkdirs() return value was ignored — a silently-failed directory creation produced a confusing FileNotFoundException on the next line. Now logs a clear [AutoConfig] Could not create backup directory error and returns null early so the caller skips the config apply.

New Features

• Disk I/O Throttler: Now fires two webhook events that admins can subscribe to in webhooks.yml:
  • disk_io_throttled — fires when the IOPS budget is exceeded and auto-save is suppressed. Includes saves_per_second, budget, and usage_percent placeholders.
  • disk_io_resumed — fires when I/O pressure eases and auto-save is restored. Includes saves_per_second and budget placeholders.

v1.1.56 — Quality Pass XVII

Bug Fixes

• Webhooks: fire("server_stop", ...) in onDisable() is now wrapped in a try-catch so queue.shutdown() (the 5-second drain giving webhooks time to deliver) always runs even if the payload build throws.

Improvements

• Performance Display: Now declares a soft requires("monitor") dependency so a warning appears at startup if the monitor module is off — holograms fall back to ? for all stats without it.

New PlaceholderAPI Placeholders

• %performancex_tps_1m%: Explicit 1-minute TPS alias matching the {tps_1m} hologram placeholder name for consistency.
• %performancex_holograms%: Number of currently placed performance-display holograms (from the perf-display module).
• %performancex_disk_io_deferred%: true/false — whether the Disk I/O Throttler is currently deferring writes due to IOPS budget exhaustion.

v1.1.55 — Performance Display Holograms

New Features

• Performance Display (perf-display): New module — placeable, live-updating performance holograms for server admins.
  • Place with /px display place [name], remove with /px display remove <name>, list with /px display list.
  • Shows TPS, MSPT, RAM usage, player count, entity count, and chunk count from the live monitor snapshot.
  • Color-coded TPS and MSPT (green/yellow/red) via MiniMessage {tps_color} and {mspt_color} placeholders.
  • Uses a single TextDisplay entity on 1.19.4+ (native multi-line); one ArmorStand per line on older versions.
  • Updates every second by default — configurable via update_interval_ticks.
  • Hologram positions are persisted in perf-display.yml and respawn automatically on reload and restart.
  • Folia-compatible: entity spawning and updates dispatched on the correct region thread.
  • Auto-respawns holograms when their chunk reloads via ChunkLoadEvent.

v1.1.54 — Quality Pass XVI

Improvements

• 67 Integrations: All remaining integration files with raw unvalidated numeric config reads now use ConfigValidator — invalid values warn and fall back to safe defaults instead of silently misbehaving.
• AbstractIntegration: getCacheTtlMs() now validates the raw getLong result — values ≤ 0 fall back to 5000ms with a warning instead of returning zero or negative cache TTLs.
• GriefPrevention: claim_check_radius was read with a raw getLong and no validation; now uses ConfigValidator with a safe fallback.

v1.1.53 — Integration Config Validation

Config Validation

• Lands: claim_cache_ttl_ms now validated — zero/negative logs a warning and falls back to 5000ms instead of silently clamping
• Towny: same fix for claim_cache_ttl_ms
• Residence: same fix for claim_cache_ttl_ms
• GriefDefender: same fix for claim_cache_ttl_ms
• ASkyBlock: island_cache_ttl_ms now validated — zero/negative logs a warning and falls back to 5000ms
• IridiumSkyblock: same fix for island_cache_ttl_ms
• PlotSquared: plot_cache_ttl_ms now validated — zero/negative logs a warning and falls back to 5000ms
• ProtectionStones: region_cache_ttl_ms now validated — zero/negative logs a warning and falls back to 5000ms
• Veinminer: context_ttl_ms and detection_radius now validated — zero/negative logs a warning and uses defaults
• xPickup: check_radius now validated — zero/negative logs a warning and falls back to 8
• AdvancedEnchantments: min_level_to_protect now validated — zero/negative logs a warning and falls back to 1

v1.1.52 — Quality Pass XIV

Config Validation

• Auto Updater: check_interval_hours, timeout.connect_ms, and timeout.read_ms now use ConfigValidator; removed a silent Math.max clamp that suppressed the warning when the interval was set too low.
• Benchmark: cpu-test-seconds, ram-test-mb, disk-test-mb, network-test-bytes, and network-timeout-ms now use ConfigValidator — zero values no longer produce misleading benchmark scores or cause immediate HTTP timeouts.
• Block Logger: max-query-results, max-radius, write-batch-size, and write-interval-seconds now use ConfigValidator — zero values no longer silently empty all query results or spin the flush task every tick.