💰 CoinMoney — мультивалютная экономика нового уровня
CoinMoney — это продвинутый плагин экономики для Paper / Spigot, который заменяет стандартный «плоский» баланс на гибкую мультивалютную систему.Игроки могут использовать несколько валют одновременно (например: медь → серебро → золото), а плагин автоматически конвертирует их и считает общий баланс, не ломая существующие магазины и экономику.
🔹 Основные возможности
• Неограниченное количество валют (включая собственные)• Создание собственных валют через YAML
• Иерархия валют с настраиваемыми курсами
• Автоматическая конвертация баланса
• Возможность отключить автоконвертацию для любой валюты
• Предметы-монеты (NBT / CustomModelData)
• Поднятие валюты даже при полном инвентаре
• Монеты не занимают место в инвентаре
• Полная интеграция с Vault
• Поддержка PlaceholderAPI
• YAML или SQL хранилище с миграцией данных
• Система языков (RU / EN + любые свои)
🔹 Как работают цены и магазины
Если у вас уже есть магазины с ценами (например 100$):• вам не нужно менять цены
• просто замените стандартный placeholder денег на placeholder CoinMoney
• значение 100 автоматически считается в базовой валюте
• игрок может оплатить покупку любой валютой, если общий баланс позволяет
Это позволяет перейти на CoinMoney без переделки всей экономики.
🔹 Предметы-валюты
Любая валюта может быть представлена физическим предметом с кастомной моделью и NBT.При поднятии предмета:
• он исчезает
• баланс увеличивается
• инвентарь не засоряется
Отлично подходит для RPG-серверов, наград, мобов и квестов.
🔹 Пользовательские валюты
CoinMoney позволяет создавать собственные валюты без ограничений.Каждая валюта:
• создаётся простым YAML-файлом
• имеет своё имя, символ и формат отображения
• может участвовать в иерархии конвертации
• может быть базовой валютой
• может иметь или не иметь автоконвертацию
• может быть связана с предметом-монетой
⚠ Примечание
Internal-name валюты обязательно должен быть в нижнем регистре (lowercase).
Например: copper, silver, gold, platinum.
Это имя используется:
• в командах
• в PlaceholderAPI
• во внутренних расчётах плагина
Использование заглавных букв или пробелов может привести к некорректной работе.
Это позволяет реализовать любые экономические схемы:
RPG-валюты, фракционные деньги, ивентовые токены, донат-валюты и т.д.
🔹 Языки
• Русский и английский из коробки• Возможность добавить любой язык
• Fallback на английский при отсутствии перевода
🔹 Хранение данных
• YAML — для небольших серверов• SQL — для крупных проектов
Есть команды для:
• миграции YAML ↔ SQL
• очистки устаревших валют
📜 Команды
/coinmoney(cm) - Показывает основную информацию о плагине./coinmoney help - Отображает список всех доступных команд CoinMoney и краткое описание их назначения.
/coinmoney balance(bal) [player] - Показывает баланс игрока по всем валютам.
/coinmoney add <валюта> <количество> [player] - Добавляет указанное количество валюты игроку.
/coinmoney set <валюта> <количество> [player] - Полностью устанавливает баланс валюты игрока на указанное значение.
/coinmoney take <валюта> <количество> [player] - Забирает указанное количество валюты у игрока.
/coinmoney pay <player> <валюта> <количество> - Переводит валюту другому игроку.
/coinmoney clear <player> [currency/all] - Очищает баланс игрока.
/coinmoney reload - Перезагружает конфигурацию плагина.
/coinmoney migrate yaml-to-sql - Переносит все балансы игроков из YAML-хранилища в SQL.
/coinmoney migrate sql-to-yaml - Экспортирует все балансы из SQL обратно в YAML.
/coinmoney clean-sql - Удаляет устаревшие валютные столбцы из SQL-базы данных.
🔐 Права (Permissions)
coinmoney.admin — полный доступ
coinmoney.command.balance
coinmoney.command.pay
coinmoney.command.add
coinmoney.command.set
coinmoney.command.take
coinmoney.command.clear
coinmoney.command.reload
coinmoney.command.migrate
🧩 PlaceholderAPI
1. %coinmoney_<currency>_balance% - показывает баланс игрока в конкретной валюте, с форматированием.Примеры:
%coinmoney_copper_balance% -> "25 Медь"
%coinmoney_silver_balance% -> "3 Серебро"
%coinmoney_gold_balance% -> "1 Золото"
%coinmoney_platinum_balance% -> "0 Платина"
2. %coinmoney_all_balance% - выводит баланс игрока по всем валютам в настраиваемом порядке.
Пример (если у игрока 1 gold, 0 silver, 20 copper):
%coinmoney_all_balance% -> "0 Платина 1 Золото 0 Серебро 20 Медь"
3. %coinmoney_balance% - выводит баланс игрока только по валютам, где баланс > 0, в настраиваемом порядке.
Пример (если у игрока 1 gold, 0 silver, 20 copper):
%coinmoney_balance% -> "1 Золото 20 Медь"
Если всё по нулям:
%coinmoney_balance% -> "0 Медь"
4. %coinmoney_convert_balance% - считает весь баланс игрока во всех валютах и переводит в base-currency (из config.yml), затем выводит как одну сумму.
Пример (base-currency = copper, у игрока 1 gold = 100 copper):
%coinmoney_convert_balance% -> "100 Медь"
Это удобно как “реальные деньги”, которые видит Vault.
5. %coinmoney_<число>% - воспринимает это число как сумму в base-currency и красиво конвертирует в набор валют (нормализует), чтобы отображать цену без “мусорных нулей”.
Примеры (base-currency = copper, 10 copper = 1 silver, 10 silver = 1 gold):
%coinmoney_10% -> "1 Серебро"
%coinmoney_25% -> "2 Серебро 5 Медь"
%coinmoney_100% -> "1 Золото"
%coinmoney_0% -> "0 Медь"
Как это использовать для магазинов / GUI
Если у тебя в магазине цена “100$”, ты можешь:- стоимость оставить числом 100 (в базе/конфиге магазина)
- а в отображении (lore/название) поставить:
И игрок увидит не “100 copper”, а красивый вид типа “1 gold” (в зависимости от иерархии).
🛠 Мини-гайд по настройке
- Установите плагин и запустите сервер
- Настройте config.yml (base-currency, порядок валют)
- Отредактируйте файлы валют (copper.yml, silver.yml и т.д.)
- При необходимости настройте предметы-валюты
- Выполните /coinmoney reload
- Используйте CoinMoney в магазинах через Vault
🔮 Будущие обновления
Плагин активно развивается. В планах:• топы балансов (общие и по валютам)
• расширенные PlaceholderAPI-обёртки
• контекстные плейсхолдеры (TAB / GUI / профили)
• отдельные команды для валют (/gold add, /silver balance)
• GUI-магазин
• генерация ресурс-пака для валют с моделями, текстурами, звуками и тд.
• инструменты отладки предметов-валют
• aliases для валют
• улучшенная система кастомных валют
• голограмма над предметом валюты с отображением количества
• команды для создания, удаления и настройки монет прямо в игре
🤝 Помощь в развитии
Если вы нашли баг или хотите предложить идею — пожалуйста, сообщите об этом.Обратная связь напрямую влияет на развитие и качество плагина.
