Scoreboard

Visão Geral

Configure uma scoreboard personalizada que exibe informações diferentes para jogadores com e sem faction. O sistema atualiza automaticamente e suporta placeholders.

Configuração Principal

# Ativar ou desativar o sistema de scoreboard
enabled: true

# Delay para atualizar a scoreboard (em segundos)
delay: 3

enabled

Tipo: Boolean
Padrão: true
Descrição: Ativa/desativa a scoreboard do plugin
Valores: true (ativo) | false (desativo)

delay

Tipo: Integer
Padrão: 3
Descrição: Intervalo de atualização em segundos
Mínimo: 1 segundo
Recomendado: 2-5 segundos

Performance

Valores muito baixos (1 segundo) podem causar lag em servidores com muitos jogadores. Recomenda-se 3-5 segundos.

Scoreboard - Sem Faction

Exibida para jogadores que não pertencem a nenhuma faction:

no-faction:
  title: '&b&lyStore'
  lines:
    - ''
    - '&f Zona: &7{zone}'
    - '&f Poder: &a{current_power}/{max_power}'
    - ''
    - '&c Você não possui uma facção'
    - ''
    - ' &fCoins: &2$&a%yeconomy_money%'
    - ''
    - '&eystoreplugins.com.br'

Elementos Configuráveis

title

Tipo: String
Descrição: Título da scoreboard
Suporta: Códigos de cor (&a, &b, &l, etc.)
Exemplo: &b&lyStore

lines

Tipo: Lista de Strings
Descrição: Linhas da scoreboard (máximo 15)
Suporta:
- Códigos de cor
- Placeholders do yFactions
- Placeholders do PlaceholderAPI
- Linhas vazias para espaçamento

Placeholders Disponíveis (Sem Faction)

Placeholder	Descrição	Exemplo
`{zone}`	Nome da zona atual	Selva, Reivindicada, Território
`{current_power}`	Poder atual do jogador	10
`{max_power}`	Poder máximo do jogador	20

Scoreboard - Com Faction

Exibida para jogadores que pertencem a uma faction:

with-faction:
  title: '&b&lyStore'
  lines:
    - ''
    - '&f Zona: &7{zone}'
    - '&f Poder: &a{current_power}/{max_power}'
    - ''
    - '&f {faction_attack}{faction_colortag} &7- {faction_name}'
    - '&f   Online: &a{faction_members_online}/{faction_members_total}'
    - '&f   Poder: &a{faction_current_power}/{faction_max_power}'
    - '&f   Terras: &a{faction_claims}/{faction_max_claims}'
    - ''
    - ' &fCoins: &2$&a%yeconomy_money%'
    - ''
    - '&eystoreplugins.com.br'

Elementos Configuráveis

title

Tipo: String
Descrição: Título da scoreboard
Mesmo formato: da scoreboard sem faction

lines

Tipo: Lista de Strings
Descrição: Linhas com informações da faction
Máximo: 15 linhas

Placeholders Disponíveis (Com Faction)

Informações Pessoais

Placeholder	Descrição	Exemplo
`{zone}`	Zona atual	Território, Selva
`{current_power}`	Poder do jogador	15
`{max_power}`	Poder máximo do jogador	20

Informações da Faction

Placeholder	Descrição	Exemplo
`{faction_attack}`	Indicador de ataque/defesa	⚔, 🛡
`{faction_colortag}`	Tag com cor personalizada	`&4[ABC]`
`{faction_name}`	Nome completo da faction	Avengers
`{faction_members_online}`	Membros online agora	5
`{faction_members_total}`	Total de membros	20
`{faction_current_power}`	Poder total da faction	250
`{faction_max_power}`	Poder máximo da faction	400
`{faction_claims}`	Territórios clamados	12
`{faction_max_claims}`	Máximo de territórios	25

Integração com PlaceholderAPI

O sistema suporta todos os placeholders do PlaceholderAPI:

Exemplos Comuns

lines:
  - '&f Economia: &a%vault_eco_balance_formatted%'
  - '&f Rank: &e%luckperms_prefix%'
  - '&f Jogadores: &b%server_online%/%server_max_online%'
  - '&f TPS: &a%server_tps_1%'
  - '&f Ping: &e%player_ping%ms'

Placeholders yEconomy

lines:
  - '&f Coins: &2$&a%yeconomy_money%'
  - '&f Cash: &5$&d%yeconomy_cash%'

Exemplos de Configuração

Scoreboard Minimalista

no-faction:
  title: '&6&lMEU SERVIDOR'
  lines:
    - ''
    - '&fPoder: &a{current_power}/{max_power}'
    - '&fZona: &7{zone}'
    - ''
    - '&cSem faction'
    - ''

with-faction:
  title: '&6&lMEU SERVIDOR'
  lines:
    - ''
    - '&fPoder: &a{current_power}/{max_power}'
    - ''
    - '&fFaction: {faction_colortag}'
    - '&f  Online: &a{faction_members_online}'
    - '&f  Terras: &a{faction_claims}'
    - ''

Scoreboard Completa

no-faction:
  title: '&b&lFACTIONS'
  lines:
    - ''
    - '&7▪ &fJogador:'
    - '&f  Poder: &a{current_power}/{max_power}'
    - '&f  Zona: &7{zone}'
    - ''
    - '&7▪ &fStatus:'
    - '&c  Sem faction'
    - ''
    - '&7▪ &fEconomia:'
    - '&f  Coins: &2$&a%yeconomy_money%'
    - '&f  Cash: &5$&d%yeconomy_cash%'
    - ''
    - '&eplay.servidor.com'

