メインコンテンツまでスキップ

Tab Configuration

Configure TAB features for tablist, scoreboard, bossbar and more

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

フィールド

フィールド型デフォルト説明
headerFooterEnabledBooleantrueEnable header/footer feature in tablist
headerFooterDesignsList<HeaderFooterDesign>—Header/Footer designs (first matching condition wins)
HeaderFooterDesign(3)
フィールド型デフォルト説明
displayConditionString—Condition that must be met to display this design (e.g., '%world%=lobby')プレースホルダー
headerList<String>emptyHeader lines (each line separated by newline in display)プレースホルダー
footerList<String>emptyFooter lines (each line separated by newline in display)プレースホルダー
tablistFormattingEnabledBooleantrueEnable tablist name formatting with prefixes/suffixes
tablistDisableConditionString—Condition to disable tablist formatting (e.g., '%world%=disabled')プレースホルダー
scoreboardTeamsEnabledBooleantrueEnable scoreboard teams for nametags and sorting
enableCollisionBooleantrueEnable player collision
invisibleNametagsBooleanfalseMake nametags invisible
sortingTypesList<String>—Sorting types in priority order (e.g., 'GROUPS:owner,admin,mod,default')
caseSensitiveSortingBooleantrueCase sensitive sorting
canSeeFriendlyInvisiblesBooleanfalseCan see friendly invisibles
scoreboardTeamsDisableConditionString—Condition to disable scoreboard teamsプレースホルダー
playerlistObjectiveEnabledBooleantrueEnable playerlist objective (right side of tablist)
playerlistValueString%ping%Value shown in playerlist objectiveプレースホルダー
playerlistFancyValueString&7Ping: %ping%Fancy value shown on hover (1.20.3+)プレースホルダー
playerlistTitleStringTABTitle for Bedrock Edition
playerlistDisableConditionString—Condition to disable playerlist objectiveプレースホルダー
belownameEnabledBooleanfalseEnable belowname objective (below nametag)
belownameValueString%health%Value shown below nameプレースホルダー
belownameFancyValueString&c%health%Fancy value formatプレースホルダー
belownameFancyValueDefaultStringNPCDefault value for non-players
belownameTitleString&cHealthTitle shown after the valueプレースホルダー
belownameDisableConditionString—Condition to disable belownameプレースホルダー
preventSpectatorEffectBooleanfalsePrevent spectator effect from showing players as ghosts
bossbarEnabledBooleanfalseEnable bossbar feature
bossbarToggleCommandString/bossbarCommand to toggle bossbar visibility
bossbarRememberChoiceBooleanfalseRemember toggle choice between sessions
bossbarHiddenByDefaultBooleanfalseHidden by default (players must toggle on)
bossbarsList<BossBarDefinition>emptyBossbar definitions
BossBarDefinition(5)
フィールド型デフォルト説明
styleBossBarStylePROGRESSBar style: PROGRESS, NOTCHED_6, NOTCHED_10, NOTCHED_12, NOTCHED_20値:PROGRESSNOTCHED_6NOTCHED_10NOTCHED_12NOTCHED_20
colorStringBLUEBar color or animation placeholder (BLUE, GREEN, PINK, PURPLE, RED, WHITE, YELLOW)プレースホルダー
progressString100Progress value (0-100) or placeholderプレースホルダー
textString—Text displayed on the bossbarプレースホルダー
displayConditionString—Display condition (leave empty for always visible)プレースホルダー
scoreboardEnabledBooleanfalseEnable scoreboard feature
scoreboardToggleCommandString/sbCommand to toggle scoreboard visibility
scoreboardRememberChoiceBooleanfalseRemember toggle choice between sessions
scoreboardHiddenByDefaultBooleanfalseHidden by default
scoreboardDelayOnJoinInt0Delay before showing scoreboard on join (milliseconds)
scoreboardsList<ScoreboardDefinition>emptyScoreboard definitions
ScoreboardDefinition(3)
フィールド型デフォルト説明
titleString—Title displayed at the top of the scoreboardプレースホルダー
displayConditionString—Condition that must be met to display this scoreboardプレースホルダー
linesList<String>emptyLines of the scoreboard (top to bottom)プレースホルダー
layoutEnabledBooleanfalseEnable custom tablist layout
layoutDirectionLayoutDirectionCOLUMNSLayout direction: COLUMNS or ROWS値:COLUMNSROWS
layoutDefaultSkinStringdefaultDefault skin for empty slots (references a name from skinCache)
layoutEnableRemainingPlayersTextBooleantrueShow remaining players text
layoutRemainingPlayersTextString... and %s moreText shown for remaining players (%s = count)プレースホルダー
layoutEmptySlotPingInt1000Ping value for empty slots
layoutsList<LayoutDefinition>emptyLayout definitions
LayoutDefinition(5)
フィールド型デフォルト説明
slotCountIntTOTAL_SLOTSLegacy slot count; the TAB screen always renders 80 entries (4 columns x 20 rows)
criteriaList<Ref<ReadableFactEntry>>emptyCriteria for selecting this layout (uses Typewriter facts, e.g., 'fact_name>=10')
fixedSlotsList<String>emptyFixed slots with format 'slot|text' (e.g., '1|&3Website:')
sectionsList<TabSectionDefinition>emptyConditional B4 sections; candidates are evaluated independently per section slot
TabSectionDefinition(4)
フィールド型デフォルト説明
slotTabSectionSlotPROFILESemantic area to replace: PROFILE, PROGRESSION, STATISTICS, ISLAND or ONLINE_PLAYERS値:PROFILEPROGRESSIONSTATISTICSISLANDONLINE_PLAYERS
displayConditionString—Viewer condition; first matching candidate wins, empty means alwaysプレースホルダー
reservedSlotsList<String>emptyOwned slot ranges (e.g., '21-40'); omitted means only explicit fixed slots override
fixedSlotsList<String>emptySlot overrides using 'slot|text'; an empty text clears an owned slotプレースホルダー
groupsMap<String, LayoutGroupDefinition>emptyPlayer groups for dynamic slots
LayoutGroupDefinition(2)
フィールド型デフォルト説明
displayConditionString—Condition to display this group (e.g., 'permission:tab.staff')プレースホルダー
slotsList<String>emptySlot ranges for this group (e.g., '24-40')
skinCacheList<SkinCacheEntry>—Skin cache entries for layout slots (name -> texture/signature)
pingSpoofEnabledBooleanfalseEnable ping spoofing
pingSpoofValueInt0Spoofed ping value
placeholderReplacementsMap<String, Map<String, String>>—Placeholder output replacements (placeholder -> (original -> replacement))
conditionsMap<String, ConditionDefinition>emptyConditional placeholders (use with %condition:name%)
ConditionDefinition(3)
フィールド型デフォルト説明
conditionsList<String>emptyConditions to evaluate (e.g., '%player%=%essentials_nickname%')
trueValueString—Value when all conditions are trueプレースホルダー
falseValueString—Value when any condition is falseプレースホルダー
animationsList<AnimationDefinition>emptyAnimation definitions (use with %animation:name%)
AnimationDefinition(2)
フィールド型デフォルト説明
changeIntervalInt100Time in milliseconds between frame changes
textsList<String>emptyFrames of the animation (cycled through)プレースホルダー
groupsList<GroupDefinition>—Group configurations for prefix/suffix
GroupDefinition(5)
フィールド型デフォルト説明
tabPrefixString—Prefix shown in tablistプレースホルダー
tabSuffixString—Suffix shown in tablistプレースホルダー
tagPrefixString—Prefix shown on nametagプレースホルダー
tagSuffixString—Suffix shown on nametagプレースホルダー
customTabNameString%player%Custom name format in tablistプレースホルダー
usersList<UserDefinition>emptyUser-specific configuration overrides
UserDefinition(5)
フィールド型デフォルト説明
identifierString—Username or UUID of the player
tabPrefixString?—Override tablist prefixプレースホルダー
tabSuffixString?—Override tablist suffixプレースホルダー
tagPrefixString?—Override nametag prefixプレースホルダー
tagSuffixString?—Override nametag suffixプレースホルダー
disableShadowForHeadsBooleantrueDisable 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.