Classes

Exemplo completo de configuração

As classes são evoluções que o jogador pode adquirir para obter bônus permanentes de mineração. Aqui está um exemplo:

classes:
  class1:
    # Ordem da classe (0 = primeira classe)
    order: 0
    # Nome de exibição da classe
    display: '&fQuartzo'
    # Cor da armadura
    # Formato: RED:GREEN:BLUE (255:255:255)
    # Deixe RAINBOW para ser colorido
    color: '255:255:255'
    # Permissão para evoluir à esta classe
    # Deixe '' (vazio) para não usar
    permission: ''
    # Efeitos de poção (Efeito:Nível)
    effects: ['SPEED:1']
    # Nível necessário para upar para essa classe
    need-level: 0
    # Bônus que serão dados
    bonus:
      blocks: 5
      coin: 10
    # Custos de evolução
    prices:
      price1:
        provider: 'money'
        price: 1000.0
      price2:
        provider: 'money'
        price: 1000.0
    # Itens da armadura
    armor:
      helmet:
        material: LEATHER_HELMET
        name: '&fClasse Quartzo'
        lore:
          - ''
          - ' &7As classes irão te dar mais'
          - ' &7chance e coins ao minerar!'
          - ''
          - '&fBônus adquiridos:'
          - '&7- +{blocks}% de blocos'
          - '&7- +{coin}% de coins'
          - ''
      chestplate:
        material: LEATHER_CHESTPLATE
        name: '&fClasse Quartzo'
        lore: [...]
      leggings:
        material: LEATHER_LEGGINGS
        name: '&fClasse Quartzo'
        lore: [...]
      boots:
        material: LEATHER_BOOTS
        name: '&fClasse Quartzo'
        lore: [...]
    # Itens do menu de classes
    menu:
      buy:
        material: LEATHER_CHESTPLATE
        color: '255:255:255'
        name: '&fClasse Quartzo'
        lore:
          - ''
          - '&fCusto para evoluir:'
          - '&7- &2$&f{money} coins'
          - ''
          - '&aClique para evoluir'
      has:
        # Item quando o jogador tem a classe mas não está equipada
        lore:
          - '&aClique para equipar.'
      equipped:
        # Item quando a classe está equipada
        lore:
          - '&aVocê está usando este.'
      need:
        # Item quando o jogador não tem os recursos
        lore:
          - '&cVocê não possui os custos para evoluir.'
      previous:
        # Item quando o jogador não tem a classe anterior
        lore:
          - '&cVocê não possui a classe anterior.'

Opções de configuração

order

Define a ordem de progressão das classes. A classe com order: 0 é a primeira, depois order: 1, etc.

classes:
  class1:
    order: 0 # Primeira classe
  class2:
    order: 1 # Segunda classe
  class3:
    order: 2 # Terceira classe

O jogador precisa ter a classe anterior para evoluir para a próxima!

display

Nome de exibição da classe usado nas mensagens.

classes:
  class1:
    display: '&fQuartzo'

color

Cor da armadura de couro no formato RGB (0-255).

classes:
  class1:
    color: '255:255:255' # Branco

Valores especiais:

RAINBOW - Armadura com efeito arco-íris animado

Exemplos de cores:

255:255:255 - Branco
255:0:0 - Vermelho
0:255:0 - Verde
0:0:255 - Azul
255:255:0 - Amarelo
255:0:255 - Magenta

permission

Permissão necessária para evoluir para esta classe. Deixe vazio '' para não exigir permissão.

classes:
  class1:
    permission: '' # Sem permissão
  class-vip:
    permission: 'mina.class.vip' # Requer permissão

effects

Lista de efeitos de poção permanentes que o jogador receberá ao usar a classe.

classes:
  class1:
    effects: ['SPEED:1', 'HASTE:2']

need-level

Nível necessário para upar para essa classe

classes:
  class1:
    need-level: 0

Formato: EFEITO:NÍVEL

Efeitos comuns:

SPEED - Velocidade
HASTE - Pressa (minera mais rápido)
JUMP - Pulo
REGENERATION - Regeneração
NIGHT_VISION - Visão noturna

Os efeitos são aplicados apenas quando o jogador está com a armadura da classe equipada.

bonus

Bônus percentuais que a classe fornece ao jogador.

