Gemengine

Плагин Gemengine для Minecraft — управление несколькими валютами на сервере

GemEngine — это плагин для серверов Minecraft, предоставляющий гибкую многовалютную систему. Он позволяет администраторам управлять несколькими независимыми валютами для каждого игрока. Балансы доступны через команды и PlaceholderAPI. Плагин автоматически интегрируется с Vault для работы с другими экономическими системами.

📦 Описание и возможности

GemEngine — это плагин для серверов Minecraft на загрузчиках Paper и Spigot, который реализует гибкую многовалютную экономическую систему. Главное отличие от стандартных решений — возможность управлять несколькими независимыми валютами для каждого игрока одновременно. Администратор может настраивать разные типы средств (например, «Гемы» и «Монеты») с индивидуальными правилами: можно разрешить или запретить переводы между игроками для каждой валюты отдельно. Балансы доступны для использования через команды консоли и интегрируются с PlaceholderAPI для отображения в чате, названиях предметов или на вывесках.

📂 Структура файлов

Плагин использует два основных файла конфигурации. Файл config.yml отвечает за настройку валют: здесь администратор определяет названия, разрешает ли переводы (allow-pay) и настраивает параметры каждой экономической системы. Файл data.yml в ранних версиях хранил балансы игроков в формате ключ-значение, но начиная с версии 4.0.0 и выше хранение данных в файле было заменено на использование базы данных SQLite. Файл data.yml больше не используется для сохранения информации.

💬 Команды управления

Плагин предоставляет команды для управления балансами и пересылки средств. Команда `/gpay <ключ_валюты> <игрок> <сумма>` позволяет игроку перевести определенную сумму выбранной валюты другому игроку. Для выполнения перевода у отправителя должен быть достаточный баланс, а настройка `allow-pay` для данной валюты в конфиге должна быть включена (`true`). Команда `/gemengine eco` предназначена для администраторов и позволяет вручную управлять балансами игроков. Доступна команда `set` (установка баланса), `add` (добавление средств) и `remove` (удаление средств). Примеры использования команд:

🔑 Права доступа

📊 Переменные PlaceholderAPI

Для интеграции с PlaceholderAPI используются переменные вида %gemengine_ %, где соответствует ключу, указанному в файле config.yml. Значения переменных всегда возвращаются с двумя знаками после запятой (например, 150.00). Примеры переменных:

🔗 Интеграция с Vault

При наличии Vault и экономической системы (например, EssentialsX) плагин автоматически определяет её при запуске сервера. В консоли появится сообщение о обнаружении экономики, а в файл config.yml будет добавлена запись с ключом essentials_economy. По умолчанию параметр allow-pay для автоматически добавленных экономик через Vault устанавливается в false, чтобы предотвратить случайные переводы средств между игроками. Это значение можно изменить вручную в конфиге.

Автор: Liquit13 · Лицензия: MIT