Better Spoofer v2.2

◆ Daily scheduler no longer overshoots the curve target

• Fixed fake counts climbing far past the configured curve (e.g. 150+ with a max of 78) on WorldGuard servers and on fast tick intervals. The scheduler counted only already-registered fakes while spawns were still queued/paced, so it kept adding past the target and every queued fake later appeared at once. It now counts committed (registered + in-flight) fakes, so it stops exactly at the target.

◆ Skin changes on real fakes no longer burst WorldGuard

• /spoofer skin on a real (NMS) fake re-spawned it with a raw, unstaggered PlayerJoinEvent - the exact "Could not pass event PlayerJoinEvent to WorldGuard / RejectedExecutionException" overflow the 1.7.0 pacing already fixed for the scheduler. Skin changes now go through the same paced, retried spawn path, and a fake that cannot be re-spawned is cleaned up instead of being left half-registered.

◆ Management GUI no longer leaks click listeners

• Closing the per-fake detail view (Remove / Move / Chat buttons) left the GUI's inventory listener registered until the player quit or reopened the GUI. Each open/close now fully cleans up its listener and tracking entry.

◆ Holograms now appear above real (NMS) fake players

• Previously only phantom (packet) fakes got holograms; real fakes silently had none even though entities.holograms-enabled is on. Real fakes now get the same configured lines, they follow the fake as it walks/teleports, and they are removed together with the fake.

◆ Sort-team no longer keeps stale entries for removed real fakes

• Removing a real fake left its name in the ~bsFakes scoreboard team for the whole server session (a real player later taking that name would be sorted after fakes). Real fakes now clean up their team entry on removal and on plugin disable.

◆ Expired fakes are cleaned up even with scheduler AND join-leave off

• The max-stay cleanup only ran when join-leave was enabled; with both features disabled an expired fake could linger forever. The cleanup now runs whenever a max-stay is configured.

◆ Wandering no longer teleports fakes that did not move

• The 5-second wander tick fired a teleport (and PlayerTeleportEvent / anti-cheat noise) even when a fake had no displacement. It now skips the teleport when nothing changed.

◆ Restore-on-startup no longer wastes Mojang/Mineskin API calls

• Fakes restored without a stored skin previously queried the configured skin source with a random fake name (always 404 to Steve). Legacy restores now resolve from the built-in pool - offline and instant.

◆ /spoofer add reports the real result

• The success message no longer appears the instant the spawn is merely queued - it now fires when the fake is actually spawned, and a failed spawn (after retries) tells you exactly what happened.

◆ Faster skin loading for network skin sources

• The skin executor was doubled from 2 to 4 threads, so MOJANG/MINESKIN lookups during large scheduler ramps no longer serialize into multi-minute spawns.

◆ Clearer webhook misconfiguration warning

• Enabling the webhook with an empty URL used to silently drop every event; the plugin now warns on startup and reload.

◆ Bulk-add, scheduler status, pagination and more

• /spoofer add --count N bulk-adds N fakes (names auto-generated, pacing respected).
• /spoofer scheduler status shows enabled/paused, timezone, current hour, target, committed and registered counts, tick/jitter/gradual.
• /spoofer list [page] is paginated; /spoofer info now also shows fake type (real/phantom) and world + x/y/z.
• /spoofer remove --all now requires an explicit --confirm so it can never wipe all fakes by accident.
• New placeholders: betterspoofer_scheduler_enabled, betterspoofer_online, betterspoofer_phantom_count.

◆ More hardening

• Real-fake animations/head-look now respect permissions.viewer-permission.
• Malformed lines in lang files can no longer crash a command (safe text fallback).
• Ping count/max values are clamped to non-negative; join-leave min/max-stay are validated.
• Clear warnings when chat/name pools are empty, or a webhook is enabled with an empty URL, and a helpful error for a trailing --skin.
• Scheduler hysteresis stops the jittered target from spawning/removing a fake every tick (less join/leave + webhook churn).
• Removed the dead despawnAt field; the plugin config reference is now volatile (safe concurrent reads after reload); fixed a malformed Javadoc.

◆ Scheduler everywhere + override + dashboard

• scheduler.phantom-fallback (default on): when real NMS fakes are unavailable/disabled the daily curve now drives packet-only phantoms, so the scheduler works on every server instead of doing nothing.
• /spoofer scheduler override - temporary fixed target (events/maintenance) with jitter disabled; /spoofer status shows it too.
• /spoofer status - one-command dashboard (TAB/ping/MOTD/entities/chat/join-leave/scheduler/webhook + live counts).
• Ghost-fake cleanup: real fakes whose ServerPlayer vanished (world unload, third-party despawn) are auto-removed every 60 s so counts never lie.
• Type-filtered removal: /spoofer remove --real / --phantom / --all --real/--phantom (still requires --confirm).
• GUI: Add 5 fakes button and the fake's location shown on each head; /spoofer reload re-registers PlaceholderAPI and re-prints the WorldGuard notice.

• Stop the server, swap the jar, start it back up. That is it.
• Your config files stay the same. Nothing is reset.
• New optional scheduler.phantom-fallback (default on) - existing configs keep working unchanged; add it to config.yml only if you want to tweak it.
• On Minecraft 26.1 or 26.2 use the special 26.x build of the plugin. It needs the 26.x version of PacketEvents installed.