Configuração

O plugin deve funcionar sem necessidade de configuração adicional, mas se você precisar alterar o comportamento do plugin, você está no lugar certo.

Estrutura de arquivos

Abaixo está um exemplo de como é a estrutura de arquivos do plugin. Clique em uma pasta para expandi-la.

Configuração do plugin (config.yml)

O arquivo config.yml é o coração do plugin, onde você controla todos os aspectos do funcionamento das mochilas. Abaixo estão todas as opções disponíveis com explicações detalhadas.

general

Configurações gerais do addon.

general:
  # Delay de abertura automática
  # em segundos
  automatic-delay: 10

Parâmetros:

• automatic-delay: Define o intervalo em segundos entre cada abertura automática de chaves
  • Padrão: 10 segundos
  • Valores recomendados: 5-20 segundos

upgrades

Sistema de evolução das mochilas. Permite que jogadores melhorem a capacidade de armazenamento e quantidade de abertura de chaves.

storage-limit

Configurações do upgrade de limite de armazenamento de chaves.

upgrades:
  storage-limit:
    # Máximo de limite de keys
    maximum: 4000
    # Limite de keys armazenadas por padrão
    default: 500
    # Quantidade que será acrescida a cada upgrade
    per-upgrade-add: 500
    prices-per-upgrade:
      price1:
        provider: 'money'
        amount: 200.0

Parâmetros:

• maximum: Limite máximo de chaves que podem ser armazenadas após todos os upgrades

  • Padrão: 4000

• default: Quantidade inicial de chaves que a mochila pode armazenar

  • Padrão: 500

• per-upgrade-add: Quantidade adicional de armazenamento a cada upgrade

  • Padrão: 500

• prices-per-upgrade: Lista de preços para cada nível de upgrade

  • provider: Tipo de economia utilizada (configurado em economies.yml)
  • amount: Valor a ser cobrado pelo upgrade

Exemplo de cálculo:

• Nível 0 (padrão): 500 chaves
• Nível 1 (primeiro upgrade): 1000 chaves (500 + 500)
• Nível 2: 1500 chaves (500 + 500 + 500)
• Nível 8 (máximo): 4000 chaves

open-limit

Configurações do upgrade de limite de abertura de chaves por vez.

  open-limit:
    # Máximo de quantidade de abertura de keys por vez
    maximum: 100
    # Quantidade padrão de abertura de keys por vez
    default: 10
    # Quantidade que será acrescida a cada upgrade
    per-upgrade-add: 10
    prices-per-upgrade:
      price1:
        provider: 'money'
        amount: 200.0

Parâmetros:

• maximum: Quantidade máxima de chaves que podem ser abertas simultaneamente

  • Padrão: 100

• default: Quantidade inicial de chaves que podem ser abertas por vez

  • Padrão: 10

• per-upgrade-add: Quantidade adicional de abertura a cada upgrade

  • Padrão: 10

• prices-per-upgrade: Lista de preços para cada nível de upgrade

  • provider: Tipo de economia utilizada (configurado em economies.yml)
  • amount: Valor a ser cobrado pelo upgrade

Exemplo de cálculo:

• Nível 0 (padrão): 10 chaves por vez
• Nível 1 (primeiro upgrade): 20 chaves por vez
• Nível 2: 30 chaves por vez
• Nível 9 (máximo): 100 chaves por vez

backpack

Configuração do item da mochila que os jogadores recebem.

# Item da mochila
backpack:
  material: 'ENDER_CHEST'
  name: '&6Mochila de Chaves'
  lore:
    - '&7Esta mochila armazena todas'
    - '&7as chaves recebidas.'
    - ''
    - ' &6Armazenamento:'
    - ' &7{actual}/{total} {progressbar} &8{percentage}'
    - ''
    - '&6Clique para acessar.'

Parâmetros:

• material: Material do item (formato Minecraft)

  • Exemplo: ENDER_CHEST, CHEST, SHULKER_BOX

• name: Nome exibido no item

  • Suporta códigos de cor (&)

• lore: Lista de linhas de descrição do item

  • Suporta códigos de cor (&)
  • Placeholders disponíveis:
    • {actual} - Quantidade atual de chaves armazenadas
    • {total} - Capacidade total da mochila
    • {progressbar} - Barra de progresso visual
    • {percentage} - Porcentagem de ocupação

Exemplo de progressbar:

100/500 &a:&a:&7:&7:&7:&7:&7:&7:&7:&7 20%

automatic

Configuração do item ativador de abertura automática.

# Item do abridor automático
automatic:
  material: 'STONE_BUTTON'
  name: '&dAbertura automática'
  lore:
    - '&7Utilize este item para'
    - '&7ativar a abertura das chaves'
    - '&7de forma automática.'
    - ''
    - '&7Arraste em uma mochila.'

Parâmetros:

• material: Material do item

  • Padrão: STONE_BUTTON

• name: Nome do item ativador

  • Suporta códigos de cor (&)

• lore: Descrição do item

  • Suporta códigos de cor (&)

progress-bar

Configuração da barra de progresso visual que mostra a ocupação da mochila.

# Configuração da progressbar
progress-bar:
  amount: 10
  symbol: ':'
  color-yes: '&a'
  color-not: '&7'

Parâmetros:

• amount: Quantidade total de símbolos na barra

  • Padrão: 10
  • Valores recomendados: 10-20

• symbol: Caractere usado para desenhar a barra

  • Padrão: :
  • Outros exemplos: |, █, ▪, =

• color-yes: Cor da parte preenchida (chaves armazenadas)

  • Padrão: &a (verde)

• color-not: Cor da parte vazia (espaço disponível)

  • Padrão: &7 (cinza)

Exemplos de resultado:

Com 50% de ocupação (amount: 10):

&a:&a:&a:&a:&a&7:&7:&7:&7:&7

Com 75% de ocupação (amount: 20, symbol: '█'):

&a█&a█&a█&a█&a█&a█&a█&a█&a█&a█&a█&a█&a█&a█&a█&7█&7█&7█&7█&7█

Customizações criativas:

# Estilo moderno
progress-bar:
  amount: 20
  symbol: '█'
  color-yes: '&6'
  color-not: '&8'

# Estilo minimalista
progress-bar:
  amount: 10
  symbol: '▪'
  color-yes: '&e'
  color-not: '&7'

# Estilo tradicional
progress-bar:
  amount: 10
  symbol: '='
  color-yes: '&2'
  color-not: '&8'