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

data.yml

menus.yml

messages.yml

Configuração do plugin (config.yml)

O arquivo config.yml é o coração do plugin, onde você controla todos os aspectos do funcionamento da economia. 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

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

database

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

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

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: ''
    # Prefixo para diferenciar no redis
    prefix: ''

Se usar SQLITE, não precisa preencher os dados de conexão. O arquivo será criado automaticamente em plugins/yEconomy/data.db.

redis

Configurações do servidor Redis para sincronização multi-servidor (BungeeCord/Velocity).

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: ''
  # Timeout de rede em milissegundos
  timeout-ms: 2000
  # Configuração do pool de conexões
  pool:
    max-total: 64
    max-idle: 24
    min-idle: 8
    max-wait-ms: 1500
    test-on-borrow: true
    test-while-idle: true
    eviction-run-ms: 30000

Quando usar Redis:

Rede BungeeCord/Velocity com múltiplos servidores
Sincronização em tempo real de saldos entre servidores
Sistema de economia compartilhado entre lobbies e servidores de jogo

As opções timeout-ms e pool controlam o tempo máximo de conexão e o reaproveitamento de conexões Redis em redes maiores.

general

Configurações gerais do sistema de economia.

general:
  # Ativar transações com players não conectados
  offline-transactions: true
  # Ao digitar /money abrir o menu.
  # False = Vai enviar a quantia de money que ele tem no chat
  # True = Vai abrir o menu
  money-menu: true
  # Ao ativar irá abrir o menu do top ao digitar /money top
  top-menu: true
  # Tempo que irá atualizar o top
  # Em segundos
  top-delay: 600
  # Tag do magnata no chat
  top-tag: '&2[$]'
  # NBT-Tag dos cheques
  # altere caso queira inutilizar os cheques antigos
  check-nbt-tag: 'yEconomy-Cheque'

Destaques importantes:

offline-transactions: Permite enviar dinheiro para jogadores offline
money-menu: true = abre GUI, false = mostra saldo no chat
top-delay: 600 segundos = 10 minutos. Atualização do ranking
top-tag: Tag exibida no chat para o jogador mais rico do servidor
check-nbt-tag: tag NBT usada para identificar cheques. Altere apenas se quiser invalidar cheques antigos.

Ajuste o top-delay conforme o tamanho do servidor. Valores menores (300s) atualizam mais rápido, mas consomem mais recursos.

coin-preferences

Preferências da moeda do servidor. Define valores iniciais e formatação.

coin-preferences:
  # Quantia de money que o jogador vai começar
  initial-amount: 30.0
  # Formato do money na quantia singular
  singular-format: 'coin'
  # Formato do money no plural
  plural-format: 'coins'

Exemplos de uso:

# Para Reais:
singular-format: 'real'
plural-format: 'reais'

# Para Dólares:
singular-format: 'dólar'
plural-format: 'dólares'

# Para Rubis:
singular-format: 'rubi'
plural-format: 'rubis'

top-chat

Configuração da formatação do ranking no chat quando executado /money top (se top-menu estiver desativado).

top-chat:
  # O plugin irá reconhecer quando isto for apenas espaços e vai removê-los.
  rich-format: '{magnata} '
  # O plugin irá reconhecer quando isto for apenas espaços e vai removê-los.
  prefix-format: '%luckperms_prefix% '
  # Tags juntas
  tags: '{magnata}{prefixo}'
  # Formato geral do jogador no top
  player-format: '  &f{pos}º {tags}&7{player}&2: &7($ {money})'
  # Mensagem do TOP
  message: |
    &r
    &2Top 10 Mais Ricos &7(Atualizado de 10 em 10 minutos)
    &r
    {formato}
    &r

Placeholders disponíveis:

Placeholder	Descrição
`{magnata}`	Tag do magnata (se for o jogador mais rico)
`{prefixo}`	Prefixo do jogador (PlaceholderAPI)
`{pos}`	Posição no ranking
`{player}`	Nome do jogador
`{money}`	Quantia de dinheiro formatada
`{formato}`	Lista completa dos jogadores no top

