Configuration

The settings and options for this plugin can be configured in the BetterVanish.json file under the oxide/config directory. The use of a JSON editor or validation site such as jsonlint.com is recommended to avoid formatting issues and syntax errors.

{

“Show visual indicator (true/false)”: true,
“Visual indicator image address”: “https://i.imgur.com/dOvX4uA.png”,
“Visual indicator anchor min”: “0.1 0.001”,
“Visual indicator anchor max”: “0.17 0.10”,
“Visual indicator color”: “0.7 0 0 1”,
“Depth of an underground teleport (upon disconnection)”: 15.0,
“Block all incoming damage while vanished (true/false)”: true,
“Block all outgoing damage while vanished (true/false)”: true,
“Auto vanish on connect (true/false)”: true,
“Auto noclip on connect (true/false)”: true,
“Auto noclip on vanish (true/false)”: true,
“Turn off noclip on reappear (true/false)”: true,
“Persist vanish (don’t unhide upon leave & restore after restart)”: true,
“Use sound effects (true/false)”: true,
“Enable safepoints (true/false)”: true,
“Remove all safepoints after wipe (true/false)”: true,
“Config revision (do not edit)”: 4

}

Localization

The localization for this plugin can be configured in the BetterVanish.json file under the oxide/lang/en directory. The use of a JSON editor or validation site such as jsonlint.com is recommended to avoid formatting issues and syntax errors.

{
“CommandVanish”: “vanish”,
“CommandSetVanish”: “setvanish”,
“CommandUnvanishAll”: “unvanishall”,
“CommandInvSpy”: “invspy”,
“VanishDisabled”: “<color=#FF686B>Vanish disabled</color>”,
“VanishEnabled”: “<color=#91D6FF>Vanish enabled</color>”,
“VanishDisabledOther”: “<color=#FF686B>You disabled vanish on {0}</color>”,
“VanishEnabledOther”: “<color=#91D6FF>You enabled vanish on {0}</color>”,
“UnvanishedPlayers”: “<color=#FF686B>You unvanished {0} players!</color>”,
“SetVanishHelp”: “Syntax: /setvanish PlayerName”,
“SafePointNotSet”: “You haven’t set your <color=#F7B267>Safe Point</color>nType <color=#FF686B>/vanish safepoint</color> to save your current position.nYou will be automatically teleported there upon disconnection.”,
“SafePointSaved”: “Your current position is saved as a Safe Point!”,
“MultiplePlayers”: “Multiple players found!nRefine your search or use Steam ID.”,
“NothingInSight”: “No players in sight”,
“NoSuchPlayer”: “No such player found ({0})”,
“InvSpyLooting”: “Looting: {0} ({1}).”
}

Permissions

This plugin uses Oxide’s permission system. To assign a permission, use oxide.grant <user or group> <name or steam id> <permission>.

To remove a permission, use oxide.revoke <user or group> <name or steam id> <permission>.

• bettervanish.allowed – allows non-admin players to use vanish and become invisible.
• bettervanish.allowedother – allows non-admin players to vanish other players by their name.
• bettervanish.perma – the bearer will be vanished automatically and won’t be able to turn off vanish himself.
• bettervanish.unvanish – allows non-admin players to unvanish everyone at once.
• bettervanish.invspy – allows non-admin players to use inventory spy to loot players and NPCs remotely.
• bettervanish.skiplocks – allows non-admin players to have access to locked entities (boxes, doors).

Commands

This plugin provides universal chat and console commands. When using a command in the chat, prefix it with a forward slash: /.

• vanish – Toggles vanish state.
• vanish safepoint – Save a Safepoint, where get teleported on disconnect (your current position).
  
• setvanish <PlayerName> – Toggles vanish state of specified player.
• unvanishall – Unvanish everyone at once (both online & sleepers).
• invspy – Let you see and edit players or Npcs inventories, <name/steamID64> or look at the target and use then “invspy “

Plugin Data

This plugin can store 2 data files under oxide/data:

• BetterVanish-SafePoints.json – Player safepoints storage.
• BetterVanish-PersistPlr.json – Players with persisted vanish state.

Developer API

bool _IsInvisible(BasePlayer)

bool _IsInsivible(IPlayer)

void _Disappear(BasePlayer)

void _Reappear(BasePlayer)