Ranks

Exemplo completo de configuração

O arquivo ranks.yml define todos os ranks disponíveis no servidor e seus requisitos.

ranks:
  pig3:
    # Ordem do rank
    # Registro = padrão 1
    order: 1
    # Tag do rank
    tag: '&d[PorcoIII]'
    # Nome do rank
    name: 'Porco III'
    # Data que o rank será liberado para rankup
    release-date: '01/01/2020-10:00'
    # Preços para upar ao rank
    prices:
      price1:
        provider: 'money'
        price: 10000.0
    # Ações de rankup
    rankup:
      # Comandos que serão executados ao dar rankup
      # Será executado ao registrar (ordem 1)
      command: [ 'give {player} stone 1' ]
      # Mensagens que serão enviadas ao dar rankup
      # Será executado ao registrar (ordem 1)
      messages:
        chat: '&cO jogador &7{player} &cregistrou-se e é agora &7PorcoIII&c.'
        actionbar: '&cO jogador &7{player} &cregistrou-se e é agora &7PorcoIII'
        title: ''
      # Mensagens que serão enviadas AO JOGADOR ao dar rankup
      private-messages:
        chat: ''
        actionbar: ''
        title: ''
        balance: |
          &6&lRANKUP! &fRequisitos para evoluir de rank:
          &r
          &8 * &fCoins: &2$&a{money_has}&7/&a{money_need}
  pig2:
    order: 2
    tag: '&d[PorcoII]'
    name: 'Porco II'
    release-date: '01/01/2020-10:00'
    prices:
      price1:
        provider: 'money'
        price: 20000.0
      price2:
        provider: 'yrankup-head-pig'
        price: 100.0
    rankup:
      command: [ 'give {player} stone 2' ]
      messages:
        chat: '&cO jogador &7{player} &cupou e é agora &7PorcoII&c.'
        actionbar: '&cO jogador &7{player} &cupou e é agora &7PorcoII'
        title: ''
      private-messages:
        balance: |
          &6&lRANKUP! &fRequisitos para evoluir de rank:
          &r
          &8 * &fCoins: &2$&a{money_has}&7/&a{money_need}
          &8 * &fCabeças: &5#&d{yrankup-head-pig_has}&7/&d{yrankup-head-pig_need}

Estrutura de ranks

Configure os ranks disponíveis no servidor.

Opções de configuração

order

Define a ordem do rank na progressão. Ranks com ordem menor são os iniciais.

ranks:
  iniciante:
    order: 1  # Primeiro rank (registro)
  
  novato:
    order: 2  # Segundo rank
  
  experiente:
    order: 3  # Terceiro rank

O rank com order: 1 é o rank inicial dado aos jogadores quando se registram no servidor.

tag

Tag do rank exibida em placeholders e chat.

ranks:
  pig3:
    tag: '&d[PorcoIII]'
  
  pig2:
    tag: '&d[PorcoII]'
  
  pig1:
    tag: '&d[PorcoI]'

name

Nome completo do rank.

ranks:
  pig3:
    name: 'Porco III'
  
  vip:
    name: 'VIP Diamante'

release-date

Data e hora em que o rank será liberado para rankup.

Formato: DD/MM/YYYY-HH:MM

ranks:
  future_rank:
    release-date: '25/12/2025-12:00'  # Será liberado em 25/12/2025 às 12:00
  
  released_rank:
    release-date: '01/01/2020-10:00'  # Já está liberado

Use datas passadas para ranks já liberados. Jogadores não poderão upar para ranks com datas futuras.

prices

Preços necessários para upar para o rank.

ranks:
  pig2:
    prices:
      price1:
        provider: 'money'
        price: 20000.0
      price2:
        provider: 'yrankup-head-pig'
        price: 100.0
      price3:
        provider: 'points'
        price: 500

Opções:

provider: ID da economia (configurada em economies.yml)
price: Quantidade necessária

O jogador precisa ter todas as economias listadas para conseguir upar de rank.

Ações de rankup

Configure o que acontece quando o jogador upa de rank.

command

Comandos executados quando o jogador upa de rank.

ranks:
  pig2:
    rankup:
      command:
        - 'give {player} diamond 5'
        - 'effect {player} speed 60 1'
        - 'lp user {player} permission set minha.permissao'

Placeholders disponíveis: {player}, {rank}, {tag}, {name}, {next_tag}, {next_name}, {prestige}

Os comandos são executados pelo console. Use {player} para se referir ao jogador.

messages

Mensagens públicas (broadcast) enviadas quando o jogador upa de rank.

ranks:
  pig2:
    rankup:
      messages:
        chat: '&cO jogador &7{player} &cupou e é agora &7PorcoII&c.'
        actionbar: '&cO jogador &7{player} &cupou e é agora &7PorcoII'
        title: ''

Tipos:

chat: Mensagem no chat para todos os jogadores
actionbar: Mensagem na actionbar para todos os jogadores
title: Título na tela para todos os jogadores (use <nl> para quebrar linha)

Placeholders disponíveis: {player}, {rank}, {tag}, {name}, {prestige}

private-messages

Mensagens privadas enviadas apenas ao jogador que upou.

