Tab 列表🔗
支持多行。 优化为以异步（Async）模式运行，以避免对主服务器操作产生任何负载。 完全支持 PlaceHolderAPI，用于你希望在 tablist 中使用的任何变量。 并且支持 CMI 占位符。 页脚和页眉分开自定义。 支持在特定间隔自动更新（例如使用时钟时，可以每分钟或更频繁更新），或在特定事件时更新，如玩家登录来更新玩家数量或类似。 提供在列表中定义自定义玩家名称格式的选项。 会从在线玩家数量中排除消失（vanished）的玩家。图片中有示例。 支持不同玩家的自定义格式。例如工作人员可以看到与普通玩家不同的布局，工作人员可以有与普通玩家不同的名称格式。 分组格式的数量没有限制（默认你会得到 2 个）。 如果需要，分组格式（权限）检查可以被禁用，以获得更好的性能。 分组格式用 cmi.tablist.[groupId] 权限节点定义，如 cmi.tablist.1，与其他数字权限节点一样，如果玩家拥有多个，更大的数字将具有优先权。
当设置 tablist 更新时，保持在你的设置占位符需要的最高值。避免设置为低于 5 秒的间隔，甚至设置为 -1 只在特定事件时更新。
要创建一个动画的 tablist，你需要复制这些部分。例如：
Header:
'1':
– '&f————————————'
– '&7Online &f%server_online%&7/&f%server_max_players%'
– '&f————————————'
'2':
– '&7————————————'
– '&7Online &f%server_online%&7/&f%server_max_players%'
– '&7————————————'
'3':
– '&8————————————'
– '&7Online &f%server_online%&7/&f%server_max_players%'
– '&8————————————'
这将在每次 tablist 更新时依次改变 tablist。 同一个 tablist 可以有不同数量的页眉和页脚。
默认配置 (Default config)🔗
# To disable tablist handling visit Modules.yml file
TabList:
# Defines if we want to run tablist updater in async mode
# While enabled it can increase overall performance but some plugins can have same issues handling async placeholder requests
Async: true
UpdateTabListNames: true
# Enable or disable grouped format tablist's
# You can save some resources by disabling this if you are not interested in grouped format tablist feature
# If disabled then this will use only default format and will skip checking for custom one to save some resources if needed
GroupedEnabled: true
Updates:
# automatically updates tab list every x seconds for ALL online players
# If you are using static Footer and Header you can disable this by setting to -1
# Consider setting this to -1 if its completely enough to update on player events
AutoInterval: 60
OnJoin: true
OnLeave: true
afkStateChange: true
OnWorldChange: true
OnDeath: false
OnTeleport: false
OnNickChange: true
# When set to false we will not add header text to tablist
addTabListHeader: true
# When set to false we will not add footer text to tablist
addTabListFooter: true
# PlaceholderAPI supported for any custom variable you want to insert into this
# In addition CMI will handle some placeholders without PlaceHolderAPI
# Full list can be checked ingame with /cmi placeholders
GeneralFormat:
PlayerName: '[playerDisplayName]'
Header:
'1':
- '&f------------------------------------'
- '&7Welcome'
- '&7Online &f%server_online%&7/&f%server_max_players%'
- '&f------------------------------------'
Footer:
'1':
- '&f------------------------------------'
- '&7%player_world% &f%player_x%:&7%player_y%:&f%player_z%'
- '&7Money: &f%vault_eco_balance_formatted% &7Time: &f%server_time_HH:mm:ss%'
- '&f------------------------------------'
useGeneralName: false
# When this set to true, in case you dint defined PlayerName, Header or Footer in GroupFormat, then default one from GeneralFormat will be used
useGeneralHeader: false
useGeneralFooter: false
# Defines custom formats to be used for players.
# Any player which have cmi.tablist.[number] permission node will use defined grouped format in tablist
# Id should be a number and in case player has more than one, bigger number id will be used
# You can have as many groups as you want by increasing increment
GroupFormat:
'1':
PlayerName: '&2{&r[playerDisplayName]&2}'
Header:
'1':
- '&f------------------------------------'
- '&7Online &f%server_online%&7/&f%server_max_players%'
- '&f------------------------------------'
Footer:
'1':
- '&f------------------------------------'
- '&7%player_world% &f%player_x%:&7%player_y%:&f%player_z%'
- '&7Time: &f%server_time_HH:mm:ss%'
- '&f------------------------------------'
'2':
PlayerName: '&c[&r[playerDisplayName]&c]'
Header:
'1':
- '&f------------------------------------'
- '&7Online &f%server_online%&7/&f%server_max_players%'
- '&f------------------------------------'
Footer:
'1':
- '&f------------------------------------'
- '&7Money: &f%vault_eco_balance_formatted% &7Time: &f%server_time_HH:mm:ss%'
- '&f------------------------------------'