Перейти к основному содержимому

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.