ranks:
  pig2:
    rankup:
      private-messages:
        chat: '&aParabéns! Você upou para PorcoII!'
        actionbar: '&aRANKUP! &7Agora você é &dPorcoII'
        title: '&a&lRANKUP!<nl>&7PorcoII'
        balance: |
          &6&lRANKUP! &fRequisitos para evoluir de rank:
          &r
          &8 * &fCoins: &2$&a{money_has}&7/&a{money_need}
          &8 * &fCabeças: &5#&d{yrankup-head-pig_has}&7/&d{yrankup-head-pig_need}

Tipos:

chat: Mensagem no chat do jogador
actionbar: Mensagem na actionbar do jogador
title: Título na tela do jogador (use <nl> para quebrar linha)
balance: Mensagem especial mostrando progresso (use | para múltiplas linhas)

Placeholders especiais para balance:

{provider_has}: Quantia que o jogador possui (ex: {money_has})
{provider_need}: Quantia necessária (ex: {money_need})
Substitua provider pelo ID da economia configurada

Exemplo com múltiplas economias

ranks:
  master:
    order: 10
    tag: '&6[Master]'
    name: 'Master'
    release-date: '01/01/2020-10:00'
    prices:
      price1:
        provider: 'money'
        price: 500000.0
      price2:
        provider: 'yrankup-head-pig'
        price: 1000.0
      price3:
        provider: 'points'
        price: 5000
      price4:
        provider: 'yrankup'
        price: 10000.0
    rankup:
      command:
        - 'give {player} diamond 64'
        - 'effect {player} speed 300 2'
        - 'lp user {player} parent add master'
        - 'broadcast &6{player} alcançou o rank Master!'
      messages:
        chat: |
          &r
          &6&l⚡ ═══════════════════════════ ⚡
          &6&l  {player} ALCANÇOU O RANK MASTER!
          &6&l⚡ ═══════════════════════════ ⚡
          &r
        actionbar: '&6&l⚡ {player} agora é MASTER! ⚡'
        title: '&6&l⚡ MASTER ⚡<nl>&e{player}'
      private-messages:
        chat: '&aParabéns! Você alcançou o rank Master!'
        actionbar: '&6&lPARABÉNS! Você é MASTER!'
        title: '&6&lRANK<nl>&6&lMASTER'
        balance: |
          &6&lRANKUP! &fRequisitos para evoluir de rank:
          &r
          &8 * &fCoins: &2$&a{money_has}&7/&a{money_need}
          &8 * &fCabeças: &5#&d{yrankup-head-pig_has}&7/&d{yrankup-head-pig_need}
          &8 * &fPontos: &b{points_has}&7/&b{points_need}
          &8 * &fFragmentos: &e{yrankup_has}&7/&e{yrankup_need}

Exemplo completo progressivo

ranks:
  # Rank inicial (registro)
  iniciante:
    order: 1
    tag: '&7[Iniciante]'
    name: 'Iniciante'
    release-date: '01/01/2020-10:00'
    prices:
      price1:
        provider: 'money'
        price: 0
    rankup:
      command: []
      messages:
        chat: '&7Jogador &f{player}&7 entrou no servidor!'
        actionbar: ''
        title: ''
      private-messages:
        chat: '&aBem-vindo ao servidor!'
        actionbar: '&aVocê é um Iniciante!'
        title: '&a&lBEM-VINDO!<nl>&7Iniciante'
        balance: ''
  
  # Segundo rank
  novato:
    order: 2
    tag: '&a[Novato]'
    name: 'Novato'
    release-date: '01/01/2020-10:00'
    prices:
      price1:
        provider: 'money'
        price: 10000.0
    rankup:
      command:
        - 'give {player} diamond 1'
      messages:
        chat: '&aO jogador &f{player}&a upou para Novato!'
        actionbar: '&a{player} é agora Novato!'
        title: ''
      private-messages:
        chat: '&aVocê upou para Novato!'
        actionbar: '&a&lRANKUP! &7Novato'
        title: '&a&lRANKUP!<nl>&aNovato'
        balance: |
          &6&lRANKUP! &fRequisitos para evoluir de rank:
          &r
          &8 * &fCoins: &2$&a{money_has}&7/&a{money_need}
  
  # Terceiro rank com heads
  experiente:
    order: 3
    tag: '&e[Experiente]'
    name: 'Experiente'
    release-date: '01/01/2020-10:00'
    prices:
      price1:
        provider: 'money'
        price: 50000.0
      price2:
        provider: 'yrankup-head-pig'
        price: 100.0
    rankup:
      command:
        - 'give {player} diamond 5'
        - 'effect {player} speed 60 1'
      messages:
        chat: '&eO jogador &f{player}&e upou para Experiente!'
        actionbar: '&e{player} é agora Experiente!'
        title: ''
      private-messages:
        chat: '&eVocê upou para Experiente!'
        actionbar: '&e&lRANKUP! &7Experiente'
        title: '&e&lRANKUP!<nl>&eExperiente'
        balance: |
          &6&lRANKUP! &fRequisitos para evoluir de rank:
          &r
          &8 * &fCoins: &2$&a{money_has}&7/&a{money_need}
          &8 * &fCabeças: &5#&d{yrankup-head-pig_has}&7/&d{yrankup-head-pig_need}

Certifique-se de que os IDs das economias usadas em provider existem em economies.yml!

Nesta página