# PremiumVanish v2.0.16 - Configuration

##################################################
############# Invisibility Features ##############
##################################################
InvisibilityFeatures:
  # Should invisible players get night vision? (client-side)
  NightVisionEffect: true
  # Should PV disable damage for invisible players?
  DisableDamage: true
  # Should PV disable hunger for invisible players?
  DisableHunger: true
  # Should PV prevent mobs from targeting invisible players?
  DisableMobTarget: true
  # Should invisible players not be able to stop the placement of blocks at their location?
  # While this stops other players from revealing invisible players by spamming blocks around them
  # it can also be abused since it allows placing blocks at impossible locations
  DisablePreventBlockPlacement: true
  # Should invisible players only be able to send chat messages if the message ends with the following character?
  # You can set this to 'deny' to cancel the message in any case.
  # Please leave this empty if you'd like to disable the feature.
  RequireChatMessageSuffix: ""
  # Should invisible players open chests and shulker boxes without the animation and sound?
  # (This makes them go into spectator mode temporarily)
  OpenChestsSilently: true
  # Should invisible players be able to open a player's inventory by right-clicking the player?
  # Permission: pv.openplayerinv
  OpenPlayerInventoryOnRightClick: true
  # Should invisible players be able to edit inventories (including their own) even if they're in spectator mode?
  # Permission: pv.spectatoreditinv
  AllowSpectatorInventoryEdit: true
  # Should invisible players not be able to trigger pressure plates and tripwire?
  # If this feature is enabled invisible players can't trigger pressure plates and tripwire.
  DisablePressurePlates: true
  # Should invisible players not be able to push other players or be able to be pushed?
  # WARNING: Uses the scoreboard and may conflict with other plugins!
  DisablePush: false
  # Should invisible players be hidden in the tablist?
  # Note: Not every player hider supports showing invisible players
  # in the tablist, please use the Interception hider to be able to turn this off
  # (see the INVISIBILITY METHOD section below)
  HideInTablist: true
  # If HideInTablist is turned off, should players who can't see you not be able to
  # see you as a spectator in the tablist even if you are in spectator mode?
  HideSpectatorMode: true
  # Should vanished players pick up items by default? This can be changed individually with /pv tipu
  DefaultPickUpItemsOption: false
  # The commands to execute when a player vanishs (online or offline)
  # These commands are ran by console by default, you can use %p% to get the player's name.
  # You can also prefix the command with [P] to make the player run the command
  # instead of the console (player online only)
  # You can remove the brackets and make it a list if you'd like to enable this
  VanishCommands: []
  # The commands to execute when a player reappears (online or offline)
  # These commands are ran by console by default, you can use %p% to get the player's name.
  # You can also prefix the command with [P] to make the player run the command
  # instead of the console (player online only)
  # You can remove the brackets and make it a list if you'd like to enable this
  ReappearCommands: []
  # You can make any command not execute and instead return a custom message if an argument is a vanished
  # player's name. Useful for faking 'Player not found' messages if there are unsupported plugins.
  # You can use <vanished> as a placeholder for any vanished player's name.
  # Any message which STARTS WITH the text you define below (case-insensitive) will
  # be cancelled and will instead send the sender of the command a message you specify.
  # The /plugin:command syntax is covered automatically.
  # This is server-sided, for bungeecord commands go to the Bungee's PV config
  CustomCommandMessages:
    '/examplemsg1 <vanished>': "&cPlayer not found"
  # For how many seconds should players not be able to take environmental damage after they reappear?
  # e.g. fall damage or lava damage; Set to 0 to disable it
  DisableEnvironmentalDamageAfterReappear: 5
  # Should vanished players not be required to sleep for other players to wake up?
  SetSleepingIgnored: true
  # Should vanished players switch between their current gamemode and spectator mode when they
  # press shift twice? Permission: pv.switch
  SwitchGamemode: false

##################################################
############# Vanish State Features ##############
##################################################
VanishStateFeatures:
  # Should players with the permission 'pv.joinvanished' join vanished all the time?
  # Doesn't work if you use GroupManager for permissions
  AutoVanishOnJoin: false
  # Should invisible players reappear automatically when they change their world?
  ReappearOnWorldChange: false
  # Should invisible players reappear automatically when they leave the server?
  ReappearOnQuit: true
  # Should invisible players reappear automatically
  # when they change their world and don't have the permission 'pv.use' anymore?
  CheckPermissionOnWorldChange: false
  # Should invisible players reappear automatically
  # when they leave the server and don't have the permission 'pv.use' anymore?
  CheckPermissionOnQuit: false
  # Should invisible players reappear automatically
  # when they join the server and don't have the permission 'pv.use' anymore?
  # Doesn't work if you use GroupManager for permissions
  CheckPermissionOnLogin: false

