MyEconomy

Документация · v1.2

Установка и начало

Требования

Сервер Paper 1.21+ (или производный). Vault рекомендуется для интеграции с другими плагинами (магазины, работы и т.д.). Опционально: PlaceholderAPI, DecentHolograms, MyCore.

Установка по шагам

Скачайте MyEconomy.jar со страницы загрузок.
Поместите файл в папку plugins/ сервера.
Перезапустите сервер (или выполните /reload, если хост разрешает).
При первом запуске создаётся plugins/MyEconomy/config.yml.

Проверка

В игре введите /balance (или /bal). Если плагин загружен, отобразится баланс. Новые игроки получают стартовый баланс из конфига.

Первые шаги

Основные команды: /balance или /bal — баланс, /pay <игрок> <сумма> — отправить деньги, /ecomenu — открыть меню. Настройте валюту и рейтинги в config.yml.

Пример конфигурации

Фрагмент config.yml для валюты и стартового баланса:

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

Команды

Команды игрока

Команда	Описание	Алиасы
`/balance [игрок]`	Показать баланс	bal, money
`/pay <игрок> <сумма>`	Отправить деньги	send
`/baltop [weekly\|monthly]`	Рейтинг богатейших	topbalance, topbal
`/ecomenu`	Открыть меню экономики	moneymenu, economy, market, prices
`/transactions [игрок] [страница]`	История транзакций	history, tx

Команды админа

/eco <give|take|set|reset> <игрок> [сумма] — Выдать, снять, установить или сбросить баланс игрока.

Разрешения

myeconomy.player — Команды игрока (balance, pay, baltop, menu, transactions)
myeconomy.balance.others — Смотреть чужой баланс
myeconomy.admin — Команды /eco
myeconomy.admin.hologram — Управление голограммами

Настройка (config.yml)

Общее

general.language — Язык (en, fr, es, de и т.д.). general.prefix — Префикс сообщений. general.debug — Отладочные сообщения.

Валюта

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

Стартовый баланс

starting-balance.amount — Сумма для новых игроков. starting-balance.welcome-message — Приветственное сообщение (плейсхолдеры: {amount}, {currency}).

Платежи (/pay)

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

Рейтинги

rankings.top-size. Недельный: rankings.weekly.enabled, reset-day, rewards.positions. Месячный: rankings.monthly (та же структура).

Безопасность

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

База данных

database.type — yaml, mysql или sqlite. Затем database.mysql или database.sqlite.

Голограммы (DecentHolograms)

holograms.enabled, update-interval, format.title-global, format.line-format (плейсхолдеры: {rank}, {player}, {balance}, {currency}).

Функции

Полная экономика

Настраиваемая валюта (название, символ, десятичные), стартовый баланс, история транзакций.

Рейтинги

Глобальный, недельный и месячный рейтинг с автоматическими наградами (топ 1, 2, 3). Сброс по дню недели или месяца.

Меню GUI

/ecomenu — Интерфейс для просмотра баланса, отправки денег (быстрые суммы), рейтингов.

Интеграции

Vault — API экономики для других плагинов
PlaceholderAPI — Плейсхолдеры (баланс, ранг и т.д.)
DecentHolograms — Голограммы рейтинга
MyCore — События и API
Аукцион (налоги, отслеживание транзакций)

Безопасность

Лимит транзакций в минуту, кулдаун, лимит баланса, подтверждение для крупных сумм.