Player Settings

Per-player preferences stored in the database. Players open and toggle their options using /settings.

Opening Player Settings

/settings
# Aliases:
/preferences
/prefs

This command opens a GUI menu where players can click to toggle settings. Changes apply immediately and are persisted in the database.

Toggleable Settings Reference

The options below are configured per player profile:

Setting Key	Default Value	Functional Behavior
`AUTO_GG`	ON	Sends an automated "GG" message after a match concludes. Chooses from options inside `messages.yml`.
`DEATH_MESSAGES`	ON	Toggles whether death notifications are visible to the player during active duels.
`KILLSTREAK_MESSAGES`	ON	Toggles whether consecutive kill streak milestones display in chat.
`MATCH_START_SOUNDS`	ON	Toggles countdown and combat start sound effects.
`DUEL_REQUESTS`	ON	Configures whether the player is open to receives challenges from others. If toggled off, challengers receive a notification.
`PARTY_INVITES`	ON	Toggles whether the player is receptive to party invites.
`FRIEND_REQUESTS`	ON	Toggles whether other players can add them to their friends list.
`SCOREBOARD`	ON	Shows or hides the sidebar match/lobby scoreboard.
`TAB_LIST`	ON	Shows or hides the custom headers and footers in the player list.
`NAMETAGS`	ON	Enables or disables custom formatting tags displayed above heads.
`ACTION_BAR`	ON	Toggles queue status and waiting duration messages on the action bar.
`SHARE_KITS`	OFF	Makes your edited kits public and importable by others via their share codes. See Kit Sharing & Profiles.
`ITEM_PICKUP`	ON	Toggles whether players can pick up items while in lobby (match pickup is handled separately by kit settings).
`COUNTRY_FLAG_VISIBLE`	ON	Toggles whether your selected country flag head is shown in tab/nametag integrations.
`MATCH_CHAT`	Configured by `match-chat.default-enabled`	Controls whether the player sends and receives global chat while in a duel or FFA match. When disabled, their match chat is limited to relevant match participants and spectators.
`SHULKER_LORE`	Configured by `shulker-lore.default-enabled` (default ON)	Controls shulker-box sprite lore preview visibility (packet-based, 1.21.9+ only, hidden for Bedrock players). Toggle with `/settings` or `/shulkerlore`.

Custom Toggles

Admins can define additional per-player toggles in menus/player-settings.yml under custom-toggles. Each entry becomes a standalone /<key> [on|off] command (e.g. /fastcrystal <on|off> if configured) and a toggle button in /settings. Each toggle has its own permission, icons (enabled-material/disabled-material), and optional on/off commands executed via GuiCommandExecutor. Requires custom-toggles.enabled: true.

Personal Time Overrides

Players can configure a custom time layout. This changes daylight visibility only for their client view:

Setting Option	Visual Effect
`DEFAULT`	Syncs with server time.
`DAY`	Forces local daylight (Daytime).
`NIGHT`	Forces local nighttime.

Personal Weather Overrides

Same concept as time overrides, allowing players to customize weather visual cues:

Setting Option	Visual Effect
`DEFAULT`	Syncs with active server weather.
`CLEAR`	Forces clear weather locally.
`RAIN`	Forces raining weather locally.
`STORM`	Forces thunderstorms locally.

Lobby Tab List View

Determines what is rendered in the tab list panel when the player is inside the lobby:

Setting Option	Tab View Rendered
`LOBBY`	Standard lobby layout (player stats, server name, etc.).
`FRIENDS`	Lists online friends and online status indexes.