EcoBal Economy API

Мод для Майнкрафт на Fabric, который добавляет на сервер экономику с балансами игроков, переводами и таблицей самых богатых. Он работает как самостоятельная основа экономики и API для других модов, например ShopShelves.

Возможности

Баланс и последнее известное имя каждого игрока сохраняются между перезапусками сервера, поэтому в таблице богатых отображаются и офлайн-игроки. Начальный баланс и символ валюты задаются в конфигурации или командами администратора.

Таблица /baltop поддерживает страницы до десяти игроков, а её заголовок, подвал и оформление первых трёх мест настраиваются. Экономические сообщения можно выводить в чат, строку действий или в оба места; доступны обычные цветовые коды &c, шестнадцатеричные &#RRGGBB, текст при наведении {текст} и действия по нажатию <action:type,value>.

Для разработчиков доступен класс me.andy.ecobal.api.EconomyManager. В нём есть методы getBalance, silentDeposit, silentWithdraw, getTopBalances, getAllBalances, setBalance и formatBalance. Методы silentDeposit и silentWithdraw меняют баланс без встроенных сообщений мода.

Как пользоваться

Игроки могут проверять баланс, переводить деньги и смотреть рейтинг:

• /balance, /bal — свой баланс или баланс игрока;
• /pay <player> <amount> — перевод денег;
• /balancetop, /baltop, /ecotop [page] — рейтинг по балансам.

Администраторские команды:

• /eco give <player> <amount> — выдать деньги;
• /eco take <player> <amount> — снять деньги;
• /eco set <player> <amount> — установить баланс;
• /eco start <amount> — изменить начальный баланс;
• /eco symbol <symbol> — изменить символ валюты;
• /eco reset <player> — сбросить баланс игрока до начального;
• /ecobal reset — сбросить балансы всех игроков;
• /ecobal reload — перечитать конфигурацию;
• /ecobal mode [mode] — посмотреть или выбрать способ вывода сообщений: CHAT, ACTIONBAR либо BOTH.

Настройки

Параметры экономики хранятся в JSON-файлах. В message_formatting.json можно отдельно настроить сообщения для chat и actionbar, включая сообщения о балансе, переводах, ошибках и действиях администрации.

Требования и совместимость

Это серверный мод для Fabric. Для гибкой выдачи прав используется Fabric Permissions API v0; без него публичные команды доступны всем, а административные команды требуют уровень оператора 2.

Права

• ecobal.command.use — /ecobal и /eb;
• ecobal.bal — /balance и /bal;
• ecobal.pay — /pay;
• ecobal.top — /balancetop и /baltop;
• ecobal.eco — все административные команды /eco и команды настройки.