with-faction:
  title: '&b&lFACTIONS'
  lines:
    - ''
    - '&7▪ &fJogador:'
    - '&f  Poder: &a{current_power}/{max_power}'
    - '&f  Zona: &7{zone}'
    - ''
    - '&7▪ &fFaction:'
    - '&f  {faction_attack}{faction_colortag} &7- {faction_name}'
    - '&f  Online: &a{faction_members_online}/{faction_members_total}'
    - '&f  Poder: &a{faction_current_power}/{faction_max_power}'
    - '&f  Terras: &a{faction_claims}/{faction_max_claims}'
    - ''
    - '&7▪ &fEconomia:'
    - '&f  Coins: &2$&a%yeconomy_money%'
    - ''
    - '&eplay.servidor.com'

Scoreboard com Rank e Estatísticas

with-faction:
  title: '&6&lRPG &7&lFactions'
  lines:
    - ''
    - '&fRank: %luckperms_prefix%'
    - ''
    - '&f{faction_colortag} &7- {faction_name}'
    - '&f Membros: &a{faction_members_online}/{faction_members_total}'
    - '&f Poder: &a{faction_current_power}/{faction_max_power}'
    - '&f Terras: &a{faction_claims}/{faction_max_claims}'
    - ''
    - '&fKills: &a%statistic_player_kills%'
    - '&fMortes: &c%statistic_deaths%'
    - '&fKDR: &e%statistic_player_kills%/%statistic_deaths%'
    - ''
    - '&fCoins: &2$&a%yeconomy_money%'
    - ''

Variáveis Especiais

`{zone}`

Exibe o tipo de território onde o jogador está:

Zona	Descrição	Quando Aparece
`Selva`	Território livre	Não reivindicado
`Reivindicada`	Território próprio	Sua faction
`Território`	Território de outra faction	Faction inimiga/aliada
`Zona de Guerra`	Área de combate	Warzone configurada
`Zona Segura`	Área protegida	Safezone configurada

`{faction_attack}`

Indicador visual de estado da faction:

Símbolo	Significado	Quando Aparece
`⚔`	Em ataque	DTR < máximo
`🛡`	Defendendo	DTR em recuperação
`✔`	Estável	DTR no máximo

Customização

O símbolo {faction_attack} pode ser customizado no arquivo de mensagens.

Códigos de Cor

Cores Básicas

&0 - Preto
&1 - Azul escuro
&2 - Verde escuro
&3 - Ciano escuro
&4 - Vermelho escuro
&5 - Roxo
&6 - Dourado
&7 - Cinza
&8 - Cinza escuro
&9 - Azul
&a - Verde
&b - Ciano
&c - Vermelho
&d - Rosa
&e - Amarelo
&f - Branco

Formatação

&l - Negrito
&m - Riscado
&n - Sublinhado
&o - Itálico
&k - Aleatório
&r - Resetar formatação

Dicas de Design

Espaçamento

Use linhas vazias ('') para organizar informações:

lines:
  - ''  # Espaço superior
  - '&fInformações'
  - ''  # Separador
  - '&fDados'
  - ''  # Espaço inferior

Alinhamento

Use espaços para alinhar texto:

lines:
  - '&f Poder:  &a{current_power}'  # Dois espaços
  - '&f Terras: &a{faction_claims}' # Um espaço

Hierarquia Visual

lines:
  - '&7▪ &fTítulo Seção'      # Marcador + título
  - '&f  Informação 1'         # Indentado
  - '&f  Informação 2'         # Indentado
  - ''                         # Separador
  - '&7▪ &fOutra Seção'

Cores Semânticas

lines:
  - '&a+12 &7(positivo)'       # Verde para positivo
  - '&c-5 &7(negativo)'        # Vermelho para negativo
  - '&e! &7(aviso)'            # Amarelo para avisos
  - '&b? &7(informação)'       # Ciano para info

Limitações Técnicas

Máximo de linhas: 15 linhas por scoreboard
Máximo de caracteres: 40-48 por linha (depende da versão)
Atualização mínima: 1 segundo (recomendado 3+)
Cores por linha: Sem limite, mas afeta tamanho

Caracteres Especiais

Símbolos Unicode (⚔, 🛡, ★) podem não aparecer corretamente em alguns clientes. Teste antes de usar em produção.

Troubleshooting

Scoreboard não aparece

Verifique se enabled: true
Confirme que não há outro plugin de scoreboard conflitando
Reinicie o servidor após mudanças

Placeholders não funcionam

Instale PlaceholderAPI
Baixe as expansões necessárias: /papi ecloud download <nome>
Use o formato correto: %plugin_placeholder%

Informações desatualizadas

Aumente o delay se estiver muito baixo
Verifique se há erros no console
Confirme que os placeholders estão corretos

Linhas cortadas

Reduza o tamanho do texto
Use abreviações (Mbrs ao invés de Membros)
Remova espaços desnecessários

Performance

Otimização

# Configuração otimizada para servidores grandes
enabled: true
delay: 5  # Aumentar delay reduz processamento

# Usar menos placeholders complexos
lines:
  - ''
  - '&fPoder: &a{current_power}'
  - '&fFaction: {faction_colortag}'
  - '&fOnline: &a{faction_members_online}'
  - ''

Monitoramento

Use /timings do Paper/Spigot
Verifique consumo de CPU do plugin
Monitore delay de tick do servidor

Próximo: Messages - Sistema de mensagens personalizadas

Nesta página