✨ VanishCore

A lightweight, CMI-style vanish plugin built natively for Folia.

v1.0.3 · Folia 26.1.x · Java 21

VanishCore hides staff members from regular players — they are removed from view, from the tab list, and appear completely offline to common commands. It is written around Folia's regionized scheduler model, so it runs correctly on Folia without relying on the legacy Bukkit.getScheduler().

Features · Commands · Permissions · Placeholders · Configuration · Installation · Requirements

Features

🫥 Invisibility

• Vanished players are removed from other players' view entirely.
• Tab-list removal so the name no longer appears in the player list (requires ProtocolLib).
• Optional night vision while vanished (toggleable).
• Optional invisibility effect to hide held items and armor from clients still rendering them.

🔢 Vanish priority levels

• Each vanished player has a vanish level, so higher-ranked staff can see lower-ranked vanished staff while staying hidden from everyone else.
• Visibility is granted through vanishcore.level.<n> permissions — a viewer sees vanished players of their level or lower.
• vanishcore.see acts as the master permission and reveals all vanished players.

📦 Silent chest

• Open chests, barrels, shulker boxes, and ender chests without the lid animation or sound being shown to others.
• Requires ProtocolLib; disabled automatically if it is not installed.

👻 Appear fully offline

• Vanished players are reported as offline to configurable commands such as /msg, /pay, /tpa, and /trade — the sender simply gets "Player not found".
• The full list of intercepted commands is configurable.
• Staff with vanishcore.see (or sufficient level) can still reach vanished players normally.

🛡️ Protection while vanished

• Mobs do not target vanished players.
• Vanished players take no damage from player attacks or projectiles.
• Pressure plates, tripwires, and turtle eggs are not triggered.
• Item pickup can optionally be disabled.

🔇 Stay truly hidden

• Death messages are not broadcast when a vanished player dies.
• Advancement / achievement announcements are suppressed.
• Sculk sensors, sculk shriekers, and the Warden never detect a vanished player (vibrations are cancelled).
• Phantoms never spawn on vanished players — "time since rest" is reset so a phantom can't dive in and reveal them.

🎨 Settings GUI

• /vanishedit opens a clean, clickable settings menu.
• Every feature can be toggled at runtime — no config editing or restart required.
• Changes are saved immediately and the menu refreshes in place.

🌐 Cross-platform aware

• Floodgate / Geyser support: optionally skip raw-packet features (tab-list filtering, silent chest) for Bedrock players, since Geyser translates their packets. Entity-level hiding still applies to everyone.

⚙️ Additional options

• Vanish state persists across reconnects.
• Auto-vanish on join for permitted staff.
• Optional boss bar indicator while vanished.
• Optional hidden join/quit messages and staff notifications.
• PlaceholderAPI expansion for displaying vanish status anywhere.
• Fully configurable messages with & color codes.

Commands

Permissions

Note: vanishcore.see defaults to false, so operators do not see vanished players unless the permission is explicitly granted. Grant vanishcore.see (or a vanishcore.level.<n>) only to ranks that should be able to see vanished players.

Placeholders

Requires PlaceholderAPI. Expansion identifier: vanishcore.

Configuration

All behavior is configured in plugins/VanishCore/config.yml, or toggled live via /vanishedit.

vanish:
  apply-invisibility: false       # hide held items/armor on lingering clients
  apply-night-vision: true        # let vanished staff see in the dark
  prevent-mob-targeting: true
  prevent-item-pickup: false
  hide-join-quit-messages: true
  notify-staff-on-toggle: true
  persist-across-rejoin: true
  prevent-pvp-damage: true
  prevent-physical-triggers: true # pressure plates / tripwires / turtle eggs
  show-bossbar: true
  hide-death-messages: true
  hide-advancement-messages: true
  hide-from-sculk: true           # sculk sensors / shriekers / Warden
  prevent-phantoms: true
  fake-offline: true              # appear offline to /msg, /pay, /tpa, ...
  intercept-commands: [ msg, tell, pay, tpa, trade, ... ]

protocollib:
  silent-chest-open: true

geyser:
  skip-packet-features-for-bedrock: false

placeholders:
  status-vanished: "Vanished"
  status-visible: "Visible"

Every message is configurable with & color codes under the messages: section.

Installation

1. Place VanishCore-1.0.3.jar in your server's plugins/ folder.
2. (Optional) Install ProtocolLib to enable tab-list hiding and silent chest.
3. (Optional) Install PlaceholderAPI for the placeholders above.
4. (Optional) Install Floodgate if you run a Geyser/Bedrock setup.
5. Restart the server.
6. Adjust settings in plugins/VanishCore/config.yml, or use /vanishedit in-game.

Without ProtocolLib the plugin still runs — only tab-list hiding and silent chest are disabled.

🧵 Folia support

Folia ticks each region of the world on its own thread, so plugins that call the legacy Bukkit.getScheduler() can fail on Folia. VanishCore avoids this entirely:

• Uses RegionScheduler, EntityScheduler, and AsyncScheduler only.
• Entity and player actions run on the owning region thread, with retired-task callbacks.
• Shared state uses thread-safe concurrent collections.
• Bukkit.getScheduler() is never used.

Requirements