Skip to content

config.yml

config.yml holds what applies to every zone: the default look of a hidden player, how long a run may last, and the extra aliases of the command. A zone overrides the disguise section for itself in zones.yml.

The disguise keys are explained in changing how hidden players look.

aliases: #

- hider
Extra aliases for the /somahider command, on top of the built-in /sh.
persist_identity: true#
Keep the same fake name and skin for a player the whole time a zone is running.
disguise: #
name: #
show: true#
Show a name above the head.
value: random#
random, a pool name, a fixed name, or a %placeholder%.
prefix: &7Hidden #
Before the name. Colors, placeholders and %rel_…% allowed.
suffix: ""#
After the name, same rules.
skin: random#
random, a pool name, a skins.yml entry, a username, or a %placeholder%.
health: #
show: true#
Show the health as hearts.
color: #

- &4
One color = fixed, several = random pick.
show_armor: true#
Show the worn armor.
show_nbts: true#
Show item details (NBT). Tags listed in nbts.yml always stay.
show_fire: true#
Show the flames when on fire.
show_stuck_arrows: true#
Show stuck arrows.
default_max_duration: 2h#
A started zone with no max_duration of its own stops itself after this delay.

Notes on a few keys

Section titled “Notes on a few keys”

default_max_duration is the ceiling applied to a zone that sets no max_duration of its own. Set it to none to remove the ceiling entirely. A value that is not a duration falls back to two hours and logs a warning.

persist_identity keeps a player under the same disguise for as long as they stay connected and the zone keeps running. It is held in memory, so a reconnect gives a new identity.

aliases adds extra names for /somahider, on top of the built-in /sh. Aliases are re-registered on /sh reload.