##################################################
############## Indication Features ###############
##################################################
IndicationFeatures:
  LayeredPermissions:
    # Should players with the permission 'pv.see' be able to see invisible players in the tablist & in-game?
    EnableSeePermission: true
    # Should pv.use and pv.see be layered? => pv.use.levelX, pv.see.levelX
    # Players can see a vanished player if their see level is higher or equal to the other player's use level
    # Note: You have to rejoin for changes to take effect if you changed those permissions while being online
    LayeredSeeAndUsePermissions: true
    # What should be the highest level for both permissions?
    # Lower amounts might improve performance with more players since they reduce the amount of permission checks
    MaxLevel: 4
    # If LayeredSeeAndUsePermissions is enabled, should /pv list only show players which the command sender is
    # allowed to see and should players only be able to toggle the invisibility of players which they are allowed
    # to see (Only affects online players)?
    HideInvisibleInCommands: false
    # Should PremiumVanish iterate through all the permissions of a player instead of checking for all
    # possible layered permissions? Enabling this may or may not improve PV's performance.
    # Warning: Enabling this may break PV depending on your permissions plugin
    AlternatePermissionChecking: false
  # Should vanished players show up dark gray in the tablist and should only their head be visible?
  # Only players who are allowed to see the player will see this effect; this helps other staff with
  # differentiating them from players they should talk to
  MarkVanishedPlayersAsSpectators: true
##################################################
########### Survival Friendly Features ###########
##################################################
SurvivalFriendlyFeatures:

  Fly:
    # Should invisible players be able to fly even if they aren't in creative/spectator mode?
    Enable: true
    # Should invisible players WITHOUT the permission 'pv.keepfly' lose the ability to fly on reappear?
    DisableOnReappear: true

  GameMode:
    # The gamemode which players will get when they vanish
    # 'Default' applies for every world which isn't mentioned below
    # !! Warning: World names are case-sensitive !!
    # Available gamemodes: SURVIVAL, ADVENTURE, CREATIVE, SPECTATOR, KEEP
    # KEEP won't change the gamemode in any way
    ChangeToOnVanish:
      Default: CREATIVE
      ExampleWorld123: SPECTATOR
    # The gamemode which players will get when they reappear
    # 'Default' applies for every world which isn't mentioned below
    # Available gamemodes: SURVIVAL, ADVENTURE, CREATIVE, SPECTATOR, KEEP
    # KEEP won't change the gamemode in any way
    ChangeToOnReappear:
      Default: SURVIVAL
      AnotherExampleWorld2: SURVIVAL
    # Should PV update the gamemode 1 tick after a player joins/changes their world?
    # The new gamemode will depend on the player's new world, as defined above
    # Helpful if you want to force players to be in a gamemode in a specific world
    # or if another plugin interferes with PV.
    ReApplyGameModeChangeOnWorldChange: true
    ReApplyGameModeChangeOnJoin: true
    # Should the gamemode change when you join vanished *because of* your pv.joinvanished permission?
    # Ignores the two settings above.
    AlwaysApplyOnJoinVanished: true

  Location:
    # Should vanished players be teleported back to where they vanished when they reappear?
    # The location is saved in the playerdata.yml file and is therefore safe in case of a restart/crash
    # Bypass permission: pv.bypassteleportback
    TeleportBackOnReappear: true

##################################################
################ Message Options #################
##################################################
MessageOptions:

  FakeJoinQuitMessages:
    # Should PV broadcast a fake quit message when a player vanishs?
    # You can change this message in the messages.yml file.
    BroadcastFakeQuitOnVanish: false
    # Should PV broadcast a fake join message when a player reappears?
    # You can change this message in the messages.yml file.
    BroadcastFakeJoinOnReappear: false
    # Should players with the permission 'pv.see' get a different message when a player vanishs/reappears?
    # You can change this message in the messages.yml file.
    AnnounceVanishReappearToAdmins: true
    # Should only players with the permission 'pv.see' receive fake join/quit messages?
    SendMessageOnlyToAdmins: false
    # Should only players without the permission 'pv.see' receive fake join/quit messages?
    SendMessageOnlyToUsers: false

  # Should PV hide the real join/leave messages of invisible players?
  HideRealJoinQuitMessages: true
  # Should PV hide leave messages for invisible players if 'VanishStateFeatures->ReappearOnQuit' is turned on?
  # Overrides 'HideRealJoinQuitMessages'
  ReappearOnQuitHideLeaveMsg: true
  # If the setting above is turned on, should players with the permission 'pv.see' get
  # a message when an invisible player joins/quits?
  AnnounceRealJoinQuitToAdmins: true
  # Should PV remind players who join the server vanished of being invisible (in chat)?
  # You can change the message in the messages.yml file.
  RemindVanishedOnJoin: true
  # Should invisible players have an action bar which tells them that they're invisible?
  # You can change the action bar in the messages.yml file.
  DisplayActionBar: false

