Hider

/hide takes a player out of the tab list and swaps their name and skin for an anonymous one, in chat as well as in game, so anyone who runs into them sees a stranger. Everyone else sees a normal quit message when they hide and a join message when they come back, so nothing gives it away.

Commands that name a hidden player are blocked, so /msg or /tpa can't be used to find them. Staff can be allowed to see through it, and you can set up disguise presets with their own names, skins and even ranks.

Permissions#

A preset can require its own permission, set with its permission key.

Commands#

Configuration#

config.yml holds every setting, including your license key and every message.

The disguise#

hide-name: '&e&k12345678&f'
hide-skin: 'Dima_Damage'
hide-skin-url: ''
hide-skin-file: ''

hide-name is the name shown while hidden. The skin comes from hide-skin-url (a skin image link) if set, then hide-skin-file, then the player named in hide-skin.

To use skin files from your own machine, turn on the built-in skin server: set skin-server.enabled: true, public-address to your server's public IP or domain, and put PNG files in plugins/Hider/skins/. The server listens on port (default 25566), so that port must be open.

Hiding behavior#

keep-hide-on-rejoin stores who is hidden in data.yml. With database.type: mysql, it uses MySQL instead, so players stay hidden across a network.

Upside down#

upside-down:
  enabled: true
  permission: 'gangstahide.upsidedown'

When a player with the permission hides, through /hide, the menu toggle or a preset, a menu asks whether they appear Straight or Upside Down. Closing it without picking cancels the hide. Upside down flips their model for everyone else, the same way Minecraft flips players named Dinnerbone, while their skin and hidden name stay as set. Their hidden name floats above them in place of the normal name tag, or UnlimitedNameTags shows it when installed. Players without the permission, auto-hide and keep-hide-on-rejoin always hide straight, and a player who is revealed always comes back straight.

Presets and the menu#

With disguise-gui.enabled: true, /hidegui shows a hide button and a head for each preset under disguises:

disguises:
  ninja:
    type: PLAYER
    display-name: '&aNinja'
    skin: 'Notch'
    disguise-name: '&8Anonymous'
    icon: 'Notch'
    permission: 'gangstahide.disguise.ninja'
    rank: keep

A preset's skin can be skin (a player name), skin-url, skin-file or a raw texture with its signature. Only PLAYER disguises exist.

Ranks while hidden#

With LuckPerms installed, a preset's rank decides the player's rank while hidden:

Real groups are put back when the player unhides or leaves. rank.keep-on-hide shows the player's own prefix on their hidden tab name with plain /hide, and rank.show-prefix-in-tab does the same for a preset's rank.

Install#

1. Install PacketEvents. Hider doesn't load without it.
2. Put the Hider jar in plugins/ and start the server once to create config.yml.
3. Paste your license key into license-key in config.yml. Your key is under My Licenses on the BlazeZ portal; licenses linked to your Discord account show up there automatically. If yours is missing, open a License Key ticket in the BlazeZ Discord.
4. Restart the server and grant gangstahide.use to whoever should hide.
5. After editing config.yml, run /hider reload.

Developer API#

Hider fires Bukkit events from me.blazezstudio.minecraft.event.impl.

getCause() returns a HideCause: COMMAND, MENU, AUTO_HIDE_ON_JOIN, KEEP_HIDE_ON_REJOIN or UNHIDE_ON_JOIN.

@EventHandler
public void onHide(GangstaPlayerPreHideEvent event) {
    if (isInCombat(event.getPlayer())) {
        event.setCancelled(true);
    }
}

Add softdepend: [Hider] to your plugin.yml.