Skip to content

ZelVanish

Configuration (settings.yml)

Top-level options

vanish-on-join

Players with zelvanish.vanish auto-vanish when they join.

  • true: every staff member joins invisible
  • false (default): join visible, toggle with /vanish

remember-vanish-state

Players return to their last vanish state on rejoin, including across server restarts. State is persisted to vanishStates.json in the plugin folder.

  • true: a staff member who logged off vanished will rejoin vanished
  • false (default): join visible every time

prefix

Prefix prepended to every ZelVanish message. Supports legacy color codes (&c) and #RRGGBB hex. Leave empty ("") for no prefix.

  • Default: "&cZelVanish &8» &f"

vanished-behavior

What others see, and what vanished players experience.

show-join-message / show-leave-message

Whether the vanilla join/leave broadcast is suppressed when a vanished player connects or disconnects.

  • false (default): silent join/leave for vanished players
  • true: vanilla messages still fire (use this if you want fake-message broadcasts only — see messages.yml)

takes-damage

Receive damage from mobs and other players while vanished.

  • false (default): invulnerable while vanished
  • true: take damage normally

loses-hunger

  • false (default): hunger frozen while vanished
  • true: hunger drains normally

mobs-target

Whether mobs aggro vanished players.

  • false (default): mobs ignore vanished players
  • true: mobs target as usual

grant-flight

Whether to enable creative flight when entering vanish.

  • true (default): allow-flight set on vanish
  • false: keep current flight state

keep-flight-after-unvanish

Whether flight is preserved after unvanishing.

  • false (default): flight removed on unvanish (unless the player has zelvanish.keep-fly or is in spectator)
  • true: flight always preserved

potion-effects

List of infinite potion effects applied while vanished. Format EFFECT_NAME:AMPLIFIER where 1 = level I, 2 = level II, etc. Effect names follow the Minecraft registry.

potion-effects:
- "INVISIBILITY:2"
- "NIGHT_VISION:1"

Active effects present before vanish are stored and restored on unvanish.

hooks

Each entry toggles a soft integration. Disabling a hook makes the integration a no-op even when the target plugin is installed.

HookEffect
essentialsHides vanished players from /list, /whois, etc.
server-listRemoves vanished players from the server list ping.
placeholdersRegisters PlaceholderAPI placeholders (see Placeholder Page).
discordsrvSuppresses DiscordSRV join/leave for vanished players and respects fake broadcasts.
dynmapHides vanished players from the Dynmap web map.
squaremapHides vanished players from the squaremap web map.
libsdisguisesRemoves disguises when a player vanishes.