##################################################
############## Restrictive Options ###############
##################################################
RestrictiveOptions:
  # Should invisible players not be able to break blocks?
  # Bypass permission: pv.breakblocks
  PreventBlockBreaking: true
  # Should invisible players not be able to place blocks?
  # Bypass permission: pv.placeblocks
  PreventBlockPlacing: true
  # Should invisible players not be able to interact with doors, levers, buttons, note blocks, etc?
  # Doesn't prevent opening containers
  # Bypass permission: pv.useblocks
  PreventBlockUse: true
  # Should invisible players not be able to interact with anything
  # (blocks, buttons, pressure plates, chests, block breaking/placing, noteblocks, doors, ...)
  # This setting overrides the three settings above
  # Bypass permission: pv.interact
  PreventInteract: false
  # Should invisible players not be able to damage players or mobs?
  # Bypass permission: pv.damage
  PreventHittingEntities: true
  # Should invisible players not be able to drop items?
  # Bypass permission: pv.dropitems
  PreventDroppingItems: true
  # Should invisible players not be able to modify their own inventory?
  # Bypass permission: pv.modifyowninv
  PreventModifyingOwnInventory: true
  # Should invisible players not be able to modify containers or other player's inventories?
  # Overrides InvisibilityFeatures.AllowSpectatorInventoryEdit
  # Bypass permission: pv.modifyotherinv
  PreventModifyingOtherInventory: true
  # Should invisible players not be able to tp to other players using the spectator menu?
  # Bypass permission: pv.spectatortp
  PreventSpectatorTeleporting: false
  # Should invisible players in creative mode not be able to cheat items?
  # Bypass permission: pv.creativeitems
  PreventCreativeItemGrab: true
  # Should invisible players not be able to view their coordinates? (client-side)
  # Bypass permission: pv.viewcoords
  HiddenCoordinates: false

  Commands:
    # Which commands should vanished players not be able to use?
    # This blocks the 'plugin:command' syntax too but not aliases
    # Bypass permission: pv.bypasscmd
    VanishedCommandBlacklist:
    - examplecommand123test
    # Should vanished players only be able to use the commands listed above instead?
    UseAsWhitelist: false

##################################################
############# External Invisibility ##############
##################################################
ExternalInvisibility:

  ServerList:
    # Please use PremiumVanish's bungeecord configuration instead if you use Bungeecord.
    #
    # Should this plugin adjust the amount of players in the serverlist? (-1 per invisible player)
    AdjustAmountOfOnlinePlayers: true
    # Should this plugin hide invisible players in the list of logged in players?
    # You can view this list when your mouse hovers over the amount of online players.
    AdjustListOfLoggedInPlayers: true

##################################################
############### Scoreboard Options ###############
##################################################
ScoreboardOptions:
  # Disable this if you don't need PremiumVanish's scoreboard features
  # Note: If you are disabling this because it causes problems with other scoreboards/prefixes
  # then you probably want to disable 'DisablePush' above as well since it uses the scoreboard too
  Enable: true

  # Should players require the permission pv.scoreboard to view the scoreboard?
  Permission: false

  Sidebar:
    # The header/title of the scoreboard, default: '&6>       PremiumVanish       <'
    # The length cannot be longer than 32 characters(including color codes) but can cause flickering
    # if it isn't longer than the lines below it
    ScoreboardHeader: "&2Staff&cMode"
    # The lines of PremiumVanish's scoreboard
    # Prefix a line with a # if it should only show up if there is a target (the placeholders will
    # also be based on the target)
    # A line can never be longer than 32 characters for a player (watch out for player names)
    Lines:
    - "&m--------------"
    - "&fPing: &e%ping%"
    - "&fTPS: &e%tps%"
    - "&fTime: &e%time{hh:mma}%"
    - "&fDate: &e%time{yyyy/MM/dd}%"
    - ""
    - "&aAusHeroes.net"
    # The interval between each update of the info on the scoreboard
    # in ticks, decreasing this might decrease performance slightly
    # 20 ticks equals to 1 second, default: 5
    InfoUpdateInterval: 5
  Targeting:
    # Should the scoreboard show information about the closest player automatically?
    # If you're spectating, this option would always show the info of the player you're currently spectating.
    AutoTargetClosestPlayer: false
    # Should you target players when you right-click them?
    # If both this option and 'OpenPlayerInventoryOnRightClick' is enabled then you
    # are still able to lock a player by sneaking and right-clicking the player.
    # (In spectator mode you can press space and shift at the same time for the same effect)
    # If 'AutoTargetClosestPlayer' is enabled then it will stop targeting the closest player when
    # you right-click a player until you type '/pv unlock', same for /pv target <player> even if this option
    # is disabled
    TargetOnRightClick: false
    # Should your current target glow (only you see this effect)?
    TargetGlows: false

