Ranks

Exemplo completo de configuração

O sistema de ranks permite criar patentes baseadas em pontos acumulados pelos clans. Aqui está um exemplo:

ranks:
  silver1:
    # Ordem do rank
    order: 0
    # Tag do rank
    display: '&7[>]'
    # Pontos necessários
    points: 0
  silver2:
    order: 1
    display: '&7[>>]'
    points: 10
  silver3:
    order: 2
    display: '&7[>>>]'
    points: 20
  silver4:
    order: 3
    display: '&7[>>>>]'
    points: 40
  silver5:
    order: 4
    display: '&7[(>>>>]'
    points: 80
  silver6:
    order: 5
    display: '&7[(*>>>>]'
    points: 160

Estrutura de um rank

Cada rank deve ter um ID único e as seguintes propriedades:

order

Define a ordem do rank na hierarquia. Quanto menor o número, menor o rank.

Exemplo:

ranks:
  silver1:
    order: 0

O rank com order: 0 será o rank inicial.

display

Tag exibida para representar o rank.

Exemplo:

ranks:
  silver1:
    display: '&7[>]'

Você pode usar códigos de cores (&a, &b, &c, etc.) e até mesmo caracteres especiais Unicode.

points

Quantidade mínima de pontos necessários para atingir este rank.

Exemplo:

ranks:
  silver1:
    points: 0

Criando um sistema de ranks completo

Aqui está um exemplo de sistema de ranks progressivo:

ranks:
  # Ranks de Prata
  silver1:
    order: 0
    display: '&7[Prata I]'
    points: 0
  silver2:
    order: 1
    display: '&7[Prata II]'
    points: 50
  silver3:
    order: 2
    display: '&7[Prata III]'
    points: 100
  
  # Ranks de Ouro
  gold1:
    order: 3
    display: '&6[Ouro I]'
    points: 200
  gold2:
    order: 4
    display: '&6[Ouro II]'
    points: 350
  gold3:
    order: 5
    display: '&6[Ouro III]'
    points: 500
  
  # Ranks de Platina
  platinum1:
    order: 6
    display: '&b[Platina I]'
    points: 750
  platinum2:
    order: 7
    display: '&b[Platina II]'
    points: 1000
  platinum3:
    order: 8
    display: '&b[Platina III]'
    points: 1500
  
  # Ranks de Diamante
  diamond1:
    order: 9
    display: '&3[Diamante I]'
    points: 2000
  diamond2:
    order: 10
    display: '&3[Diamante II]'
    points: 2750
  diamond3:
    order: 11
    display: '&3[Diamante III]'
    points: 3500
  
  # Rank Mestre
  master:
    order: 12
    display: '&5[Mestre]'
    points: 5000
  
  # Rank Lenda
  legend:
    order: 13
    display: '&c&l[LENDA]'
    points: 10000

Usando ranks com PlaceholderAPI

Depois de configurar os ranks, você pode usá-los com PlaceholderAPI:

%yleagues_rank%

Este placeholder retornará a tag (display) do rank atual do clan do jogador.

Usando ranks com nChat

Você também pode exibir o rank no chat usando nChat:

{yleagues_rank}

Boas práticas

Progressão equilibrada

Crie uma progressão de pontos que faça sentido para seu servidor:

ranks:
  bronze:
    order: 0
    display: '&8[Bronze]'
    points: 0          # Rank inicial
  silver:
    order: 1
    display: '&7[Prata]'
    points: 100        # 100 pontos do rank anterior
  gold:
    order: 2
    display: '&6[Ouro]'
    points: 300        # +200 pontos
  platinum:
    order: 3
    display: '&b[Platina]'
    points: 700        # +400 pontos
  diamond:
    order: 4
    display: '&3[Diamante]'
    points: 1500       # +800 pontos
  master:
    order: 5
    display: '&5[Mestre]'
    points: 3000       # +1500 pontos

Nomeação consistente

Use um padrão consistente para os IDs dos ranks:

# ✅ BOM - IDs descritivos e consistentes
ranks:
  bronze1:
    order: 0
  bronze2:
    order: 1
  bronze3:
    order: 2

# ❌ EVITE - IDs inconsistentes
ranks:
  rank1:
    order: 0
  silver:
    order: 1
  ouro_rank:
    order: 2

Distinção visual

Use cores e formatação para diferenciar os níveis:

ranks:
  # Iniciante - Cinza
  beginner:
    order: 0
    display: '&7[Iniciante]'
    points: 0
  
  # Intermediário - Verde
  intermediate:
    order: 1
    display: '&a[Intermediário]'
    points: 500
  
  # Avançado - Azul
  advanced:
    order: 2
    display: '&9[Avançado]'
    points: 1500
  
  # Elite - Roxo
  elite:
    order: 3
    display: '&5[Elite]'
    points: 3000
  
  # Lendário - Vermelho com negrito
  legendary:
    order: 4
    display: '&c&l[LENDÁRIO]'
    points: 10000

Certifique-se de que cada rank tem um valor de order único e sequencial. Pular números na ordem pode causar comportamento inesperado.

Os pontos necessários para cada rank são cumulativos. Por exemplo, se um rank exige 500 pontos, o clan precisa ter pelo menos 500 pontos totais para alcançá-lo.

Nesta página