Tab Configuration

Configure TAB features for tablist, scoreboard, bossbar and more

ManifestProvided by TinyEssentials

Main TAB configuration entry. Provides comprehensive tablist, scoreboard, bossbar, and nametag customization.

Fields

Field	Type	Default	Description
headerFooterEnabled	Boolean	true	Enable header/footer feature in tablist
headerFooterDesigns	List<HeaderFooterDesign>	—	Header/Footer designs (first matching condition wins) HeaderFooterDesign (3) Field Type Default Description displayCondition String — Condition that must be met to display this design (e.g., '%world%=lobby')Placeholders header List<String> empty Header lines (each line separated by newline in display)Placeholders footer List<String> empty Footer lines (each line separated by newline in display)Placeholders
tablistFormattingEnabled	Boolean	true	Enable tablist name formatting with prefixes/suffixes
tablistDisableCondition	String	—	Condition to disable tablist formatting (e.g., '%world%=disabled')Placeholders
scoreboardTeamsEnabled	Boolean	true	Enable scoreboard teams for nametags and sorting
enableCollision	Boolean	true	Enable player collision
invisibleNametags	Boolean	false	Make nametags invisible
sortingTypes	List<String>	—	Sorting types in priority order (e.g., 'GROUPS:owner,admin,mod,default')
caseSensitiveSorting	Boolean	true	Case sensitive sorting
canSeeFriendlyInvisibles	Boolean	false	Can see friendly invisibles
scoreboardTeamsDisableCondition	String	—	Condition to disable scoreboard teamsPlaceholders
playerlistObjectiveEnabled	Boolean	true	Enable playerlist objective (right side of tablist)
playerlistValue	String	%ping%	Value shown in playerlist objectivePlaceholders
playerlistFancyValue	String	&7Ping: %ping%	Fancy value shown on hover (1.20.3+)Placeholders
playerlistTitle	String	TAB	Title for Bedrock Edition
playerlistDisableCondition	String	—	Condition to disable playerlist objectivePlaceholders
belownameEnabled	Boolean	false	Enable belowname objective (below nametag)
belownameValue	String	%health%	Value shown below namePlaceholders
belownameFancyValue	String	&c%health%	Fancy value formatPlaceholders
belownameFancyValueDefault	String	NPC	Default value for non-players
belownameTitle	String	&cHealth	Title shown after the valuePlaceholders
belownameDisableCondition	String	—	Condition to disable belownamePlaceholders
preventSpectatorEffect	Boolean	false	Prevent spectator effect from showing players as ghosts
bossbarEnabled	Boolean	false	Enable bossbar feature
bossbarToggleCommand	String	/bossbar	Command to toggle bossbar visibility
bossbarRememberChoice	Boolean	false	Remember toggle choice between sessions
bossbarHiddenByDefault	Boolean	false	Hidden by default (players must toggle on)
bossbars	List<BossBarDefinition>	empty	Bossbar definitions BossBarDefinition (5) Field Type Default Description style BossBarStyle PROGRESS Bar style: PROGRESS, NOTCHED_6, NOTCHED_10, NOTCHED_12, NOTCHED_20Values:PROGRESSNOTCHED_6NOTCHED_10NOTCHED_12NOTCHED_20 color String BLUE Bar color or animation placeholder (BLUE, GREEN, PINK, PURPLE, RED, WHITE, YELLOW)Placeholders progress String 100 Progress value (0-100) or placeholderPlaceholders text String — Text displayed on the bossbarPlaceholders displayCondition String — Display condition (leave empty for always visible)Placeholders
scoreboardEnabled	Boolean	false	Enable scoreboard feature
scoreboardToggleCommand	String	/sb	Command to toggle scoreboard visibility
scoreboardRememberChoice	Boolean	false	Remember toggle choice between sessions
scoreboardHiddenByDefault	Boolean	false	Hidden by default
scoreboardDelayOnJoin	Int	0	Delay before showing scoreboard on join (milliseconds)
scoreboards	List<ScoreboardDefinition>	empty	Scoreboard definitions ScoreboardDefinition (3) Field Type Default Description title String — Title displayed at the top of the scoreboardPlaceholders displayCondition String — Condition that must be met to display this scoreboardPlaceholders lines List<String> empty Lines of the scoreboard (top to bottom)Placeholders
layoutEnabled	Boolean	false	Enable custom tablist layout
layoutDirection	LayoutDirection	COLUMNS	Layout direction: COLUMNS or ROWSValues:COLUMNSROWS
layoutDefaultSkin	String	default	Default skin for empty slots (references a name from skinCache)
layoutEnableRemainingPlayersText	Boolean	true	Show remaining players text
layoutRemainingPlayersText	String	... and %s more	Text shown for remaining players (%s = count)Placeholders
layoutEmptySlotPing	Int	1000	Ping value for empty slots
layouts	List<LayoutDefinition>	empty	Layout definitions LayoutDefinition (5) Field Type Default Description slotCount Int TOTAL_SLOTS Legacy slot count; the TAB screen always renders 80 entries (4 columns x 20 rows) criteria List<Ref<ReadableFactEntry>> empty Criteria for selecting this layout (uses Typewriter facts, e.g., 'fact_name>=10') fixedSlots List<String> empty Fixed slots with format 'slot|text' (e.g., '1|&3Website:') sections List<TabSectionDefinition> empty Conditional B4 sections; candidates are evaluated independently per section slot TabSectionDefinition (4) Field Type Default Description slot TabSectionSlot PROFILE Semantic area to replace: PROFILE, PROGRESSION, STATISTICS, ISLAND or ONLINE_PLAYERSValues:PROFILEPROGRESSIONSTATISTICSISLANDONLINE_PLAYERS displayCondition String — Viewer condition; first matching candidate wins, empty means alwaysPlaceholders reservedSlots List<String> empty Owned slot ranges (e.g., '21-40'); omitted means only explicit fixed slots override fixedSlots List<String> empty Slot overrides using 'slot|text'; an empty text clears an owned slotPlaceholders groups Map<String, LayoutGroupDefinition> empty Player groups for dynamic slots LayoutGroupDefinition (2) Field Type Default Description displayCondition String — Condition to display this group (e.g., 'permission:tab.staff')Placeholders slots List<String> empty Slot ranges for this group (e.g., '24-40')
skinCache	List<SkinCacheEntry>	—	Skin cache entries for layout slots (name -> texture/signature)
pingSpoofEnabled	Boolean	false	Enable ping spoofing
pingSpoofValue	Int	0	Spoofed ping value
placeholderReplacements	Map<String, Map<String, String>>	—	Placeholder output replacements (placeholder -> (original -> replacement))
conditions	Map<String, ConditionDefinition>	empty	Conditional placeholders (use with %condition:name%) ConditionDefinition (3) Field Type Default Description conditions List<String> empty Conditions to evaluate (e.g., '%player%=%essentials_nickname%') trueValue String — Value when all conditions are truePlaceholders falseValue String — Value when any condition is falsePlaceholders
animations	List<AnimationDefinition>	empty	Animation definitions (use with %animation:name%) AnimationDefinition (2) Field Type Default Description changeInterval Int 100 Time in milliseconds between frame changes texts List<String> empty Frames of the animation (cycled through)Placeholders
groups	List<GroupDefinition>	—	Group configurations for prefix/suffix GroupDefinition (5) Field Type Default Description tabPrefix String — Prefix shown in tablistPlaceholders tabSuffix String — Suffix shown in tablistPlaceholders tagPrefix String — Prefix shown on nametagPlaceholders tagSuffix String — Suffix shown on nametagPlaceholders customTabName String %player% Custom name format in tablistPlaceholders
users	List<UserDefinition>	empty	User-specific configuration overrides UserDefinition (5) Field Type Default Description identifier String — Username or UUID of the player tabPrefix String? — Override tablist prefixPlaceholders tabSuffix String? — Override tablist suffixPlaceholders tagPrefix String? — Override nametag prefixPlaceholders tagSuffix String? — Override nametag suffixPlaceholders
disableShadowForHeads	Boolean	true	Disable shadow for heads in layout (improves performance)

How to use it

Each block has an enable switch. Header/footer, tablist formatting, scoreboard teams and the playerlist objective are on by default; belowname, bossbar, scoreboard, layout and ping spoof are off. For headerFooterDesigns, the first design whose displayCondition matches is shown.

Text accepts & colour codes and tab placeholders such as %condition:name% and %animation:name%. Sorting uses permissions named group.<name>. The layout is a table of 80 slots (4 columns by 20 rows). PacketEvents must be installed. Players get toggle commands only if you create them yourself: bossbarToggleCommand and scoreboardToggleCommand are not registered by this version.