##################################################
################## Hook Options ##################
##################################################
HookOptions:
  # Should PV hide invisible players in /who, /list, /online, /near, etc?
  # Note: Players with the permission essentials.vanish.interact can still see invisible players in these commands
  # Important: You have to reload both PV and Essentials if you change this setting (reload PV first)
  EnableEssentialsHook: true
  # Should PV hide invisible players on your dynamic map and broadcast join/leave messages if you use Dynmap?
  EnableDynmapHook: false
  # Should PV send fake join/leave messages in dynmap's web-chat?
  # You can configure the join/leave messages in the messages.yml file
  DynmapSendJoinLeaveMessages: true
  # Should PV prevent players from being invisible and disguised at the same time? (LibsDisguises commands)
  # It's recommended to keep this turned on to prevent incompatibility.
  EnableLibsDisguisesHook: true
  # Should PV prevent players from being invisible and disguised at the same time? (DisguiseCraft commands)
  # It's recommended to keep this turned on to prevent incompatibility.
  EnableDisguiseCraftHook: true
  # Should PV hook into TrailGUI and disable trails while you're vanished?
  EnableTrailGUIHook: true
  # Should PV hook into SuperTrails and disable trails while you're vanished?
  EnableSuperTrailsHook: true
  # Should PV hook into PlaceholderAPI and add new placeholders to PV + register its own ones for other plugins?
  # Own ones: isvanished, vanishedplayers, playercount, bungeeplayercount
  # Format: %premiumvanish_<placeholder>%
  EnablePlaceholderAPIHook: true
  # Should PV hook into MVdWPlaceholderAPI and add new placeholders to PV + register its own ones for other
  # plugins?
  # Own ones: isvanished, vanishedplayers, playercount, bungeeplayercount
  # Format: {premiumvanish_<placeholder>}
  EnableMVdWPlaceholderAPIHook: true
  # Should PV stop NPCs from greeting or talking about hidden players?
  EnableCitizensHook: true
  # Should PV hook into CustomParticleEffects and disable particles while you're vanished?
  EnableCustomParticleEffectsHook: true
  # Should PV use NametagEdit's API for prefixes and suffixes in the tablist?
  EnableNametagEditHook: true
  # Should PV hook into FeatherBoard to prevent incompatibilities with its scoreboard?
  EnableFeatherBoardHook: true
  # Should PV hook into EnjinMinecraftPlugin to prevent vanished players from showing up on its website?
  EnableEnjinMinecraftPluginHook: true

##################################################
############## Invisibility Method ###############
##################################################
InvisibilityMethod:
  # The method of hiding players; Available methods: Bukkit, ProtocolLib, Combined

  # 'Prevention': Uses Bukkit's API to hide players, this is an extremely reliable method if other plugins don't break it.
  # This method ALWAYS hides invisible players in the tablist for players that can't see them.
  # The chance that another plugin breaks this method is medium depending on the amount and type of plugins.
  # > Recommended if other hiders cause issues; other plugins can break this method though
  # (Accuracy: 95%) (Plugin compatibility: 80%)

  # 'Interception': Uses ProtocolLib to hide players. Takes the whole packet stuff into its own hands to cancel every
  # single packet of hidden players.
  # This method CAN show invisible players in the tablist for players who can't see them if that's enabled.
  # Hard to break, however, other plugins might not provide direct support for this hider
  # > Recommended if you want to show invisible players in the tablist
  # (Accuracy: 95%) (Plugin compatibility: 90%)

  # 'Hybrid: Uses both ProtocolLib and Bukkit's API to hide players, this method does NOT support showing players
  # in the tablist but it contains two layers of security and is therefore an extremely effective method.
  # The chance that another plugin breaks this method is extremely small
  # > Default hider; Recommended if you don't want to show invisible players in the tablist
  # (Accuracy: 100%) (Plugin compatibility: 98%) - DEFAULT

  PlayerHider: "Hybrid"

  # Note: Even 'Hybrid' can't stop players from figuring out whether invisible players are online if another
  # plugin tells them but players will never be able to see them at all or figure out their location
  # (Essentials is 99% compatible)

  # Should the Hybrid and Interception hiders intercept Scoreboard Team packets too? It prevents
  # non-existing but theoretically possible hacked clients from figuring out whether an invisible
  # player is online however it can also cause problems with tablist player prefixes and suffixes
  # by other plugins.
  StrictInvisibility: false

