Tab Configuration

Configure TAB features for tablist, scoreboard, bossbar and more

清单由 TinyEssentials 提供

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

字段

字段	类型	默认值	描述
headerFooterEnabled	Boolean	true	Enable header/footer feature in tablist
headerFooterDesigns	List<HeaderFooterDesign>	—	Header/Footer designs (first matching condition wins) HeaderFooterDesign（3） 字段 类型 默认值 描述 displayCondition String — Condition that must be met to display this design (e.g., '%world%=lobby')占位符 header List<String> empty Header lines (each line separated by newline in display)占位符 footer List<String> empty Footer lines (each line separated by newline in display)占位符
tablistFormattingEnabled	Boolean	true	Enable tablist name formatting with prefixes/suffixes
tablistDisableCondition	String	—	Condition to disable tablist formatting (e.g., '%world%=disabled')占位符
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 teams占位符
playerlistObjectiveEnabled	Boolean	true	Enable playerlist objective (right side of tablist)
playerlistValue	String	%ping%	Value shown in playerlist objective占位符
playerlistFancyValue	String	&7Ping: %ping%	Fancy value shown on hover (1.20.3+)占位符
playerlistTitle	String	TAB	Title for Bedrock Edition
playerlistDisableCondition	String	—	Condition to disable playerlist objective占位符
belownameEnabled	Boolean	false	Enable belowname objective (below nametag)
belownameValue	String	%health%	Value shown below name占位符
belownameFancyValue	String	&c%health%	Fancy value format占位符
belownameFancyValueDefault	String	NPC	Default value for non-players
belownameTitle	String	&cHealth	Title shown after the value占位符
belownameDisableCondition	String	—	Condition to disable belowname占位符
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） 字段 类型 默认值 描述 style BossBarStyle PROGRESS Bar style: PROGRESS, NOTCHED_6, NOTCHED_10, NOTCHED_12, NOTCHED_20可选值：PROGRESSNOTCHED_6NOTCHED_10NOTCHED_12NOTCHED_20 color String BLUE Bar color or animation placeholder (BLUE, GREEN, PINK, PURPLE, RED, WHITE, YELLOW)占位符 progress String 100 Progress value (0-100) or placeholder占位符 text String — Text displayed on the bossbar占位符 displayCondition String — Display condition (leave empty for always visible)占位符
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） 字段 类型 默认值 描述 title String — Title displayed at the top of the scoreboard占位符 displayCondition String — Condition that must be met to display this scoreboard占位符 lines List<String> empty Lines of the scoreboard (top to bottom)占位符
layoutEnabled	Boolean	false	Enable custom tablist layout
layoutDirection	LayoutDirection	COLUMNS	Layout direction: COLUMNS or ROWS可选值：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)占位符
layoutEmptySlotPing	Int	1000	Ping value for empty slots
layouts	List<LayoutDefinition>	empty	Layout definitions LayoutDefinition（5） 字段 类型 默认值 描述 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） 字段 类型 默认值 描述 slot TabSectionSlot PROFILE Semantic area to replace: PROFILE, PROGRESSION, STATISTICS, ISLAND or ONLINE_PLAYERS可选值：PROFILEPROGRESSIONSTATISTICSISLANDONLINE_PLAYERS displayCondition String — Viewer condition; first matching candidate wins, empty means always占位符 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 slot占位符 groups Map<String, LayoutGroupDefinition> empty Player groups for dynamic slots LayoutGroupDefinition（2） 字段 类型 默认值 描述 displayCondition String — Condition to display this group (e.g., 'permission:tab.staff')占位符 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） 字段 类型 默认值 描述 conditions List<String> empty Conditions to evaluate (e.g., '%player%=%essentials_nickname%') trueValue String — Value when all conditions are true占位符 falseValue String — Value when any condition is false占位符
animations	List<AnimationDefinition>	empty	Animation definitions (use with %animation:name%) AnimationDefinition（2） 字段 类型 默认值 描述 changeInterval Int 100 Time in milliseconds between frame changes texts List<String> empty Frames of the animation (cycled through)占位符
groups	List<GroupDefinition>	—	Group configurations for prefix/suffix GroupDefinition（5） 字段 类型 默认值 描述 tabPrefix String — Prefix shown in tablist占位符 tabSuffix String — Suffix shown in tablist占位符 tagPrefix String — Prefix shown on nametag占位符 tagSuffix String — Suffix shown on nametag占位符 customTabName String %player% Custom name format in tablist占位符
users	List<UserDefinition>	empty	User-specific configuration overrides UserDefinition（5） 字段 类型 默认值 描述 identifier String — Username or UUID of the player tabPrefix String? — Override tablist prefix占位符 tabSuffix String? — Override tablist suffix占位符 tagPrefix String? — Override nametag prefix占位符 tagSuffix String? — Override nametag suffix占位符
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.