classes:
  class1:
    bonus:
      blocks: 5  # +5% de blocos minerados
      coin: 10   # +10% de coins ao vender

Placeholders disponíveis nas armaduras:

{blocks} - Valor do bônus de blocos
{coin} - Valor do bônus de coins

prices

Custos necessários para evoluir para esta classe.

classes:
  class1:
    prices:
      price1:
        provider: 'money'
        price: 1000.0
      price2:
        provider: 'xp'
        price: 500

Providers disponíveis:

money - Economia configurada em economies.yml
xp - Níveis de experiência
Outras economias configuradas

Você pode adicionar múltiplos custos para a mesma classe usando price1, price2, etc.

armor

Configuração dos itens da armadura que o jogador receberá.

classes:
  class1:
    armor:
      helmet:
        material: LEATHER_HELMET
        name: '&fClasse Quartzo'
        lore:
          - '&fBônus adquiridos:'
          - '&7- +{blocks}% de blocos'
          - '&7- +{coin}% de coins'
      chestplate:
        material: LEATHER_CHESTPLATE
        name: '&fClasse Quartzo'
        lore: [...]
      leggings:
        material: LEATHER_LEGGINGS
        name: '&fClasse Quartzo'
        lore: [...]
      boots:
        material: LEATHER_BOOTS
        name: '&fClasse Quartzo'
        lore: [...]

Use materiais de armadura de couro (LEATHER_) para poder aplicar cores customizadas!

Configuração dos itens exibidos no menu de classes em diferentes estados.

classes:
  class1:
    menu:
      buy:
        # Quando pode comprar
        material: LEATHER_CHESTPLATE
        color: '255:255:255'
        name: '&fClasse Quartzo'
        lore:
          - '&aClique para evoluir'
      has:
        # Quando tem mas não está equipada
        lore:
          - '&aClique para equipar.'
      equipped:
        # Quando está equipada
        lore:
          - '&aVocê está usando este.'
      need:
        # Quando não tem os recursos
        lore:
          - '&cVocê não possui os custos para evoluir.'
      previous:
        # Quando não tem a classe anterior
        lore:
          - '&cVocê não possui a classe anterior.'

Placeholders disponíveis no menu:

{blocks} - Bônus de blocos
{coin} - Bônus de coins
{money} - Preço formatado

Criando sistema de progressão

Exemplo de sistema com 4 classes progressivas:

classes:
  quartzo:
    order: 0
    display: '&fQuartzo'
    color: '255:255:255'
    permission: ''
    effects: ['SPEED:1']
    bonus:
      blocks: 5
      coin: 10
    prices:
      price1:
        provider: 'money'
        price: 1000.0
  
  ferro:
    order: 1
    display: '&7Ferro'
    color: '192:192:192'
    permission: ''
    effects: ['SPEED:1', 'HASTE:1']
    bonus:
      blocks: 10
      coin: 15
    prices:
      price1:
        provider: 'money'
        price: 5000.0
  
  ouro:
    order: 2
    display: '&6Ouro'
    color: '255:215:0'
    permission: ''
    effects: ['SPEED:2', 'HASTE:1']
    bonus:
      blocks: 15
      coin: 20
    prices:
      price1:
        provider: 'money'
        price: 15000.0
  
  diamante:
    order: 3
    display: '&bDiamante'
    color: '0:255:255'
    permission: ''
    effects: ['SPEED:2', 'HASTE:2']
    bonus:
      blocks: 25
      coin: 30
    prices:
      price1:
        provider: 'money'
        price: 50000.0

Comandos relacionados

Para dar uma classe manualmente a um jogador:

/minaadm setclass <jogador> <classe>

Exemplo:

/minaadm setclass Player123 diamante

Como funciona

O jogador precisa evoluir as classes em ordem. Não é possível pular classes!

Fluxo de progressão:

Jogador começa sem classe
Evolui para classe com order: 0 (primeira)
Depois para order: 1 (segunda)
E assim por diante...

Benefícios:

Efeitos de poção enquanto usa a armadura
Bônus permanentes de blocos e coins
Armaduras customizadas com cores

Permissões

Para usar o sistema de classes:

yminaspackets.use

Para acessar o menu de classes:

/mina classes

Após alterar as configurações, execute /minaadm reload para aplicar as mudanças.

Nesta página