# Detailed explanation of all options available at https://github.com/NEZNAMY/TAB/wiki/config.yml

#changing nametags, affecting sorting, collision rule
change-nametag-prefix-suffix: true

#prefix/suffix in tablist
change-tablist-prefix-suffix: true

#header/footer
enable-header-footer: true

header:
  - "&6&lflakame.se"
  - ""
  - "&2&lTEST SERVER"
  - ""
  - "%animation:MyAnimation1%"
footer:
  - "%animation:MyAnimation1%"

#supports any numeric placeholder, set to "" to disable the feature
yellow-number-in-tablist: "%ping%"

group-sorting-priority-list:
  - owner
  - admin
  - mod
  - helper
  - builder
  - premium
  - player
  - default

Groups:
  Owner:
    tabprefix: "&0&l[&a&lOwner&0&l] &a"
    tagprefix: "&2&lOwner &a"
  Admin:
    tabprefix: "&0&l[&4&lAdmin&0&l] &1"
    tagprefix: "%animation:admin_prefix%"
  Player:
    tabprefix: "&0&l[&7&lPlayer&0&l] &3"
    tagprefix: "&2&lPlayer &3"
  example_group:
    header:
      - "This is an example of per-group header/footer"
    footer:
      - "applied to a group"

  #default settings for all groups, all groups will take properties from this section unless player's primary group overrides a specific setting
  _OTHER_:
    tabprefix: "%vault-prefix%"
    tagprefix: "%vault-prefix%"
    tabsuffix: "%afk%"
    tagsuffix: "%afk%"
    customtabname: "%essentialsnick%"
    customtagname: "%essentialsnick%"

Users:
  _NEZNAMY_:
    tabprefix: "&6&lTAB Author &a"
    tagprefix: "&6&lTAB &r&a"
    abovename: "&bOh look, 3 lines of text !"
    belowname: "&eThere's only one plugin out there supporting it"
  Aca_:
    tabprefix: "&6&lOwner&r "
    tagprefix: "&6&lOwner&r "

#additional very limited line of text below nametag
#don't forget this enables on all player entities, which includes NPCs
#tags so you can find this section using the mighty ctrl + f feature: [NPC, Citizens, below_name, health]
classic-vanilla-belowname:

  #enabling the feature
  enabled: false

  #number or numeric placeholder, supports per-player placeholders
  number: "%health%"

  #text after number, must be same on all players
  text: "Health"

#controlling the collision rule
enable-collision: true

#using the opposite of the setting above for worlds
revert-collision-rule-in-worlds:
  - revertedworld

#preventing players with spectator gamemode from being moved to the bottom of tablist with transparent name
do-not-move-spectators: false

#allows players with tab.spectatorbypass permission to see spectators moved despite the option above enabled
allow-spectator-bypass-permission: false

#using armor stands for nametags, bypassing all limits (they are not on server sided & asynchronous - no TPS loss)
unlimited-nametag-prefix-suffix-mode:

  #enabling the feature
  enabled: false

  #using a feature introduced in 1.8.1 to make hitbox zero so you can't cry it affects pvp despite hit redirection
  #1.8.0 clients will see wild things
  #automatically enabled for 1.9+
  use-marker-tag-for-1-8-x-clients: false

  #disabling the feature for players riding boats to prevent massive desync
  disable-on-boats: true

  #in blocks
  space-between-lines: 0.22

per-world-settings:
  world1:
    header:
      - "an example of world with custom"
    footer:
      - "header/footer and prefix/suffix"
    Groups:
      Owner:
        tabprefix: "&0&l[&a&lOwner&0&l] &a"
        tagprefix: "&2&lOwner &a"

  #separating multiple worlds with "-"
  world2-world3:
    header:
      - "This is a shared header for"
      - "world2 and world3"

placeholders:
  #output of %afk%
  afk-yes: " &4*&4&lAFK&4*&r"
  afk-no: ""

  #%date%
  date-format: "dd.MM.yyyy"

  #%time%
  time-format: "[HH:mm:ss / h:mm a]"

  #in hours, in case of wrong timezone
  time-offset: 0

  #don't forget color codes
  remove-strings:
    - "[]"
    - "< >"

#aliases for %rank%, this is not the place where group prefix is defined!
rank-aliases:
  Admin: "&4&lADMIN"
  Mod: "&b&lMOD"
  Premium: "&6&lPREMIUM"
  Ultra: "&b&lULTRA"
  Legend: "&a&lLEGEND"
  Titan: "&c&lTITAN"
  Youtuber: "&c&lYOUTUBE"
  _OTHER_: "&7No Rank"

disable-features-in-worlds:
  header-footer:
    - disabledworld
  tablist-names:
    - disabledworld
  nametag:
    - disabledworld
  yellow-number:
    - disabledworld
  bossbar:
    - disabledworld
  belowname:
    - disabledworld
  unlimited-nametags:
    - disabledworld

placeholderapi-refresh-intervals:
  default-refresh-interval: 100
  server:
    "%server_uptime%": 1000
    "%server_tps_1_colored%": 1000
  player:
    "%player_health%": 200
    "%player_ping%": 1000
    "%vault_prefix%": 1000
  relational:
    "%rel_factionsuuid_relation_color%": 500

#different playerlist in different worlds
per-world-playerlist:

  #to enable the feature
  enabled: false

  #allows players with tab.bypass permission to see everyone in tablist despite this option enabled
  allow-bypass-permission: false

  #players in these worlds will see everyone despite the feature enabled
  ignore-effect-in-worlds:
    - ignoredworld
    - build

  #groups of worlds to share playerlist
  shared-playerlist-world-groups:
    #group name, can be anything
    lobby:
      - lobby1
      - lobby2
    minigames:
      - paintball
      - bedwars

#permission node is tab.sort.<permission group from sorting list>
sort-players-by-permissions: false

#making tamed animals no longer copy nametag properties from their owner (prefix/suffix/visibility)
fix-pet-names: false

#taking primary group from permission plugin
use-primary-group: true

#if the option above is false, all groups are taken from permission plugin and the one higher in this list is used as primary
primary-group-finding-list:
  - Owner
  - Admin
  - Helper
  - default

#if none of the above fits your needs, you can enable this to give groups using tab.group.<group name from the list above> permission
assign-groups-by-permissions: false

#preventing other plugins from overriding TAB
anti-override:
  scoreboard-teams: true
  scoreboard-objectives: true
  tablist-names: true
  usernames: true

#permanently invisible nametags
invisible-nametags: false

#faking ping of players
ping-spoof:
  enabled: false
  value: 0