##################################################
############# Compatibility Options ##############
##################################################
CompatibilityOptions:
  # This section is for advanced users only!
  # The event priority which PremiumVanish should use for the specific event.
  # Allowed values are LOWEST, LOW, NORMAL, HIGH, HIGHEST and MONITOR
  # Higher priorities might override other plugins while lower ones might not

  # The priority for removing the join message
  PlayerJoinEventPriority: HIGH # <- keep HIGH if you use Essentials to modify join/quit messages !!
  # The priority for removing the quit message
  PlayerQuitEventPriority: HIGH
  # The priority for cancelling chat messages
  AsyncPlayerChatEventPriority: HIGH
  # The priority for cancelling commands
  PlayerCommandPreprocessEventPriority: HIGH

  # Should the Interception and Hybrid methods of hiding players not intercept tab packets?
  # Fixes players getting kicked from the server when they tab-complete and BungeeCord is installed and
  # another plugin messes around with packets too
  DisableHandlingOfTabulatorPackets: false

##################################################
############# Miscellaneous Options ##############
##################################################
MiscellaneousOptions:

  Bungeecord:
    # Should PremiumVanish store its data in a MySQL-Database and enable Bungeecord support?
    # Bungeecord is not required for this feature but it's recommended!
    # PremiumVanish will be disabled if this is enabled and the connection to the database failed.
    # Important: Please make sure that ip-forwarding is enabled on your Bungee AND your Bukkit servers
    Enable: false
    # The ip of your database server
    Ip: ""
    # The port of your database, usually 3306; just leave it empty if there is no specific port
    Port: "3306"
    # You can make PremiumVanish ignore the two options above and use a direct URI to connect instead
    # Format for MySQL servers: jdbc:mysql://<yourIp>:<yourPort>/<yourDatabase>
    # You can add ?verifyServerCertificate=false to the end of it if there are SSL errors in the console
    CustomURI: ""
    # The name of your database user
    User: ""
    # The password of your database user
    # WARNING: Please make sure only people who are allowed to know the password can access this file
    Password: ""
    # The name of the database which PremiumVanish should create its tables in
    # Note: PremiumVanish won't create this database, it must be pre-created using eg. phpMyAdmin
    Database: ""
    # Not recommended; Makes PV use the standard JDBC connector instead of the more powerful multi-pooled HikariCP one
    # You can give this a try if you have strange problems with connecting to your database
    BasicDatabaseConnector: false

  AntiSpam:
    # Should PV prevent spamming commands which can cause lag or spam the console?
    # Bypass permission: pv.bypassspam
    # ("/pv list" (if mysql is enabled), "/pv [on|off] <Player>" (mysql), "/pv reload" (+5secs), "/pv printstacktrace")
    AntiSpamCheck: true
    # If so, how many seconds should players have to wait before running such a command again?
    AntiSpamDelay: 1
    # Should AntiSpam always cover actions which toggle vanish? e.g. /pv, /pv <Player>
    AlwaysCoverVanish: false

  Command:
    # What should be premiumvanish's main command?
    Name: "pv"
    # A list of possible aliases
    Aliases:
    - "premiumvanish"
    # Replaces Essentials's standard vanish commands, you can still use them by doing /ev or /evanish
    - "v"
    - "vanish"
    # Used as an alias for /pv list
    - "vlist"
    # Should the aliases defined above override same-named commands of other plugins?
    ForceOverrideForAliases: true

  UpdateChecker:
    # Should PV check for updates on spigot regularly? There is no automatic update; this just informs you
    Enable: true
    # Should players with the permission 'pv.notify' get notified if the current version of PV is outdated?
    NotifyAdmins: true

##################################################
################# Do Not Touch ###################
##################################################
ConfigVersion: 2.0.16