MyEconomy

Documentação · v1.2

Instalação e início

Requisitos

Servidor Paper 1.21+ (ou derivado). Vault recomendado para integração com outros plugins (lojas, jobs, etc.). Opcional: PlaceholderAPI, DecentHolograms, MyCore.

Instalação passo a passo

  1. Descarregue MyEconomy.jar na página de downloads.
  2. Coloque o ficheiro na pasta plugins/ do servidor.
  3. Reinicie o servidor (ou execute /reload se o seu host permitir).
  4. Na primeira execução, plugins/MyEconomy/config.yml é criado automaticamente.

Verificação

No jogo digite /balance (ou /bal). Se o plugin estiver carregado verá o seu saldo. Novos jogadores recebem um saldo inicial definido na config.

Primeiros passos

Comandos essenciais: /balance ou /bal para ver saldo, /pay <jogador> <valor> para enviar dinheiro, /ecomenu para abrir o menu. Personalize moeda e rankings em config.yml.

Exemplo de configuração

Excerto de config.yml para moeda e saldo inicial:

currency:
  name: "coins"
  symbol: ""
  decimals: 2
starting-balance:
  amount: 100.0
  welcome-message: "&aYou received &e{amount} {currency} &a!"

Comandos

Comandos jogador

ComandoDescriçãoAlias
/balance [jogador]Mostrar saldobal, money
/pay <jogador> <valor>Enviar dinheirosend
/baltop [weekly|monthly]Ranking dos mais ricostopbalance, topbal
/ecomenuAbrir menu economiamoneymenu, economy, market, prices
/transactions [jogador] [página]Histórico de transaçõeshistory, tx

Comandos admin

/eco <give|take|set|reset> <jogador> [valor] — Dar, retirar, definir ou repor o saldo de um jogador.

Permissões

  • myeconomy.player — Comandos jogador (balance, pay, baltop, menu, transactions)
  • myeconomy.balance.others — Ver saldo de outros
  • myeconomy.admin — Comandos /eco
  • myeconomy.admin.hologram — Gerir hologramas

Configuração (config.yml)

Geral

general.language — Idioma (en, fr, es, de, etc.). general.prefix — Prefixo de mensagens. general.debug — Mensagens de debug.

Moeda

currency.name, currency.singular, currency.plural, currency.symbol, currency.decimals, currency.display-format (name ou symbol), currency.short-format (1.5K, 1.2M).

Saldo inicial

starting-balance.amount — Valor para novos jogadores. starting-balance.welcome-message — Mensagem de boas-vindas (placeholders: {amount}, {currency}).

Pagamentos (/pay)

pay.enabled, pay.min-amount, pay.max-amount, pay.tax-percentage, pay.require-confirmation-above, pay.allow-self-pay, pay.quick-amounts.

Rankings

rankings.top-size. Semanal: rankings.weekly.enabled, reset-day, rewards.positions. Mensal: rankings.monthly (mesma estrutura).

Segurança

security.max-transactions-per-minute, transaction-cooldown, max-balance, min-balance, allow-negative-balance.

Base de dados

database.type — yaml, mysql ou sqlite. Depois database.mysql ou database.sqlite.

Hologramas (DecentHolograms)

holograms.enabled, update-interval, format.title-global, format.line-format (placeholders: {rank}, {player}, {balance}, {currency}).

Recursos

Economia completa

Moeda personalizável (nome, símbolo, decimais), saldo inicial, histórico de transações.

Rankings

Ranking global, semanal e mensal com recompensas automáticas (top 1, 2, 3). Reinício configurável (dia da semana ou do mês).

Menu GUI

/ecomenu — Interface para ver saldo, enviar dinheiro (valores rápidos), ver rankings.

Integrações

  • Vault — API de economia para outros plugins
  • PlaceholderAPI — Placeholders (saldo, rank, etc.)
  • DecentHolograms — Hologramas de ranking
  • MyCore — Eventos e API
  • Casa de leilões (impostos, rastreio de transações)

Segurança

Máximo de transações por minuto, cooldown, limite de saldo, confirmação para valores grandes.