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.

Após alterar a configuração, use /cratefelca reload ou reinicie o servidor.

Estrutura de arquivos

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

commands.yml

config.yml

economies.yml

menus.yml

messages.yml

rarities.yml

Como funciona

Cada arquivo da pasta crates é uma crate. O nome do arquivo (ex: normal) é o ID usado nos comandos.
O jogador obtém chaves comprando no menu da crate ou recebendo por comando (givekey, giveitem, keyall).
Chaves físicas precisam ser ativadas com o clique direito; ao ativar, viram chaves virtuais (ativas) no menu.
Ao interagir com a crate, o jogador abre o menu e escolhe qual recompensa quer coletar, gastando uma chave ativa.
Crates com o mesmo group aparecem como abas no mesmo menu.

Configuração do plugin (config.yml)

O arquivo config.yml controla o banco de dados, o Redis, os delays, as opções gerais e os sons. Abaixo estão todas as opções disponíveis.

debug-mode

Ativa ou desativa o modo de depuração. Quando ativado, o plugin registra informações detalhadas no console para ajudar a identificar problemas.

# Modo de depuração para correção de problemas no plugin.
debug-mode: false

Mantenha desativado em produção, pois pode gerar muitos logs e afetar a performance.

database

Define o tipo de banco de dados (SQLITE, MYSQL ou HIKARI) e os dados de conexão usados pelo MySQL/Hikari.

database:
  # Determina o tipo de banco de dados. Valores válidos: [SQLITE, MYSQL, HIKARI (recomendado)]
  storage-type: SQLITE

  # Dados para conexão ao banco de dados MYSQL.
  data:
    # Endereço de conexão do banco de dados. [EX: 127.0.0.1]
    host: localhost
    # Porta de conexão do banco de dados. [EX: 3306]
    port: 3306
    # Nome do banco de dados a ser conectado. [EX: minecraft]
    database: ''
    # Usuário de conexão. [EX: root]
    username: ''
    # Senha do usuário de conexão: [EX: 123]
    password: ''

Para servidores com várias instâncias, utilize HIKARI (recomendado) apontando para o mesmo banco de dados.

redis

Ativa a sincronização entre servidores via Redis e define os dados de conexão.

# Configurações do servidor redis
redis:
  # Ativar a conexão com o redis
  enabled: false
  # Endereço de conexão. [EX: 127.0.0.1]
  host: 'localhost'
  # Porta de conexão. [EX: 3306]
  port: 6379
  # Usuário de conexão. [EX: root]
  username: ''
  # Senha do usuário de conexão: [EX: 123]
  password: ''

Tempo, em ticks, para carregar os dados do jogador depois do login. Necessário quando o servidor de mina é separado (recomendado: 20).

# Delay para carregar os dados depois do login
# Necessário para usar em servidor de mina separado
# Recomendado: 20 ticks
login-delay: 20

spawn-delay

Tempo, em ticks, para carregar as crates no mundo depois que o servidor liga (20 ticks = 1 segundo).

# Carregar as crates depois de x tempo que o server ligar
# Em ticks (20 ticks = 1 segundo)
spawn-delay: 20

general

Opções gerais do plugin.

give-virtual: se true, o givekey adiciona chaves virtuais no menu; se false, entrega o item físico.
give-compact: entrega as chaves físicas compactadas em um único item.
interact-distance: distância máxima para clicar em crates do tipo ROTATING_HEAD ou DISPLAY_ENTITY.

# Sistemas gerais
general:
  # Se true, /givekey adiciona chaves virtuais no menu. Se false, entrega o item físico.
  give-virtual: true
  # Dar as keys físicas compactadas em 1 item só
  give-compact: true
  # Distância máxima para clicar em rotating-head / display
  interact-distance: 6.0

sounds

Sons (nomes de Sound do Bukkit) tocados em cada ação: sucesso, falha, coleta de recompensa, compra de chaves e ativação de chave física.

# Sons (nomes de Sound do Bukkit)
sounds:
  # Som ao concluir uma ação com sucesso
  success: 'ENTITY_EXPERIENCE_ORB_PICKUP'
  # Som ao falhar (sem chave, sem saldo, etc.)
  fail: 'ENTITY_VILLAGER_NO'
  # Som ao coletar uma recompensa
  collect: 'ENTITY_PLAYER_LEVELUP'
  # Som ao comprar chaves no menu
  buy: 'ENTITY_EXPERIENCE_ORB_PICKUP'
  # Som ao ativar uma chave física
  activate: 'ENTITY_EXPERIENCE_ORB_PICKUP'

Use os nomes de som correspondentes à versão do seu servidor.

Arquivos de configuração

Crates: crie e configure as crates.
Raridades: raridades das recompensas.
Comandos: comando e aliases.
Economias: economias usadas na compra de chaves.
Menus: menus do plugin.
Mensagens: mensagens do plugin.

Nesta página