Installation

Before you start

You need	Version
Spigot	`1.8.8`
Java	`21`
PacketEvents	`2.12.0` or later

PacketEvents is not optional. SomaHider rewrites packets on their way to the client, which is the whole reason other plugins keep seeing real names, and it needs PacketEvents to do that. Without it the server refuses to enable SomaHider and says so on startup.

PlaceholderAPI is optional, but install it now if either of these is on your list:

teammates should recognise each other inside a zone,
disguise names should come from something in the game, such as a faction name.

Both need placeholders. See letting some players recognise each other.

Install

Put the jar in place.

Drop SomaHider.jar into your server’s plugins/ folder, next to PacketEvents.
Start the server once.

SomaHider creates its configuration files in plugins/SomaHider/. There is nothing to fill in before this first start: the shipped defaults already work.
Check that it loaded.
```
/sh list
```
On a fresh install it answers that there are no zones. That is the answer you want: it means the plugin enabled and the command is registered.

If /sh list says the command is unknown, SomaHider did not enable. The reason is in the server log, and nine times out of ten it is a missing PacketEvents.

The files it created

You will not touch most of them on day one. This is what each is for, so you know where to go later.

File	Open it when you want to
`zones.yml`	Define where your zones are and when they run. This is the one you will use most.
`config.yml`	Change the default look of a hidden player, or the time limit on a zone.
`usernames.yml`	Change the pool of false names.
`skins.yml`	Change the pool of skins.
`chat.yml`	Stop your server messages from printing real names.
`nbts.yml`	Keep certain item tags visible when item details are hidden.

There is also a bypass.yml. SomaHider writes it itself to remember which staff members turned /sh bypass on, so leave it alone.

After editing any of these, apply the changes with:

/sh reload