Vanish2.0.5

Vanish allows players with permission to become completely invisible. Players, turrets, helicopters, NPCs, etc. will not be able to see, hear, or touch you!

Note: While vanished, you can hear players but they will be unable to hear you. You are invisible to them and essentially do not exist to them. Even if they walk right through you they DO NOT know of your existence. With the exception of you making sounds such as shooting a gun, they will hear the bullet - hit effect.

Permissions

This plugin uses the 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.

• vanish.allow -- Required to go invisible
• vanish.unlock -- Allows an invisible playe to unlock all locks
• vanish.damage -- Allows an invisible player to damage other entities. Requires "Use OnEntityTakeDamage hook" config option to be set to true.
• vanish.permanent -- Permanently forces a player to be vanished
• vanish.invviewer -- Allows use of /inv command and viewing containers using the interaction feature
• vanish.teleport -- Allows vanished users to teleport using map markers (also needs to be enabled via the config)

Commands

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

• vanish -- Toggle invisibility on/off for self
• inv -- View a players inventory using args steamID or username

Interaction

Being authed on toolcupboards and some client bugs can cause issues when interacting with containers and doors. The interaction feature eliviates this issue and adds some additional funcionality.

**While in vanish a vanished player can use their bound reload key to interact with with various objects including containers, doors, vehicles and players. **This works via ray cast meaning most commonly you will push the R key to interact with the object you are looking at in game.

Interactive Objects:

• Players - Looking at a player and pressing R will view that players inventory
• Doors - Looking at a door and pressing R will toggle it open or closed bypassing all locks in place.
• Containers - This allows all containers to be viewed bypassing all lock and toolcupboard requirments
• Vehicles - Pressing R while looking at a vehicle will mount the vanished player to the closesest mounting position relative to where they are looking bypassing all locks.

Configuration

The settings and options can be configured in the Vanish file under the config directory. The use of an editor and validator is recommended to avoid formatting issues and syntax errors.

{
  "NoClip on Vanish (runs noclip command)": true,
  "Inventory view cmd": [
    "inv",
    "invspy"
  ],
  "Use OnEntityTakeDamage hook (Set to true to enable use of vanish.damage perm. Set to false for better performance)": false,
  "Use CanUseLockedEntity hook (Allows vanished players with the perm vanish.unlock to bypass locks. Set to false for better performance)": true,
  "Automatically vanish players (with the vanish.use perm) on player connect": false,
  "Automatically vanish players (with the vanish.use perm) on player disconnect": false,
  "Keep a vanished player hidden on disconnect": true,
  "Teleport a vanished player under the map on disconnect": false,
  "Teleport a vanished player above the map on connect": true,
  "Bypass violation checks for vanished players": true,
  "Turn off fly hack detection for players in vanish": true,
  "Disable metabolism in vanish": true,
  "Enable teleport to marker when vanished": false,
  "Enable vanishing and reappearing sound effects": true,
  "Make sound effects public": false,
  "Enable chat notifications": true,
  "Sound effect to use when vanishing": "assets/prefabs/npc/patrol helicopter/effects/rocket_fire.prefab",
  "Sound effect to use when reappearing": "assets/prefabs/npc/patrol helicopter/effects/rocket_fire.prefab",
  "Enable GUI": true,
  "Use Native Invis Icon": false,
  "Icon URL (.png or .jpg)": "https://i.ibb.co/3rZzftx/yL9HNRy.png",
  "Icon Sprite": "assets/icons/refresh.png",
  "Image Color": "1 1 1 0.5",
  "Image AnchorMin": "0.175 0.017",
  "Image AnchorMax": "0.22 0.08"
}

Localization

The default messages are in the Vanish file under the lang/en directory. To add support for another language, create a new language folder (e.g. de for German) if not already created, copy the default language file to the new folder and then customize the messages.

For Developers

API

void Disappear(BasePlayer player)
void Reappear(BasePlayer player)
bool IsInvisible(BasePlayer player)

Hooks

void OnVanishReappear(BasePlayer player)
void OnVanishDisappear(BasePlayer player)