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 o armazenamento de dados e comportamento geral das economias. Abaixo estão todas as opções disponíveis com explicações detalhadas.

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

database

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

• SQLITE: Armazena dados em um arquivo local. Ideal para servidores pequenos ou únicos.
• MYSQL: Conecta a um servidor MySQL externo. Recomendado para servidores médios.
• HIKARI: Usa pool de conexões para MySQL. Recomendado para redes e servidores grandes por melhor performance.

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

  # Nome da tabela dos usuários
  table: 'yeconomias.players'

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

Quando usar cada tipo:

• SQLITE: Servidor único, até 100 jogadores simultâneos
• MYSQL: Servidor único ou rede, 100-500 jogadores
• HIKARI: Redes BungeeCord/Velocity, 500+ jogadores, necessita de sincronização em tempo real

Configuração recomendada para redes:

database:
  storage-type: HIKARI
  table: 'yeconomias.players'
  data:
    host: 192.168.1.100
    port: 3306
    database: 'minecraft'
    username: 'minecraft_user'
    password: 'senha_segura_aqui'

redis

Configuração de cache Redis para melhorar performance e evitar concorrência no banco de dados. Ideal para servidores com alto volume de transações.

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: 6379]
  port: 6379
  
  # Usuário de conexão. [EX: root]
  username: ''
  
  # Senha do usuário de conexão: [EX: 123]
  password: ''
  
  # Delay para carregar os dados depois do login (em ticks)
  # Necessário para usar em servidor de mina separado
  # Recomendado: 20 ticks (1 tick = 50ms, então 20 ticks = 1 segundo)
  login-delay: 20

Quando ativar Redis:

• Servidores com alta concorrência e múltiplas transações simultâneas
• Servidores de mina separados em redes BungeeCord/Velocity
• Quando você quer evitar deadlocks e problemas de concorrência no banco de dados

Configuração recomendada:

redis:
  enabled: true
  host: 'redis-server.example.com'
  port: 6379
  username: 'redis_user'
  password: 'senha_segura_aqui'
  login-delay: 20