checks

Sistema de cheques físicos. Permite criar itens que armazenam dinheiro e podem ser transferidos entre jogadores.

checks:
  main-check:
    material: PAPER
    glow: true
    name: '&aCheque de dinheiro'
    lore:
      - ''
      - '&7Criado por: &a{player}&7.'
      - '&7Criado em: &f{data} &8- &f{hora}&7.'
      - ''
      - '&bValor do cheque: &a{money}&b.'
      - ''
      - '&7Clique com botão direito para ativar'
  media-check:
    material: PAPER
    glow: true
    name: '&aCheque de dinheiro'
    lore:
      - ''
      - '&bValor do cheque: &a{amount}&b.'
      - ''
      - '&7Clique com botão direito para ativar'
  death-check:
    enabled: true
    # Máximo de money para o morto perder ( x % do seu money )
    maximum: 20000.0
    # Quando o jogador morrer, perder esta % de money
    percentage: 10.0
    item:
      material: PAPER
      glow: true
      name: '&aCheque de dinheiro'
      lore:
        - ''
        - '&7Dropado por: &a{player}&7.'
        - '&7Aniquiliado em: &f{data} &8- &f{hora}&7.'
        - ''
        - '&bValor do cheque: &a{money}&b.'
        - ''
        - '&7Clique com botão direito para ativar'

Tipos de cheques:

main-check: Cheque criado manualmente pelo jogador usando /money cheque <valor>
media-check: Cheque criado por admins baseado na média da economia do servidor
death-check: Cheque dropado automaticamente quando um jogador morre

lose-on-death

Sistema para remover uma porcentagem do money quando o jogador morre, com percentuais por rank/permissão.

# Sistema de perder % do money ao morrer
lose-on-death:
  enabled: false
  # Máximo de money que poderá ser perdido
  # Deixe 0 para não ter limite
  max-money: 0
  # Porcentagens de acordo com o rank
  percents:
    member:
      order: 1
      permission: ''
      percent: 10.0
      message: '&cVocê morreu e perdeu 10% do seu money. &7($ {amount})'
    vip:
      order: 2
      permission: 'yessentials.deathlose.vip'
      percent: 5.0
      message: '&cVocê morreu e perdeu 5% do seu money. &7($ {amount})'

O plugin usa a ordem e a permissão para definir qual percentual será aplicado. O placeholder {amount} mostra o valor perdido.

Configuração do death-check:

# Exemplo: Jogador tem 100.000 coins
# percentage: 10.0 = perde 10% = 10.000 coins
# maximum: 20000.0 = limita a perda máxima em 20.000 coins
# Resultado: perde 10.000 coins (menor que o máximo)

# Exemplo 2: Jogador tem 500.000 coins  
# percentage: 10.0 = perde 10% = 50.000 coins
# maximum: 20000.0 = limita a perda máxima em 20.000 coins
# Resultado: perde apenas 20.000 coins (limitado pelo máximo)

Para desativar perda de dinheiro ao morrer, defina death-check.enabled: false

Jogadores com permissão yeconomy.death.bypass não perdem dinheiro ao morrer.

npc

Sistema de NPCs para exibir os 3 jogadores mais ricos do servidor com hologramas.

npc:
  # Altura do holograma em cima do NPC
  offset: 3.1
  # Holograma do NPC
  hologram-lines:
    - '&a&lTOP &7&l#{pos}'
    - ''
    - '&e{nome}'
    - '&7Money: &f{money}'
    - ''

Como usar:

Use /money setnpc <1/2/3> olhando para um NPC
O holograma aparecerá acima do NPC mostrando a posição, nome e saldo do jogador
Use /money delnpc <1/2/3> para remover o holograma

Placeholders disponíveis:

{pos} - Posição no ranking (1, 2 ou 3)
{nome} - Nome do jogador
{money} - Saldo formatado do jogador

Os NPCs precisam ser criados usando outro plugin (ex: Citizens). O yEconomy apenas adiciona os hologramas acima deles.

Nesta página