
Vanish++
More Features than other plugins. Be truly invisible EVERYWHERE!
5.5K
12
Added
/vspecQuick-Spectate Command: Instantly enter spectator mode on a specific player with/vspec <player>. Use/vspec stopto return to your previous location and gamemode. Requiresvanishpp.spec./vfollowPlayer Tracking HUD: Lock your camera to follow any player silently with/vfollow <player>. A HUD indicator shows active follow target. Stops automatically if the target disconnects. Requiresvanishpp.follow./vhistoryAudit Log: Full vanish/unvanish history with timestamps, executor, and reason. Stored in DB. Requiresvanishpp.history./vautovanishPer-Player Auto-Join Preference: Players can opt into automatic vanish on join. Persisted per UUID — survives restarts and server switches. Requiresvanishpp.autovanish./vstatsVanish Time Statistics: Shows total vanish time, session count, and longest session per player. Requiresvanishpp.stats./vadminDashboard GUI: In-game GUI overview of all vanished players, active rules, and quick actions. Requiresvanishpp.admin./vwandToggle Item: Grants a Blaze Rod vanish wand. Right-clicking toggles vanish state. Configurable inconfig.yml. Requiresvanishpp.wand./vzoneNo-Vanish Zones: Define radius-based zones where vanishing/unvanishing is blocked or forced. Managed with/vzone create|delete|list|reload. Requiresvanishpp.zone./vincognitoFake Name Mode: Replace your display name and tab entry with a custom fake name while vanished. Requiresvanishpp.incognito.- LuckPerms Context Integration: Registers a
vanishedcontext node in LuckPerms so permissions can be conditionally granted while a player is vanished. - WorldGuard Force/Deny Vanish Flags: Two new WorldGuard region flags:
vanishpp-force-vanish(auto-vanishes players entering) andvanishpp-deny-vanish(blocks toggling vanish in the region). - Webhook Support: Configurable HTTP webhook fired on vanish/unvanish events for external integrations (Discord bots, dashboards, audit systems).
- Vanish Reason Tracking:
/vanish <player> [reason]records and displays a reason shown to staff via hover or/vhistory. - Bulk Vanish:
/vanish alland/vanish world <world>vanish all eligible online players or all players in a specific world at once. - Rule Presets: Save, load, list, and delete named rule configurations with
/vrules preset <save|load|list|delete> <name>. Requiresvanishpp.rules. - Bossbar Vanish Status Indicator: Optional persistent bossbar shown to vanished players as a stealth reminder. Configurable colour, style, and text. Toggle in
config.yml. - Public VanishAPI: Developer API (
VanishAPI) exposing vanish state queries, vanish/unvanish calls, event hooks, and rule reads for third-party plugin integration. - Vanish History in Database: Vanish events (time, executor, reason, duration) are now persisted in the SQL backend for audit and statistics use.
- Shift-Right-Click Invsee: Shift-right-clicking a player while vanished opens their inventory via OpenInv or InvSee++ if installed, falling back to built-in view. Permissions are granted for the duration of the open inventory and removed on close.
/msg//tell//r//meDetection Prevention: Non-seers can no longer/msg,/tell, or use any private-message command to reach a vanished player — they receive a vanilla-style fake error./rreply is blocked when the last target was a vanished sender./mefrom a vanished player is restricted to staff-only audience. Covers vanilla and EssentialsX aliases. Fake error text is configurable undercommands.msg-player-not-foundinmessages.yml.messages.ymlAuto-Migration: Missing message keys from the default file are automatically written back to the user'smessages.ymlon load, so upgrading never leaves a key undefined.
Added
%vanishpp_visible_player_list%PAPI Placeholder: New PlaceholderAPI placeholder that returns a comma-separated list of all online non-vanished (visible) players. Complements the existing%vanishpp_vanished_list%for HUDs and scoreboards that need to display who is online.
Fixed
- Mob AI Targeting Vanished Players:
SafeLookAtPlayerGoal(a custom PaperMobGoalsinjection) was causingLookAtPlayerGoalto leak into the LOOK goal slot on servers where the custom goal claimed the slot only conditionally. Removed entirely; mob targeting prevention now relies solely onEntityTargetEventcancellation, which is reliable and cross-version. - Folia Scheduler Illegal Delay Crash:
FoliaSchedulerBridge.runLaterGlobal()passed caller-supplied tick values directly to Folia'srunDelayed, which throwsIllegalArgumentExceptionfor<= 0. Bridge now falls back to immediaterunGlobalexecution. (PR #11, reported by XChen446) - Mass Disconnect on Unvanish:
refreshVisibilityWithGlow()iterated the liveBukkit.getOnlinePlayers()collection while sending packets and forced a hide+show cycle on every observer — including non-seers. Under load this caused a packet burst that disconnected players. Fixed by snapshotting the player list before iteration and limiting the hide+show respawn cycle to seers only (who need it to flush glow metadata). - ProtocolLib
CUSTOM_SOUND_EFFECTBoot Warning: Registering a packet listener forCUSTOM_SOUND_EFFECTon Minecraft versions where that packet type is absent produced a[ProtocolLib] Plugin Vanishpp tried to register listener for unknown packet CUSTOM_SOUND_EFFECT (unregistered)WARN on every server start. The silent-chest sound suppression listener now checksPacketType.Play.Server.CUSTOM_SOUND_EFFECT.isSupported()before registering and skips it on unsupported versions. Reported by a community member.
Added
/vspecQuick-Spectate Command: Instantly enter spectator mode on a specific player with/vspec <player>. Use/vspec stopto return to your previous location and gamemode. Requiresvanishpp.spec./vfollowPlayer Tracking HUD: Lock your camera to follow any player silently with/vfollow <player>. A HUD indicator shows active follow target. Stops automatically if the target disconnects. Requiresvanishpp.follow./vhistoryAudit Log: Full vanish/unvanish history with timestamps, executor, and reason. Stored in DB. Requiresvanishpp.history./vautovanishPer-Player Auto-Join Preference: Players can opt into automatic vanish on join. Persisted per UUID — survives restarts and server switches. Requiresvanishpp.autovanish./vstatsVanish Time Statistics: Shows total vanish time, session count, and longest session per player. Requiresvanishpp.stats./vadminDashboard GUI: In-game GUI overview of all vanished players, active rules, and quick actions. Requiresvanishpp.admin./vwandToggle Item: Grants a Blaze Rod vanish wand. Right-clicking toggles vanish state. Configurable inconfig.yml. Requiresvanishpp.wand./vzoneNo-Vanish Zones: Define radius-based zones where vanishing/unvanishing is blocked or forced. Managed with/vzone create|delete|list|reload. Requiresvanishpp.zone./vincognitoFake Name Mode: Replace your display name and tab entry with a custom fake name while vanished. Requiresvanishpp.incognito.- LuckPerms Context Integration: Registers a
vanishedcontext node in LuckPerms so permissions can be conditionally granted while a player is vanished. - WorldGuard Force/Deny Vanish Flags: Two new WorldGuard region flags:
vanishpp-force-vanish(auto-vanishes players entering) andvanishpp-deny-vanish(blocks toggling vanish in the region). - Webhook Support: Configurable HTTP webhook fired on vanish/unvanish events for external integrations (Discord bots, dashboards, audit systems).
- Vanish Reason Tracking:
/vanish <player> [reason]records and displays a reason shown to staff via hover or/vhistory. - Bulk Vanish:
/vanish alland/vanish world <world>vanish all eligible online players or all players in a specific world at once. - Rule Presets: Save, load, list, and delete named rule configurations with
/vrules preset <save|load|list|delete> <name>. Requiresvanishpp.rules. - Bossbar Vanish Status Indicator: Optional persistent bossbar shown to vanished players as a stealth reminder. Configurable colour, style, and text. Toggle in
config.yml. - Public VanishAPI: Developer API (
VanishAPI) exposing vanish state queries, vanish/unvanish calls, event hooks, and rule reads for third-party plugin integration. - Vanish History in Database: Vanish events (time, executor, reason, duration) are now persisted in the SQL backend for audit and statistics use.
- Shift-Right-Click Invsee: Shift-right-clicking a player while vanished opens their inventory via OpenInv or InvSee++ if installed, falling back to built-in view. Permissions are granted for the duration of the open inventory and removed on close.
/msg//tell//r//meDetection Prevention: Non-seers can no longer/msg,/tell, or use any private-message command to reach a vanished player — they receive a vanilla-style fake error./rreply is blocked when the last target was a vanished sender./mefrom a vanished player is restricted to staff-only audience. Covers vanilla and EssentialsX aliases. Fake error text is configurable undercommands.msg-player-not-foundinmessages.yml.messages.ymlAuto-Migration: Missing message keys from the default file are automatically written back to the user'smessages.ymlon load, so upgrading never leaves a key undefined.
Added
%vanishpp_visible_player_list%PAPI Placeholder: New PlaceholderAPI placeholder that returns a comma-separated list of all online non-vanished (visible) players. Complements the existing%vanishpp_vanished_list%for HUDs and scoreboards that need to display who is online.
Fixed
- Mob AI Targeting Vanished Players:
SafeLookAtPlayerGoal(a custom PaperMobGoalsinjection) was causingLookAtPlayerGoalto leak into the LOOK goal slot on servers where the custom goal claimed the slot only conditionally. Removed entirely; mob targeting prevention now relies solely onEntityTargetEventcancellation, which is reliable and cross-version. - Folia Scheduler Illegal Delay Crash:
FoliaSchedulerBridge.runLaterGlobal()passed caller-supplied tick values directly to Folia'srunDelayed, which throwsIllegalArgumentExceptionfor<= 0. Bridge now falls back to immediaterunGlobalexecution. (PR #11, reported by XChen446) - Mass Disconnect on Unvanish:
refreshVisibilityWithGlow()iterated the liveBukkit.getOnlinePlayers()collection while sending packets and forced a hide+show cycle on every observer — including non-seers. Under load this caused a packet burst that disconnected players. Fixed by snapshotting the player list before iteration and limiting the hide+show respawn cycle to seers only (who need it to flush glow metadata). - ProtocolLib
CUSTOM_SOUND_EFFECTBoot Warning: Registering a packet listener forCUSTOM_SOUND_EFFECTon Minecraft versions where that packet type is absent produced a[ProtocolLib] Plugin Vanishpp tried to register listener for unknown packet CUSTOM_SOUND_EFFECT (unregistered)WARN on every server start. The silent-chest sound suppression listener now checksPacketType.Play.Server.CUSTOM_SOUND_EFFECT.isSupported()before registering and skips it on unsupported versions. Reported by a community member.
Added
- Cross-Server Vanish State Reconciliation: When a player joins a server that shares a MySQL/PostgreSQL database with other servers, their vanish state from any other server is immediately applied — no manual
/vanishneeded after switching. Works on BungeeCord/Velocity networks with a shared database. Stale in-memory entries for offline players are also periodically purged so no server accumulates phantom vanished UUIDs. - Instant Proxy-Ready Vanish State on Join: Vanish state is now pre-fetched from the database during
AsyncPlayerPreLoginEvent(before the player fully connects), so it is applied on the very first tick ofPlayerJoinEventwith zero additional delay. On a proxy network, players switching servers appear vanished or visible to staff immediately, with no visible flicker or catch-up period. - Native Velocity Proxy Plugin: A companion Velocity plugin (
vanishpp-velocity) provides a dedicatedvanishpp:proxyplugin messaging channel for real-time cross-server state sync, config push, and network-wide/vanishreload. The proxy maintains an authoritative vanished-player list and broadcasts state changes to all connected Paper servers instantly. Automatically detected on startup — servers fall back to standalone mode if no Velocity proxy is found. - Scoreboard Timezone Offset (
timezone-offset-hours): The scoreboard's%time%and%date%placeholders now support a configurable hour offset applied on top of the base timezone. Settimezone-offset-hours: 2inscoreboards.ymlto shift the displayed time forward by two hours from the base zone (supports decimals like5.5for IST).timezone: "default"already uses the server's system clock; the offset is applied on top of whichever zone is configured. - ProtocolLib Missing Warning — Disabled Features List: The startup warning shown to staff when ProtocolLib is not installed now includes a
[Disabled Features ▶]hover button listing all 7 features that require ProtocolLib (tab-complete scrubbing, entity packet filtering, ghost-proof spawning, scoreboard team scrubbing, server list count adjustment, silent chest animations/sounds, staff glow).
Fixed
- Mobs Looking at Vanished Players (Passive Head Tracking): Re-introduced
MobAiManagerwith a correct implementation. The root cause of the 1.1.5 regression was thatSafeLookAtPlayerGoalreturnedfalsefromshouldActivate()when only vanished players were nearby — this freed theLOOKgoal slot, allowing the vanillaLookAtPlayerGoalto fill it (vanilla has no vanish awareness).SafeLookAtPlayerGoalnow claims theLOOKslot whenever any player is in range (returningtruewith a null target when all nearby players are vanished), so the vanilla goal can never activate for vanished players. A periodic 20-tick sweep also force-clears any combat targets pointing at vanished players as a safety net. - Cross-Server Timed Rule Expiry Message Not Delivered: When a timed rule (e.g.
/vrules <player> mob_targeting time 30) expired on server A while the player was already connected to server B, the notification was never shown. The fix is three-layered: (1) aPLAYER_MESSAGEpacket type routes the message through the Velocity proxy to wherever the player currently is; (2) if no carrier player is available to send the packet, a__notify_expired__<rule>flag is written to the shared database; (3) a 5-second async poll on every server checks online players for pending DB flags and delivers + clears them immediately — no reconnect required. The rule revert itself always completes successfully; only the notification delivery was affected. - ProtocolLib Async Entity Lookup Spam:
getEntityFromID()was being called from ProtocolLib packet listeners on async threads (e.g. triggered by Orebfuscator), causing console spam and unsafe cross-thread world access. Entity ID to UUID resolution is now handled via a localConcurrentHashMapcache populated at join and cleared at quit, keeping all lookups off the world thread entirely. (Thanks SimplyRan, PR #5) - Folia Crash: Night Vision Applied from Global Scheduler: When cross-server vanish sync (Redis) applied vanish effects from the global region scheduler, calling
player.addPotionEffect()andplayer.removePotionEffect()directly caused anUnsupportedOperationExceptionon Folia because the global scheduler does not own any player entity's region. Night vision potion calls inapplyVanishEffects,removeVanishEffects, andresyncVanishEffectsare now dispatched throughvanishScheduler.runEntity(), which routes to the entity's own region scheduler on Folia and to the main thread on all other platforms. (Thanks SimplyRan, PR #1) - Silent Container Item Duplication: Opening containers while vanished could cause items to duplicate or appear as wrong state. The root cause was a snapshot-copy approach — changes were written to a copy of the inventory and synced back on close, but the sync-back could overwrite concurrent item movements (hoppers, other players) and double-count items. Containers are now opened directly against the real inventory, matching vanilla behaviour exactly.
- Storage Backend Not Applied After
/vanishreload: Changingstorage.typeinconfig.yml(e.g. fromYAMLtoPOSTGRESQL) had no effect until the server was fully restarted./vanishreloadnow shuts down the active storage provider and reinitializes it from the current config, making storage type changes take effect immediately. /vanishscoreboardVisible in Tab-Complete for All Players: The command appeared in tab-complete for players who lackedvanishpp.scoreboard, revealing the feature's existence. The command entry inplugin.ymlnow declarespermission: vanishpp.scoreboard, causing Bukkit to hide it from players without that node.- MobAiManager Crash on Spigot/Bukkit:
MobAiManagercalledBukkit.getMobGoals()— a Paper-only API — unconditionally on startup, causingNoSuchMethodErrorcrashes on Spigot and Bukkit when the listener was registered. The manager is now only registered when the Paper API surface is confirmed present (Paper, Purpur, Folia). Mob AI goal injection and the 20-tick sweep remain fully operational on all Paper-family servers; on Spigot/Bukkit mob targeting prevention continues to work viaEntityTargetEvent.
- Cross-Server Vanish State Reconciliation: When a player joins a server that shares a MySQL/PostgreSQL database with other servers, their vanish state from any other server is immediately applied — no manual
Added
- Cross-Server Vanish State Reconciliation: When a player joins a server that shares a MySQL/PostgreSQL database with other servers, their vanish state from any other server is immediately applied — no manual
/vanishneeded after switching. Works on BungeeCord/Velocity networks with a shared database. Stale in-memory entries for offline players are also periodically purged so no server accumulates phantom vanished UUIDs. - Instant Proxy-Ready Vanish State on Join: Vanish state is now pre-fetched from the database during
AsyncPlayerPreLoginEvent(before the player fully connects), so it is applied on the very first tick ofPlayerJoinEventwith zero additional delay. On a proxy network, players switching servers appear vanished or visible to staff immediately, with no visible flicker or catch-up period. - Native Velocity Proxy Plugin: A companion Velocity plugin (
vanishpp-velocity) provides a dedicatedvanishpp:proxyplugin messaging channel for real-time cross-server state sync, config push, and network-wide/vanishreload. The proxy maintains an authoritative vanished-player list and broadcasts state changes to all connected Paper servers instantly. Automatically detected on startup — servers fall back to standalone mode if no Velocity proxy is found. - Scoreboard Timezone Offset (
timezone-offset-hours): The scoreboard's%time%and%date%placeholders now support a configurable hour offset applied on top of the base timezone. Settimezone-offset-hours: 2inscoreboards.ymlto shift the displayed time forward by two hours from the base zone (supports decimals like5.5for IST).timezone: "default"already uses the server's system clock; the offset is applied on top of whichever zone is configured. - ProtocolLib Missing Warning — Disabled Features List: The startup warning shown to staff when ProtocolLib is not installed now includes a
[Disabled Features ▶]hover button listing all 7 features that require ProtocolLib (tab-complete scrubbing, entity packet filtering, ghost-proof spawning, scoreboard team scrubbing, server list count adjustment, silent chest animations/sounds, staff glow).
Fixed
- Mobs Looking at Vanished Players (Passive Head Tracking): Re-introduced
MobAiManagerwith a correct implementation. The root cause of the 1.1.5 regression was thatSafeLookAtPlayerGoalreturnedfalsefromshouldActivate()when only vanished players were nearby — this freed theLOOKgoal slot, allowing the vanillaLookAtPlayerGoalto fill it (vanilla has no vanish awareness).SafeLookAtPlayerGoalnow claims theLOOKslot whenever any player is in range (returningtruewith a null target when all nearby players are vanished), so the vanilla goal can never activate for vanished players. A periodic 20-tick sweep also force-clears any combat targets pointing at vanished players as a safety net. - Cross-Server Timed Rule Expiry Message Not Delivered: When a timed rule (e.g.
/vrules <player> mob_targeting time 30) expired on server A while the player was already connected to server B, the notification was never shown. The fix is three-layered: (1) aPLAYER_MESSAGEpacket type routes the message through the Velocity proxy to wherever the player currently is; (2) if no carrier player is available to send the packet, a__notify_expired__<rule>flag is written to the shared database; (3) a 5-second async poll on every server checks online players for pending DB flags and delivers + clears them immediately — no reconnect required. The rule revert itself always completes successfully; only the notification delivery was affected. - ProtocolLib Async Entity Lookup Spam:
getEntityFromID()was being called from ProtocolLib packet listeners on async threads (e.g. triggered by Orebfuscator), causing console spam and unsafe cross-thread world access. Entity ID to UUID resolution is now handled via a localConcurrentHashMapcache populated at join and cleared at quit, keeping all lookups off the world thread entirely. (Thanks SimplyRan, PR #5) - Folia Crash: Night Vision Applied from Global Scheduler: When cross-server vanish sync (Redis) applied vanish effects from the global region scheduler, calling
player.addPotionEffect()andplayer.removePotionEffect()directly caused anUnsupportedOperationExceptionon Folia because the global scheduler does not own any player entity's region. Night vision potion calls inapplyVanishEffects,removeVanishEffects, andresyncVanishEffectsare now dispatched throughvanishScheduler.runEntity(), which routes to the entity's own region scheduler on Folia and to the main thread on all other platforms. (Thanks SimplyRan, PR #1) - Silent Container Item Duplication: Opening containers while vanished could cause items to duplicate or appear as wrong state. The root cause was a snapshot-copy approach — changes were written to a copy of the inventory and synced back on close, but the sync-back could overwrite concurrent item movements (hoppers, other players) and double-count items. Containers are now opened directly against the real inventory, matching vanilla behaviour exactly.
- Storage Backend Not Applied After
/vanishreload: Changingstorage.typeinconfig.yml(e.g. fromYAMLtoPOSTGRESQL) had no effect until the server was fully restarted./vanishreloadnow shuts down the active storage provider and reinitializes it from the current config, making storage type changes take effect immediately. /vanishscoreboardVisible in Tab-Complete for All Players: The command appeared in tab-complete for players who lackedvanishpp.scoreboard, revealing the feature's existence. The command entry inplugin.ymlnow declarespermission: vanishpp.scoreboard, causing Bukkit to hide it from players without that node.- MobAiManager Crash on Spigot/Bukkit:
MobAiManagercalledBukkit.getMobGoals()— a Paper-only API — unconditionally on startup, causingNoSuchMethodErrorcrashes on Spigot and Bukkit when the listener was registered. The manager is now only registered when the Paper API surface is confirmed present (Paper, Purpur, Folia). Mob AI goal injection and the 20-tick sweep remain fully operational on all Paper-family servers; on Spigot/Bukkit mob targeting prevention continues to work viaEntityTargetEvent.
- Cross-Server Vanish State Reconciliation: When a player joins a server that shares a MySQL/PostgreSQL database with other servers, their vanish state from any other server is immediately applied — no manual
Added
- Vanish Scoreboard: A configurable sidebar scoreboard shown automatically to vanished players (
vanishpp.scoreboard). Displays world, TPS, online count, coordinates, direction, biome, ping, health, food, armor, time, date, vanish level, and more. Updates coordinates in real-time on movement via ProtocolLib packet listener (with configurable cooldown). Toggle manually with/vscoreboard. Auto-shows on vanish, hides on unvanish. Configured inscoreboards.yml. Reloads with/vreload. /vscoreboardCommand: Toggle the vanish scoreboard on/off. Requiresvanishpp.scoreboard.- Scoreboard Placeholders: Full set of built-in placeholders:
%world%,%tps%,%tps_raw%,%online%,%max_players%,%vanished_count%,%x%,%y%,%z%,%direction%,%biome%,%ping%,%gamemode%,%health%,%max_health%,%food%,%armor%,%level%/%vanish_level%,%player%,%displayname%,%memory_used%,%memory_max%,%entities%,%chunks%,%time%,%date%. PlaceholderAPI supported. /vlistInteractive Player Names: Each player name in/vlistoutput is now clickable. Hovering shows the player's vanish level and world; clicking runs/vanish <player>to unvanish them instantly.- Periodic Update Checker: The update checker now re-runs every hour in the background — not just once on startup. Staff with
vanishpp.updateare notified without needing a server restart. - SQL Schema Versioning: MySQL/PostgreSQL storage now tracks a schema version in
vpp_schema_versionand runs structured migrations on startup, allowing for future schema changes. Schema v2 addscreated_at/updated_atcolumns for future audit trail features. - Real-Time Database Sync: Vanish state changes (vanish/unvanish) are now persisted to the database asynchronously, so storage I/O never blocks the main thread on join or leave. Rules and vanish state are kept in a per-player in-memory cache — pre-populated async on join and cleared on quit — eliminating database round-trips on hot event paths (block breaks, entity damage, etc.).
- Database Connection Error Notifications: When database connectivity fails, staff with
vanishpp.adminor OP status are notified in-game (throttled every 5 minutes to prevent spam). Helps identify infrastructure issues without requiring log file access. - Proxy Plugin Integration Documentation: Complete guide for proxy plugins (BungeeCord/Velocity) to read vanish state directly from the database. Includes example adapters and security best practices.
Changed
- Spectator Quick-Switch Restores Exact Gamemode: Double-shifting out of Spectator now returns the player to the gamemode they were in before entering Spectator (Creative, Adventure, Survival), not always Survival.
- DiscordSRV Fake Join/Leave Use Embed Format: Fake join and leave messages sent to Discord on vanish/unvanish now use DiscordSRV's own
sendJoinMessage()/sendLeaveMessage()methods, honouring the embed, colour, avatar, and webhook settings configured in DiscordSRV'smessages.yml. Previously they were always plain bold text regardless of configuration. - Scoreboard Column Auto-Alignment: Lines containing a
|separator are automatically padded so the separator lands at the same column on every line. Label widths are measured after stripping color codes. Works for any custom label length — no manual padding needed. - Scoreboard Hides Score Numbers: Score numbers on the right side of the sidebar are hidden using Paper's
NumberFormat.blank()API for a cleaner look. - Config Defaults Hardened: All config reads now use explicit fallback defaults. Previously, deleted or missing keys would silently produce
false/0— now the intended default is always applied even on a stripped config file. - Database Transaction Safety:
removePlayerData()now uses transactions to ensure all-or-nothing deletion. Connection errors during cleanup are logged but don't partially corrupt data. - Network Sync Idempotency: Cross-server vanish sync (Redis) now ignores duplicate messages to prevent visibility state divergence if network flakiness causes message replays.
Fixed
- Folia Crash on Startup: Folia 1.21.11 renamed the internal detection class used by the scheduler bridge, causing the plugin to load
BukkitSchedulerBridgeinstead ofFoliaSchedulerBridge. AddedBukkit.getName()as a fallback detection method. Additionally, Folia forbidsScoreboardManager.registerNewTeam()on the startup thread — team setup is now deferred to the global region scheduler, andvanishTeamusages are null-guarded for the brief window before it completes. - Action Bar Warning Overwritten: Warning messages (e.g., "Action Blocked") shown in the action bar were immediately erased by the vanish status bar on the next scheduler tick. Warnings now display for their full intended duration before the status bar resumes.
prevent-potion-effectsWrong Default: This setting defaulted totruein code, silently blocking all potion effects (including healing potions thrown by staff) on servers where the key was missing fromconfig.yml. Corrected tofalse.- SQL Acknowledgements Not Persisted: The
vpp_acknowledgementstable was missing from the MySQL/PostgreSQL schema. Persistent acknowledgements (ProtocolLib missing warning, config migration reports) were silently ignored for SQL storage users — they are now stored and respected correctly. - SQL
removePlayerDataLeft Stale Acknowledgements: Removing a player's data via SQL did not delete their acknowledgement rows. Stale entries could suppress future notifications for that UUID. Now cleared along with rules and level data in a single transaction. - SQL
getRulesReturned Strings Instead of Booleans:getRules()returned raw SQL text values ("true","false") instead ofBooleanobjects, breaking any code comparing rule values by type. Values are now parsed toBooleanbefore being returned. - PostgreSQL
addAcknowledgement()Syntax Error: PostgreSQLON CONFLICTclause was incomplete, missing the constraint columns. Now correctly usesON CONFLICT (uuid, notification_id) DO NOTHING. - Redis Subscriber Thread Leak: The Redis subscriber thread was never gracefully shut down on plugin reload, causing lingering connections and resource exhaustion. Now properly interrupts the thread with timeout and closes Jedis resources.
- Folia Visibility Sync Thread Safety: Visibility sync task could cause
ConcurrentModificationExceptionin Folia's multi-region environment. Now uses immutable snapshots for safe iteration. - SQL Schema Migration Idempotency: Calling
init()multiple times (e.g., on reload) would fail with primary key violations. Now idempotent and safe to call repeatedly. - Database Error Visibility: Silent database failures provided no feedback to admins. Connection errors are now logged to console and notified to staff in-game.
- DiscordSRV Advancement Leak: Vanished players completing advancements no longer trigger Discord announcements. Suppressed via
AchievementMessagePreProcessEventas a safety net in addition to DiscordSRV's native vanish check. - DiscordSRV Death Leak: Vanished players dying no longer trigger Discord death announcements. Suppressed via
DeathMessagePreProcessEventas a safety net.
- Vanish Scoreboard: A configurable sidebar scoreboard shown automatically to vanished players (
Added
- Vanish Scoreboard: A configurable sidebar scoreboard shown automatically to vanished players (
vanishpp.scoreboard). Displays world, TPS, online count, coordinates, direction, biome, ping, health, food, armor, time, date, vanish level, and more. Updates coordinates in real-time on movement via ProtocolLib packet listener (with configurable cooldown). Toggle manually with/vscoreboard. Auto-shows on vanish, hides on unvanish. Configured inscoreboards.yml. Reloads with/vreload. /vscoreboardCommand: Toggle the vanish scoreboard on/off. Requiresvanishpp.scoreboard.- Scoreboard Placeholders: Full set of built-in placeholders:
%world%,%tps%,%tps_raw%,%online%,%max_players%,%vanished_count%,%x%,%y%,%z%,%direction%,%biome%,%ping%,%gamemode%,%health%,%max_health%,%food%,%armor%,%level%/%vanish_level%,%player%,%displayname%,%memory_used%,%memory_max%,%entities%,%chunks%,%time%,%date%. PlaceholderAPI supported. /vlistInteractive Player Names: Each player name in/vlistoutput is now clickable. Hovering shows the player's vanish level and world; clicking runs/vanish <player>to unvanish them instantly.- Periodic Update Checker: The update checker now re-runs every hour in the background — not just once on startup. Staff with
vanishpp.updateare notified without needing a server restart. - SQL Schema Versioning: MySQL/PostgreSQL storage now tracks a schema version in
vpp_schema_versionand runs structured migrations on startup, allowing for future schema changes. Schema v2 addscreated_at/updated_atcolumns for future audit trail features. - Real-Time Database Sync: Vanish state changes (vanish/unvanish) are now persisted to the database asynchronously, so storage I/O never blocks the main thread on join or leave. Rules and vanish state are kept in a per-player in-memory cache — pre-populated async on join and cleared on quit — eliminating database round-trips on hot event paths (block breaks, entity damage, etc.).
- Database Connection Error Notifications: When database connectivity fails, staff with
vanishpp.adminor OP status are notified in-game (throttled every 5 minutes to prevent spam). Helps identify infrastructure issues without requiring log file access. - Proxy Plugin Integration Documentation: Complete guide for proxy plugins (BungeeCord/Velocity) to read vanish state directly from the database. Includes example adapters and security best practices.
Changed
- Spectator Quick-Switch Restores Exact Gamemode: Double-shifting out of Spectator now returns the player to the gamemode they were in before entering Spectator (Creative, Adventure, Survival), not always Survival.
- DiscordSRV Fake Join/Leave Use Embed Format: Fake join and leave messages sent to Discord on vanish/unvanish now use DiscordSRV's own
sendJoinMessage()/sendLeaveMessage()methods, honouring the embed, colour, avatar, and webhook settings configured in DiscordSRV'smessages.yml. Previously they were always plain bold text regardless of configuration. - Scoreboard Column Auto-Alignment: Lines containing a
|separator are automatically padded so the separator lands at the same column on every line. Label widths are measured after stripping color codes. Works for any custom label length — no manual padding needed. - Scoreboard Hides Score Numbers: Score numbers on the right side of the sidebar are hidden using Paper's
NumberFormat.blank()API for a cleaner look. - Config Defaults Hardened: All config reads now use explicit fallback defaults. Previously, deleted or missing keys would silently produce
false/0— now the intended default is always applied even on a stripped config file. - Database Transaction Safety:
removePlayerData()now uses transactions to ensure all-or-nothing deletion. Connection errors during cleanup are logged but don't partially corrupt data. - Network Sync Idempotency: Cross-server vanish sync (Redis) now ignores duplicate messages to prevent visibility state divergence if network flakiness causes message replays.
Fixed
- Folia Crash on Startup: Folia 1.21.11 renamed the internal detection class used by the scheduler bridge, causing the plugin to load
BukkitSchedulerBridgeinstead ofFoliaSchedulerBridge. AddedBukkit.getName()as a fallback detection method. Additionally, Folia forbidsScoreboardManager.registerNewTeam()on the startup thread — team setup is now deferred to the global region scheduler, andvanishTeamusages are null-guarded for the brief window before it completes. - Action Bar Warning Overwritten: Warning messages (e.g., "Action Blocked") shown in the action bar were immediately erased by the vanish status bar on the next scheduler tick. Warnings now display for their full intended duration before the status bar resumes.
prevent-potion-effectsWrong Default: This setting defaulted totruein code, silently blocking all potion effects (including healing potions thrown by staff) on servers where the key was missing fromconfig.yml. Corrected tofalse.- SQL Acknowledgements Not Persisted: The
vpp_acknowledgementstable was missing from the MySQL/PostgreSQL schema. Persistent acknowledgements (ProtocolLib missing warning, config migration reports) were silently ignored for SQL storage users — they are now stored and respected correctly. - SQL
removePlayerDataLeft Stale Acknowledgements: Removing a player's data via SQL did not delete their acknowledgement rows. Stale entries could suppress future notifications for that UUID. Now cleared along with rules and level data in a single transaction. - SQL
getRulesReturned Strings Instead of Booleans:getRules()returned raw SQL text values ("true","false") instead ofBooleanobjects, breaking any code comparing rule values by type. Values are now parsed toBooleanbefore being returned. - PostgreSQL
addAcknowledgement()Syntax Error: PostgreSQLON CONFLICTclause was incomplete, missing the constraint columns. Now correctly usesON CONFLICT (uuid, notification_id) DO NOTHING. - Redis Subscriber Thread Leak: The Redis subscriber thread was never gracefully shut down on plugin reload, causing lingering connections and resource exhaustion. Now properly interrupts the thread with timeout and closes Jedis resources.
- Folia Visibility Sync Thread Safety: Visibility sync task could cause
ConcurrentModificationExceptionin Folia's multi-region environment. Now uses immutable snapshots for safe iteration. - SQL Schema Migration Idempotency: Calling
init()multiple times (e.g., on reload) would fail with primary key violations. Now idempotent and safe to call repeatedly. - Database Error Visibility: Silent database failures provided no feedback to admins. Connection errors are now logged to console and notified to staff in-game.
- DiscordSRV Advancement Leak: Vanished players completing advancements no longer trigger Discord announcements. Suppressed via
AchievementMessagePreProcessEventas a safety net in addition to DiscordSRV's native vanish check. - DiscordSRV Death Leak: Vanished players dying no longer trigger Discord death announcements. Suppressed via
DeathMessagePreProcessEventas a safety net.
- Vanish Scoreboard: A configurable sidebar scoreboard shown automatically to vanished players (
[1.1.6] - 2026-04-01
Added
- Periodic Update Checker: The update checker now re-runs every hour in the background — not just once on startup. Staff with
vanishpp.updateare notified without needing a server restart. - SQL Schema Versioning: MySQL/PostgreSQL storage now tracks a schema version in
vpp_schema_versionand runs structured migrations on startup, making future schema changes safe and automatic.
Changed
- Config Defaults Hardened: All config reads now use explicit fallback defaults. Previously, deleted or missing keys would silently produce
false/0— now the intended default is always applied even on a stripped config file.
- Periodic Update Checker: The update checker now re-runs every hour in the background — not just once on startup. Staff with
Added
- Spectator Quick-Switch: Vanished players with
vanishpp.spectatorcan double-tap Shift to toggle Spectator mode instantly. Double-tap again to return to the previous gamemode. Unvanishing while in Spectator forces the player back automatically (bypassed byvanishpp.spectator.bypass). spectator_gamemodeVRule: New per-player rule to enable or disable the Spectator quick-switch. Default:true. Configurable globally undervanish-gamemodes.enabled.
Changed
- Spectator Mode Feedback: The action bar notification shown when entering or exiting Spectator mode is now displayed for 3 seconds and is no longer immediately overwritten by the vanish status indicator.
- Unknown Command on Permission Denied: Players without permission to use any Vanish++ command now receive a vanilla-style "Unknown command" response instead of a permission-denied message, preventing server staff plugin discovery.
Fixed
- Mob Despawning Near Vanished Players: Mobs no longer despawn when chunks are reloaded near a vanished player. The previous
setAffectsSpawning(false)call incorrectly caused the server to ignore vanished players for mob lifecycle calculations. Pressure plate suppression is now handled exclusively by theCAN_TRIGGER_PHYSICALrule, which was already in place. - Mobs Not Attacking Non-Vanished Players: Removed
MobAiManager, which replaced the vanillaLookAtPlayerGoalfor all mobs globally. The PaperMobGoalsAPI used to inject the custom goal was causing mob attack AI to break for all players. Attack prevention for vanished players is now handled entirely throughEntityTargetEvent. can_throwRule Had No Effect: Throwing projectiles (snowballs, eggs, ender pearls, potions, bows, crossbows) whilecan_throwwas enabled was still blocked becausePlayerInteractEventcancelled the right-click beforeProjectileLaunchEventcould fire. The interact handler now permits throwable items through whencan_throwis enabled, even ifcan_interactis disabled.- Spawn Eggs Always Blocked: Spawn eggs were blocked unconditionally regardless of the
can_throwrule state. They now respect the rule correctly. - Periodic Mob Pathfinding Interruption: The background sync task was calling
stopPathfinding()on all nearby mobs every 0.5 seconds. This caused mobs to appear passive and disrupted vanilla mob behaviour for all players. Mob targeting is now handled reactively viaEntityTargetEventonly.
- Spectator Quick-Switch: Vanished players with
Added
can_throwVRule: New personal rule controlling whether vanished players can throw items (eggs, snowballs, ender pearls, potions, bows, crossbows). Default:false. Fully integrated with interactive chat buttons ([Allow 1m],[Allow permanently],[Hide notifications]).- Staff Glow Indicator: Vanished players now render with a glowing outline for staff with
vanishpp.see. Uses packet-level metadata injection — non-staff never see it. Enabled by default (vanish-appearance.staff-glow: true). - Vanish State Resync Engine: New
resyncVanishEffects()system that reapplies all vanish state (team, prefix, metadata, fly, night vision, collision, mob targeting, visibility, glow) without touching storage. Triggered automatically on respawn, world change, and gamemode change. - Respawn Handler: Vanish state (fly, invisibility, glow, collision) is now fully restored after death and respawn.
- World Change Handler: Nether/End portal transitions no longer break vanish state.
- Gamemode Change Handler: Changing gamemode (e.g.,
/gamemode survival) while vanished no longer disables flight. - [Unvanish] Button: All blocked-action messages now include a convenient
[Unvanish]button alongside[Allow 1m],[Allow permanently], and[Hide notifications]. - Fast Sync Loop: Heartbeat task now runs every 10 ticks with visibility fix, team/prefix reapply, glow metadata resend, and mob targeting — ensuring all vanish features stay in sync continuously.
- Explicit Glow Metadata Packets: Staff glow is now sent via direct ProtocolLib
ENTITY_METADATApackets rather than relying on entity respawn metadata, ensuring the glow appears instantly. - Multi-Stage Join Prefix: Tab prefix is now reapplied at 2, 20, and 60 ticks after join — catches TAB plugin async overrides at different pipeline stages.
- Snapshot Silent Chests: Barrels and containers are now opened as inventory snapshots (copy of the real inventory). Changes sync back on close. This eliminates
Container.startOpen()entirely, preventing animation and sound at the source. - Reload Resync:
/vreloadnow refreshes team prefix and resyncs all online vanished players' effects. - Setup Advisor (Config Sanity Checker): On startup, Vanish++ now scans the active configuration and warns if:
hooks.simple-voice-chat.enabledistruebut SimpleVoiceChat is not installed.hooks.essentials.simulate-join-leaveistruebut EssentialsX is not installed.- Any message string contains a PlaceholderAPI placeholder (
%token%) but PlaceholderAPI is not installed. - Warnings are printed to the console and shown in-chat to all players with
vanishpp.seeon their next login, making it easy to spot setup issues without reading logs.
- Comprehensive Automated Test Suite: 143 unit tests across 6 test classes covering every feature — commands, event listeners, storage, permissions, rules, and integration scenarios. All tests pass on clean build.
- Full Localization (i18n): Complete multi-language support.
- All messages and system reports moved to
lang/en.yml. - Automatic fallback system for missing keys.
- Simplified
config.ymlwith a newlanguagetoggle.
- All messages and system reports moved to
- Rich Text Support: Integrated MiniMessage for modern, easy-to-read chat formatting using tags (e.g.,
<red>,<bold>,<click>). - PlaceholderAPI Integration: Full support for dynamic placeholders in all plugin messages and the Action Bar.
- Folia Support: Rewritten scheduler and event handling to support Folia's multi-threaded region architecture.
- Config Reload: Added
/vreloadcommand to apply configuration and language changes instantly without server restarts. - Interactive Reports: Professional clickable components in all command outputs.
- Titan Stealth Engine: Absolute packet-level invisibility for vanished administrators. The server now acts as if the vanished player does not exist in the network data.
- Tab List & Info Filtering: Blocked
PLAYER_INFOandPLAYER_INFO_UPDATEpackets to prevent any tab list flicker or presence detection. - Ghost-Proof Spawning: Intercepted
SPAWN_ENTITYandNAMED_ENTITY_SPAWNto ensure vanished players are never spawned on unauthorized clients. - Absolute Metadata & Update Blocking: High-priority interceptors for
ENTITY_METADATA,ENTITY_EQUIPMENT,ANIMATION,ENTITY_EFFECT,ENTITY_STATUS, andENTITY_SOUND_EFFECTto ensure zero data leakage. - Movement & Velocity Filtering: Blocked
ENTITY_VELOCITY,REL_ENTITY_MOVE,ENTITY_LOOK,ENTITY_TELEPORT, andENTITY_HEAD_ROTATIONto eliminate coordinate-level leaks. - Action Scrubber: Intercepted
COLLECT(item pickups) andSET_PASSENGERS(mounting) to scrub vanished names even when they are not the primary entity. - Team Scrubbing: Intercepted
SCOREBOARD_TEAMto remove vanished names from any raw team packets sent to non-staff.
- Tab List & Info Filtering: Blocked
- Plugin Hiding: "Vanishpp" is now hidden from
/plugins(or/pl) for non-OPs. Administrators see a filtered list with a delayed interactive notification to temporarily unhide or acknowledge the feature. - Strict Command Permissions: All commands now enforce strict permissions in
plugin.yml. Unauthorized players cannot see commands in Tab-Complete. - Config Logic:
vanishMessage,unvanishMessage,fakeJoinMessage, andfakeQuitMessagelogic updated. Setting these to"false","none", or leaving them empty inconfig.ymlnow properly disables the message. - Persistence: Acknowledging the plugin hiding warning now saves the preference to
data.ymlspecifically for the current version.
Changed
- Silent Chest Architecture: Replaced the spectator-mode workaround with a snapshot inventory system. Vanished players now open a copy of the container, and edits sync back on close — no animation, no sound, full item interaction.
- Throwable Blocking: Throwables (eggs, bows, ender pearls, etc.) are now governed by the
can_throwVRule instead of being unconditionally blocked. Players can toggle this rule like any other. - Spawn Egg Messages: Spawn eggs now use the standard
sendRuleDenysystem withcan_throw, providing interactive buttons instead of a static message. - Sound Suppression: Silent chest sound listener now covers both
NAMED_SOUND_EFFECTandCUSTOM_SOUND_EFFECTpackets with robust multi-offset coordinate detection. - Config Structure: Significant cleanup of
config.yml. Legacy message blocks removed in favor oflang/*.yml. - Performance: Optimized visibility checks and metadata handling for better server performance.
Fixed
- DiscordSRV Join/Quit Suppression: DiscordSRV now fully suppresses join and quit announcements on Discord for players who rejoin with persisted vanish state. Previously, only chat suppression worked — Discord join messages leaked through.
- Barrel/Shulker Silent Opening: Opening barrels and shulker boxes while vanished no longer leaks the open/close animation or sound to nearby players. Previously, the
Container.startOpen()call triggered both. - Join Prefix Delay: The vanish tab prefix (
[V]) now appears within ~100ms of joining instead of taking 3+ seconds. Multi-stage reapplication handles TAB plugin async overrides. - Throwable Items Leaked Position: Throwing eggs, snowballs, ender pearls, and shooting bows while vanished created visible projectile entities that revealed the player's position. Now blocked by default via the
can_throwrule. - Spawn Egg Rule Bypass: The
CAN_INTERACTrule had no effect on spawn eggs due to incorrect check ordering. Spawn eggs are now properly governed bycan_throw. - Vanish State Lost on Respawn: Dying and respawning while vanished caused loss of fly, invisibility, glow, collision settings, and night vision.
- Vanish State Lost on World Change: Entering nether/end portals broke vanish state (visibility, fly, glow, prefix).
- Flight Lost on Gamemode Change: Running
/gamemode survivalwhile vanished disabled fly mode permanently until re-vanishing. - Reload Didn't Resync:
/vreloadpreviously only reloaded config files without resyncing active vanish effects for online players. - Mob Targeting on Vanish: Mobs that had already acquired a player as their target before
/vanishwas used would continue attacking. Fixed by explicitly clearing all matching mob targets within 64 blocks the moment a player vanishes. - Console Staff Notification: Console was silently excluded from vanish/unvanish staff notifications. It now receives the same message as staff players with
vanishpp.see. - Fly Mode Logic: Improved flight persistence on unvanish when configured.
- Dependency Resolution: Fixed an issue where the ProtocolLib dependency was not correctly detected on first install.
Added
- No-Delay Notifications: Completely removed the 60-second cooldown for rule notification alerts. Players now receive immediate feedback every time an action is blocked while vanished.
- Enhanced Splash Protection: Vanished players are now strictly immune to Splash Potions and Lingering Potion Clouds. They are automatically removed from the list of affected entities.
- Titan God Mode: Vanished players are now strictly invincible. They take no damage and are immune to all external potion effects (splash potions, mob effects).
- Interactive Help System: Added
/vhelpand/vhelp <command>. A professional, clickable chat menu that explains every command, usage, aliases, and permissions. - Smart-Merge Migration (v2): Completely overhauled the configuration update system. Future config changes now recursively copy all user-customized values (messages, rules, prefixes) into new versions without loss. NOTE: Critical fix applied to prevent data loss on update failure.
- Join Notification Delay: All join notifications (warnings, updates, migrations) now wait 250ms to ensure they appear at the bottom of the chat, visible above other plugin spam.
- Acknowledgement System: Migration reports now stay visible on join until specifically hidden via the new [HIDE] button.
Changed
- Unified Rules:
/vpickupand other individual toggles now strictly sync with the RuleManager engine. - Config Cleanup: Removed redundant
datasection fromconfig.ymldefault template to prevent user confusion (usesdata.ymlexclusively). - Downgraded Requirement: Reverted target Minecraft version to 1.21.11 (Paper) and ProtocolLib 5.4.0 for broader compatibility.
Fixed
- Critical Migration Bug: Fixed a logic error where the migration manager would overwrite the configuration file with a default template before saving the merged data, leading to reset settings if the save failed.
- Prefix Leakage: Strictly decoupled Tab prefixes from Nametag prefixes. Prefix text will no longer "leak" into Scoreboards or the Social Interaction menu.
- Persistence Fix: Fixed an issue where manual config edits were overwritten by the plugin's automatic data saving.
Fixed
- Config Bug: The config now affects if the fake join and leave messages display when vanishing.
Fixes and Update Checker implemented
Added
- Smart Mob AI (True Sight Engine):
- Vanish++ now injects custom AI goals into server mobs. Mobs will physically ignore vanished players—they will not look at you, track you, or turn their heads, even if you stand directly in front of them.
- This replaces the old "Invisibility Potion" workaround, allowing Staff to see each other's armor/skins clearly while remaining invisible to mobs.
- Modrinth Update Checker:
- Added an asynchronous update checker. OPs (or those with
vanishpp.update) will receive a notification on join if a newer version is available on Modrinth. - Settings added to
config.ymlto toggle this feature or restrict it to a specific list of players.
- Added an asynchronous update checker. OPs (or those with
- Data Separation (Config Fix):
- Created
data.yml. Dynamic data (vanished players, ignored warnings, custom rules) is now stored here. - Fix: This prevents
config.ymlfrom being overwritten on server restart, allowing you to edit settings safely while the server is running.
- Created
- Temporary Rules:
- The
/vrulescommand now accepts a duration. - Example:
/vrules can_break_blocks true 60will allow breaking blocks for 60 seconds, then automatically disable it.
- The
- Visual Feedback:
- Added Action Bar alerts ("✖ Action Blocked") when a player attempts a prohibited action, providing immediate feedback without spamming chat.
- Added an [ENABLE 1m] button to chat warnings for quick temporary overrides.
Fixed
- ProtocolLib Crashes: Fixed critical
NullPointerExceptionandFieldAccessExceptioncrashes on 1.21+ servers caused by malformed packets from other plugins. - TAB Plugin Compatibility: Fixed a crash with the TAB plugin hook by switching to the correct API method for prefix management.
- Smart Mob AI (True Sight Engine):
Massive feature update and fixes :D
[1.1.0] - 2026-01-03
Added
- Java 21 / MC 1.21 Support: Full compatibility with the latest Minecraft versions.
- Legacy Plugin Compatibility: Vanished players now automatically have the standard Bukkit
"vanished"metadata set. - Dependency Warning System: Added a chat/title/sound warning for OP players on join if ProtocolLib is missing.
- Ignore Warning Command: Added
/vanishignoreto permanently silence the ProtocolLib warning. - Universal Command Targets:
/vrules,/vpickup, and/vignorenow accept an optional target player. - Heartbeat Synchronization: Force-refreshes visibility every second to handle permission changes instantly.
- ProtocolLib Tab Scrubbing: Vanished players are removed from Tab-Complete packets.
- Dropping Rule: Added
can_drop_itemsrule (Default: false). - TAB Plugin Hook: Native integration with NEZNAMY's TAB plugin to set prefixes without placeholders.
Changed
- Visibility Logic: Removed the Vanilla Invisibility Potion effect. This ensures that Staff with permission can see the vanished player's armor and skin, while normal players still see nothing (handled via packet hiding).
- Mob AI: Mobs are prevented from targeting vanished players via event cancellation, though head tracking may occur visually due to the removal of the invisibility potion.
Fixed
- Mob Gazing: Fixed mobs looking at vanished players.
- Join Visibility Flash: Moved join event priority to
LOWEST. - Server List Hover: Fixed a bug where vanished players appeared in the sample list.
- Chat Confirmation Loop: Fixed logic so confirmed messages don't re-trigger the blocker.
[1.0.4] - 2025-12-25
Added
- ProtocolLib Integration:
- Ghost View: Staff members see vanished players in the TabList as Spectators (gray/italic).
- True Invisibility: Packet-level hiding from Server List counts.
- Plugin Hooks: EssentialsX, Dynmap, PlaceholderAPI.
- Per-Player Rules: Added
/vrulesconfiguration. - Chat Confirmation: Added
/vanishchat.
Fixed
- Projectile Physics: Switched to Paper's
ProjectileCollideEvent. Arrows physically pass through vanished players. - Entity Collision: Disabled collision via Scoreboard Teams.
[1.0.3] - 2025-12-25
Added
- ProtocolLib Integration:
- Ghost View: Staff members with permission (
vanishpp.see) now see vanished players in the TabList as Spectators (gray and italicized), distinguishing them from normal players. - True Invisibility: Packet-level handling ensures vanished players are completely hidden from the Server List player count.
- Ghost View: Staff members with permission (
- Plugin Hooks:
- EssentialsX: Vanished players are now hidden from
/who,/list, and/online. - Dynmap: Vanished players are automatically hidden from the web map.
- PlaceholderAPI: Added
%vanishpp_is_vanished%and%vanishpp_vanished_count%placeholders.
- EssentialsX: Vanished players are now hidden from
- Per-Player Rules System: Added
/vanishrules(alias/vrules) to configure personal restrictions (breaking blocks, hitting entities, etc.). - Chat Confirmation: Added
/vanishchat. If strict chat rules are enabled, players must confirm messages before sending them to prevent accidental leaks.
Fixed
- Projectile Physics (Native Pass-Through):
- Switched to Paper's
ProjectileCollideEventfor absolute stability. - Arrows, tridents, and snowballs now natively pass through vanished players without any "teleporting" hacks or visual glitches. It is now physically impossible to hit a vanished player with a projectile.
- Switched to Paper's
- Entity Collision: Vanished players can no longer push or be pushed by other entities (players, mobs, boats) via Scoreboard Team collision rules.
- Data Persistence: Player rules and settings now save correctly to
config.yml(underdata).
Changed
- Dependencies: Added
ProtocolLib,PlaceholderAPI,Dynmap, andEssentialsXas soft dependencies.
All notable changes to this project will be documented in this file.
[1.0.2] - 2025-012-25
Added
- Per-Player Rules System: Introduced the
/vanishrules(alias/vrules) command. Vanished players can now granulary configure what they can and cannot do while vanished.- Usage:
/vrules <rule> [true|false] - Available Rules:
can_break_blocks(Default: true): Allow/disallow breaking blocks.can_place_blocks(Default: true): Allow/disallow placing blocks.can_hit_entities(Default: false): Prevents hitting players or mobs to ensure absolute stealth.can_pickup_items(Default: false): Toggles item pickup (Replaces the old toggle command).can_trigger_physical(Default: false): Prevents triggering pressure plates, tripwires, farmland, and turtle eggs.can_interact(Default: true): Allow/disallow opening chests, using buttons, levers, etc.can_chat(Default: false): If disabled, chat messages require manual confirmation.mob_targeting(Default: false): If enabled, mobs will attack you even while vanished.
- Usage:
- Accidental Chat Prevention: If the
can_chatrule is disabled, attempting to chat will now block the message and prompt you to run/vanishchat confirmto send it. - Command Feedback: Added clear, color-coded chat feedback for all command interactions.
Fixed
- Projectile Phasing (The "Matrix" Fix): Completely overhauled how arrows and projectiles interact with vanished players.
- Previously, arrows would bounce off or drop at the player's feet, revealing their location.
- Now: Projectiles detect the vanished player, are momentarily removed, and instantly re-spawned on the other side of the player with the exact same velocity and shooter data. To outside observers, arrows now fly perfectly straight through vanished players as if they were truly ghosts.
- Entity Collision: Fixed an issue where vanished players could push or be pushed by other entities (players, boats, mobs). Collision is now strictly disabled via Scoreboard Teams logic.
- Data Persistence: Player rules and settings are now saved reliably in the
datasection of the configuration, ensuring settings persist across server restarts.
[1.0.1] - 2025-06-10
Added
- Silent Chests: Opening Chests, Shulker Boxes, and Barrels while vanished is now silent (no animation/sound) and lets you view the inventory without alerting others.
- Night Vision: Vanished players automatically get Night Vision.
- Flight Mode: Vanished players can now fly automatically, even in Survival.
- Mob Stealth: Mobs will no longer target vanished players.
- No Hunger: Vanished players no longer lose hunger.
- Configuration: Added
invisibility-featuressection toconfig.ymlto toggle these new features.
Fixed
- Arrow Phasing: Arrows and projectiles now pass through/ignore vanished players, preventing the "floating arrow" glitch and ensuring stealth.
- Silent Chest Animation: Utilized a temporary spectator-mode switch to ensure chest lid animations do not trigger for other players.
The first stable and fully working release of Vanish++!
