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, é necessário reiniciar 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

menus.yml

messages.yml

rewards.yml

Configuração do plugin (config.yml)

O arquivo config.yml controla o banco de dados, o Redis, o delay de login, a integração com o FlipTop, o ranking, o histórico e os sons do plugin. Abaixo estão todas as opções disponíveis.

debug-mode

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

# Determina o funcionamento da depuração. Valores válidos: [false, true]
debug-mode: false

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

database

Define como e onde os dados serão armazenados. O plugin suporta três tipos de armazenamento:

SQLITE: Armazena dados em um arquivo local.
MYSQL: Conecta a um servidor MySQL externo.
HIKARI: Usa pool de conexões para MySQL. Recomendado.

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: ''

Se usar SQLITE, não precisa preencher os dados de conexão.

Exemplo com HIKARI:

database:
  storage-type: HIKARI
  data:
    host: 127.0.0.1
    port: 3306
    database: minecraft
    username: root
    password: '123'

redis

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: ''

Exemplo:

redis:
  enabled: true
  host: '127.0.0.1'
  port: 6379
  username: ''
  password: '123'

Delay em ticks para carregar os dados depois do login. Necessário para usar em servidor de mina separado.

# Recomendado: 20 ticks
login-delay: 20

fliptop

Integração com o FlipTop. Cole o ID do anúncio Minecraft no FlipTop e o mesmo secret aqui. O plugin consulta o site periodicamente (funciona em host compartilhada).

fliptop:
  # UUID do anúncio Minecraft no FlipTop
  ad-id: ''
  # Secret compartilhado (mínimo 8 caracteres)
  secret: ''
  # URL base da API do FlipTop
  api-url: 'https://fliptop.site'
  # Link mostrado aos jogadores para votar
  vote-url: 'https://fliptop.site/br/minecraft/{ad-id}'
  poll:
    enabled: true
    # 100 ticks = 5 segundos
    interval-ticks: 200

Opção	Descrição
`ad-id`	UUID do anúncio Minecraft no FlipTop
`secret`	Secret compartilhado (mínimo 8 caracteres)
`api-url`	URL base da API do FlipTop
`vote-url`	Link mostrado aos jogadores para votar
`poll.enabled`	Ativa a consulta periódica ao FlipTop
`poll.interval-ticks`	Intervalo da consulta em ticks (100 ticks = 5 segundos)

O {ad-id} em vote-url é substituído pelo valor de ad-id.

Exemplo:

fliptop:
  ad-id: '00000000-0000-0000-0000-000000000000'
  secret: 'seu-secret'
  api-url: 'https://fliptop.site'
  vote-url: 'https://fliptop.site/br/minecraft/{ad-id}'
  poll:
    enabled: true
    interval-ticks: 200

Com interval-ticks: 200 e a referência de 100 ticks = 5 segundos, a consulta ocorre a cada 10 segundos.

general

Sistemas gerais do plugin.

general:
  top-limit: 10
  date-format: 'dd/MM/yyyy HH:mm'
  history-limit: 54

Opção	Descrição	Padrão
`top-limit`	Limite do ranking de votos	`10`
`date-format`	Formato de data e hora	`dd/MM/yyyy HH:mm`
`history-limit`	Limite de entradas no histórico	`54`

sounds

Sons reproduzidos nas ações do plugin. Use nomes de Sound do Bukkit.

sounds:
  vote-success: ORB_PICKUP
  claim-success: ORB_PICKUP
  action-fail: VILLAGER_NO

Opção	Descrição	Padrão
`vote-success`	Som quando o voto é computado	`ORB_PICKUP`
`claim-success`	Som quando a recompensa é coletada	`ORB_PICKUP`
`action-fail`	Som quando a ação falha	`VILLAGER_NO`

Nesta página