Issues & Suggestions

Visit our Discord for any issues or suggestions!

---

This plugin has several useful toggles that (if enabled) will allow staff members to personalize their experience in vanish for each situation.

Features

• Per-player settings (see below)
• Cross-server support via MySQL database
• Fake join/leave messages
• Hide container opening while vanished
• Hide elytra rocket boosts while vanished
• Customizable messages
• much more!

Settings

Setting	Description
DISABLE_JOIN_MESSAGES	Disable minecraft messages from joining/leaving while in vanish
DISABLE_ITEM_PICKUP	Prevents items or exp orbs from being picked up
DISABLE_ITEM_DROP	Prevents items from being dropped
DISABLE_BLOCK_BREAK	Prevent yourself from breaking blocks in vanish
DISABLE_BLOCK_DETECTION	Prevent being detected by tripwire hooks, pressure plates, etc.
VANISH_STATUS	If enabled, an actionbar message will appear while in vanish
LOGIN_VANISH	Enable to ALWAYS be vanished on login
PERSIST_VANISH	If you log out while vanished, you will log in vanished
FAKE_JOIN_MESSAGE	Send fake join/leave messages when vanishing
DISABLE_ATTACK	Prevent yourself from attacking mobs or players while in vanish
DISABLE_CHAT	Prevent yourself from sending messages

The fake join/leave messages can be changed in the config if your server uses custom messaging. Most other messages can also be configured

Commands

Command	Description
/v, /v enable, /v disable	Change vanish state
/v settings	Change personal settings
/vadmin enable	Enable vanish for another player, ignoring permissions
/vadmin disable	Disable vanish for another player
/vadmin setting	View/change settings for another player
/vadmin reset	Resets all of a player's settings and their vanish state
/vadmin reload	Reload plugin config and messages

Permissions

Permission	Description
donutvanish.use	Permission to use /v command
donutvanish.setting.	Give players permission to edit a setting
donutvanish.setting.*	Give players permission to edit all settings
donutvanish.see.	Allow someone to see vanished players with a lower weight than themselves, as well as be notified of when they vanish
donutvanish.see.messages.	Allow someone to be notified of when a player with a lower weight vanishes

If you don't want to give your staff members access to change settings, either dont give them permissions or disable per-player-settings in config.

PlaceholderAPI

PAPI can be used in all messages. A PAPI extension is also built in, currently only providing %donutvanish_isvanished%

Config

vanish-settings:
  per-player-settings: true # Allow staff to change individual settings


  defaults:
    # Default settings for vanished players.
    # If per-player settings are disabled, these are the global vanish settings

    fake-join-messages: true # Send fake join/leave messages when vanishing
    persist-vanish: true # If you log out vanished, you stay vanished next login
    login-vanish: false # Always vanish on login

    disable-join-messages: true # Disable join/leave messages when actually logging in or out
    disable-item-pickup: false # Prevent picking up items/exp
    disable-item-drop: false # Prevent dropping items
    disable-block-break: false # Prevent vanished players from breaking blocks
    disable-block-detection: true # Prevent pressure plates, tripwires, and sculk sensors from detecting vanished players
    disable-attack: true # Prevent attacking things in vanish
    action-bar: true # Show the actionbar reminder while vanished

  actionbar:
    enabled: true
    interval: 3 # Seconds between each actionbar message
    format: "<gray>You are currently vanished." # Supports MiniMessage and PlaceholderAPI

storage:
  # Options:
  # "pdc" - Store data directly on the player (no setup required, single server only)
  # "sqlite" - Store data in a local file-based database (single server only)
  # "mysql" - Store data in a MySQL database (point every server at the same instance for cross-server support)
  storage-type: sqlite

  sqlite:
    file-name: database.db

  mysql:
    host: localhost
    port: 3306
    database: donutvanish
    username: root
    password: ""
    use-ssl: false
    pool-size: 8


hooks:
  essentialsx:
    # Features: Prevent players from being marked afk, mark vanished players as hidden on /list command for those w/ permission
    enabled: true

updater:
  check-updates: true # Check for updates?
  join-message: true # Send a message to admins in chat when an update is available


messages:
  prefix: "&e[&6DonutVanish&e] "
  vanish_enabled: "%prefix%<green>Vanish enabled!"
  vanish_disabled: "%prefix%<green>Vanish disabled!"
  no_permission: "%prefix%<red>You do not have permission"
  fake_join: "{name} has joined the game"
  fake_leave: "{name} has left the game"
  reload: "%prefix%<green>DonutVanish reloaded!"

  # For players with vanishplugin.see permission
  staff_join_notif: "%prefix%<yellow>{name} <gold>has joined while vanished"
  staff_leave_notif: "%prefix%<yellow>{name} <gold>has left while vanished"
  staff_vanish_fake_notif: "%prefix%<yellow>{name} <gold>has vanished with a fake leave message"
  staff_unvanish_fake_notif: "%prefix%<yellow>{name} <gold>has unvanished with a fake join message"
  staff_vanish_notif: "%prefix%<yellow>{name} <gold>has vanished"
  staff_unvanish_notif: "%prefix%<yellow>{name} <gold>has unvanished"

compatibility:
  join-listener-priority: "HIGHEST" # Do not touch unless you know what you're doing.