Scoreboard

The tree merges with vanilla `/scoreboard`#

NeoEssentials registers the same scoreboard literal, and Brigadier adds child nodes to the vanilla command instead of replacing it. Vanilla objectives / players / teams remain. No name collisions: vanilla has players (plural), here it is player; vanilla enable lives under players, here it is at the root. Bare /scoreboard with no arguments runs the NeoEssentials .executes and prints the mod's help, not vanilla's.

What to do: Vanilla objectives work as before: /scoreboard objectives add …. The mod's help is bare /scoreboard. To remove the mod's command entirely, disable commands.scoreboard in config.json and restart — the vanilla tree remains.

Which board a player sees#

Boards are sorted by descending priority. For each viewer the first board whose conditions lines are all true (implicit AND) is used. An empty condition list always passes — such a board must have the lowest priority, otherwise it overrides the rest. If no board matches, the sidebar is hidden for that player. There is no separate OR — two adjacent priorities with different conditions give the same effect.

What to do: Keep the fallback board last with priority: 0 and conditions: []. Check which board you currently see with /scoreboard preview in the right world and with the right permissions.

`conditions` grammar and the short `{balance}` in a condition#

Parsed in ConditionEvaluator, in order: perm:<node> (PermissionAPI), world:<path> (dimension path, no namespace), {placeholder} == value / != value (case-insensitive comparison); otherwise the string is run through PlaceholderAPI and is true if the result is non-empty and not false.

Conditions do not go through the sidebar's shorthand replacements. In board lines {balance}, {online}, {player} are substituted by ScoreboardManager itself. In a condition, PlaceholderAPI looks for the identifier balance and does not find it (the default expansion is {neoessentials_balance}). An unresolved token stays as the text {balance}: an == comparison fails, and a lone unresolved {token} as a boolean is true because the string is non-empty.

What to do: Check world and permissions with the world: / perm: forms. For placeholders in a condition write {neoessentials_balance}, {neoessentials_group}, {neoessentials_world} and so on. Do not use a lone unknown {token} as a condition — it silently passes.

`lineOverrides` target the array index; hidden lines collapse#

A line can have its own condition. Lines that fail are dropped, and the rest shift up into slots 0…14 — there is no blank gap. An override (lineOverrides in the file or /scoreboard group|player … line) changes only the text and does not cancel the original line's condition: a hidden line stays hidden. The override key is the 0-based index in the selected board's lines array, not the visible slot number after collapsing.

What to do: Count indices by the JSON array, including lines with conditions. If line 2 is hidden by a condition, lineOverrides["2"] still refers to it, not to what the player sees third.

Override precedence and what is lost on reload#

Text chain: player (UUID) → group (PermissionAPI primary) → board value. /scoreboard set title|line edits the board itself in memory (for title, the whole frame list is replaced with one frame). /scoreboard player / group write override maps in memory. loadConfig() on reload fully re-reads boards/groups/players from the file and clears these maps — temporary edits are lost. enable/disable are also memory-only: reload restores scoreboard.enabled from the file.

What to do: Permanent changes go only in scoreboard.json. The dashboard save (saveConfig) can flush the current memory to disk; the commands never write the file themselves.

`{online}` and `{displayname}` on the sidebar#

{online} is server.getPlayerList().getPlayers().size(), without a vanish filter (unlike the tablist). {displayname} is substituted as player.getName(), i.e. the real IGN, not /nick. {max} — server slots. {time} — HH:mm of the system clock, not the world's in-game time.

What to do: Vanished players are still counted in {online}. For a nickname in a line use the PlaceholderAPI nickname placeholder if one is registered, not {displayname}.

Two independent switches#

modules.scoreboardEnabled: false in config.json (restart): the tick/join/quit handler exits immediately, no packets are sent, /scoreboard is not registered.

commands.scoreboard: false (restart): the command is not registered, but the sidebar tick runs as before — the panel stays, you just cannot reload it from the game.

scoreboard.enabled: false + /scoreboard reload (or /scoreboard disable): a live switch-off, the command stays, hideAll is called for everyone (SIDEBAR slot, line teams ne_sb*, objective ne_sidebar).

What to do: To remove the system entirely — modules.scoreboardEnabled. To temporarily hide the panel while keeping the command — enabled in scoreboard.json or /scoreboard disable.

Join delay and anti-flicker#

joinDelayTicks is counted in server ticks (globalTick), not refresh cycles. Until the delay expires, updatePlayer calls hidePlayer. Packets are sent only if the title or the set of visible lines changed since the last send to that viewer. The slot score is fixed (15 − index) with BlankFormat so the client does not reorder lines by number.

What to do: If the panel "flashes" on join, increase joinDelayTicks (shipped 40). If a line does not update, the placeholder most likely returned the same value: the dirty check stays silent on purpose.

Command permissions#

Bare /scoreboard checks no nodes. toggle requires a player and neoessentials.scoreboard.toggle. Admin branches: p == null || neoessentials.scoreboard.admin. Plus the common opsBypassPermissions and PermissionAPI's vanilla OP fallback.

What to do: If /scoreboard "does not exist" even for an operator, check modules.scoreboardEnabled and commands.scoreboard, not permissions. If help works but reload is missing from completion, you lack neoessentials.scoreboard.admin.