usernames.yml

This file holds the names hidden players are shown under, grouped into pools.

usernames:
  default:
    - Cani
    - Gatien
    - Steve
    - Alex
    - Notch

default is the pool used by the keyword random, which is what a fresh install uses. Editing this list is the quickest way to change the names your players see.

Adding your own pool

Every key under usernames is a pool. Add as many as you like:

usernames:
  default:
    - Steve
    - Alex
  medieval:
    - Aldric
    - Bertrand
    - Guenievre

Then point a zone at it by name:

zones:
  tournoi:
    disguise:
      name:
        value: medieval

Run /sh reload to apply.

Rules to keep in mind

Rule	What happens if you break it
A pool cannot be called `random`	The pool is skipped and a warning is logged, because `random` already means the `default` pool.
A pool cannot be named like a placeholder	Same: skipped, with a warning.
A pool must be a list of names	An empty pool, or one that is not a list, is skipped with a warning.
Names are 16 characters at most	Longer names are cut when shown, like any Minecraft name.

Make your pools big enough

SomaHider never hands the same name to two hidden players at once. When it picks one, it skips the names already taken by online players and by other disguises.

Which raises the question of what happens when a pool runs out. SomaHider does not reuse a name and does not fail: it makes one up, eight random letters and digits, something like aX3fZ9qP. It works, but it looks nothing like the names you chose.

So size the pool for your biggest event. If sixty players can be in the zone at once, sixty names in the pool is the minimum, and more is better since online players’ real names are excluded too.