Placeholders
SomaHider both provides placeholders and reads them. Both need PlaceholderAPI. The expansion registers itself when the plugin enables and PlaceholderAPI is present.
Placeholders SomaHider provides
Section titled “Placeholders SomaHider provides”| Placeholder | Returns |
|---|---|
%somahider_hidden% | true when the player stands in a running zone, false otherwise. |
%somahider_zone% | The name of the zone the player stands in, or an empty string. |
%somahider_zones% | How many zones are running. |
%somahider_active_<id>% | true when the zone with that id is running. |
Use them in a scoreboard or a tab list to tell players that they are currently hidden.
Where SomaHider reads placeholders
Section titled “Where SomaHider reads placeholders”| Setting | Resolved on | Notes |
|---|---|---|
disguise.name.value | The hidden player | The result becomes their false name, cut at 16 characters. |
disguise.skin | The hidden player | The result is looked up as a pool, an entry key or a username. |
disguise.name.prefix | The hidden player, per viewer | Accepts relational placeholders. |
disguise.name.suffix | The hidden player, per viewer | Accepts relational placeholders. |
reveal[].placeholder | Depends on the rule type | See letting some players recognise each other. |
reveal[].equals | Globally | Values written %...% are resolved without a player. |
A placeholder that resolves to nothing falls back to a random entry from the default pool, rather
than showing an empty name or no skin.
Relational placeholders
Section titled “Relational placeholders”A relational placeholder (%rel_...%) is resolved for a pair of players rather than one, so its
result can differ per viewer. SomaHider uses them in two places: the name prefix and suffix, and the
relational reveal rule type.
They let you show the same hidden player differently to each person looking, for instance colouring the prefix by whether the viewer is an ally or an enemy.
Which relational placeholders exist depends on the expansions you have installed, not on SomaHider.