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)

Abaixo estão os valores de configuração do plugin.

Exemplo completo de configuração

Aqui está um exemplo de como configurar o arquivo principal do plugin:

#          ____           _            __  __            _     _ _              _       _     _
#  _   _ / ___|_ __ __ _| |_ ___  ___|  \/  | ___   ___| |__ (_) | __ _ ___   / \   __| | __| | ___  _ __
# | | | | |   | '__/ _` | __/ _ \/ __| |\/| |/ _ \ / __| '_ \| | |/ _` / __| / _ \ / _` |/ _` |/ _ \| '_ \
# | |_| | |___| | | (_| | ||  __/\__ \ |  | | (_) | (__| | | | | | (_| \__ \/ ___ \ (_| | (_| | (_) | | | |
#  \__, |\____|_|  \__,_|\__\___||___/_|  |_|\___/ \___|_| |_|_|_|\__,_|___/_/   \_\__,_|\__,_|\___/|_| |_|
#  |___/
#

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

# Sistema de upgrade
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
  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

# 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.'

# 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.'

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

general

Configurações gerais do sistema de mochilas.

automatic-delay

Delay de abertura automática em segundos.

general:
  automatic-delay: 10

Parâmetros:

• Define o intervalo de tempo entre cada abertura automática de chaves
• Padrão: 10 segundos
• Valores menores resultam em aberturas mais rápidas, mas podem gerar lag

upgrades

Configurações do sistema de upgrade das mochilas.

storage-limit

Configurações de upgrade de armazenamento.

upgrades:
  storage-limit:
    maximum: 4000
    default: 500
    per-upgrade-add: 500
    prices-per-upgrade:
      price1:
        provider: 'money'
        amount: 200.0

Parâmetros:

• maximum: Máximo de limite de keys que podem ser armazenadas

  • Padrão: 4000
  • Define o limite máximo após todos os upgrades

• default: Limite de keys armazenadas por padrão

  • Padrão: 500
  • Capacidade inicial da mochila antes de qualquer upgrade

• per-upgrade-add: Quantidade que será acrescida a cada upgrade

  • Padrão: 500
  • Cada upgrade adiciona esta quantidade ao limite de armazenamento

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

  • provider: Economia utilizada (deve estar configurada em economies.yml)
  • amount: Valor cobrado para realizar o upgrade

Exemplo de cálculo:

Nível 0: 500 keys (padrão)
Nível 1: 1000 keys (500 + 500)
Nível 2: 1500 keys (1000 + 500)
...
Nível 7: 4000 keys (limite máximo)

open-limit

Configurações de upgrade de quantidade de abertura.

upgrades:
  open-limit:
    maximum: 100
    default: 10
    per-upgrade-add: 10
    prices-per-upgrade:
      price1:
        provider: 'money'
        amount: 200.0

Parâmetros:

• maximum: Máximo de quantidade de abertura de keys por vez

  • Padrão: 100
  • Define quantas keys podem ser abertas simultaneamente após todos os upgrades

• default: Quantidade padrão de abertura de keys por vez

  • Padrão: 10
  • Quantidade inicial antes de qualquer upgrade

• per-upgrade-add: Quantidade que será acrescida a cada upgrade

  • Padrão: 10
  • Cada upgrade adiciona esta quantidade ao limite de abertura

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

  • provider: Economia utilizada (deve estar configurada em economies.yml)
  • amount: Valor cobrado para realizar o upgrade

backpack

Configuração do 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

  • Padrão: ENDER_CHEST
  • Aceita qualquer material válido do Minecraft

• name: Nome do item

  • Padrão: &6Mochila de Chaves
  • Suporta códigos de cor

• lore: Descrição do item

  • Suporta placeholders:
    • {actual}: Quantidade atual de keys armazenadas
    • {total}: Capacidade total da mochila
    • {progressbar}: Barra de progresso visual
    • {percentage}: Percentual de preenchimento

automatic

Configuração do item 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
  • Aceita qualquer material válido do Minecraft

• name: Nome do item

  • Padrão: &dAbertura automática
  • Suporta códigos de cor

• lore: Descrição do item

  • Instruções de uso para o jogador

progress-bar

Configuração da barra de progresso.

progress-bar:
  amount: 10
  symbol: ':'
  color-yes: '&a'
  color-not: '&7'

Parâmetros:

• amount: Quantidade de símbolos na barra

  • Padrão: 10
  • Define o tamanho visual da barra de progresso

• symbol: Símbolo utilizado na barra

  • Padrão: :
  • Pode ser qualquer caractere

• color-yes: Cor da parte preenchida

  • Padrão: &a (verde)
  • Representa a quantidade usada

• color-not: Cor da parte vazia

  • Padrão: &7 (cinza)
  • Representa o espaço disponível

Exemplo visual:

&a:::&7::::::: (30% preenchido)
&a::::::&7:::: (60% preenchido)