Aurelium
Важно: веб-функции на стадии разработки Веб-панель ещё допиливается. Если включите
web.enabled, возможны баги. А вот основные механики - рынок, аукцион - уже стабильны и готовы к использованию.
Aurelium - это самостоятельный экономический плагин для Minecraft Paper, который закрывает все базовые потребности серверной экономики. Вам больше не нужно ставить кучу мелких плагинов - всё в одном.
Совместимость: Paper, Purpur, Pufferfish, Leaves
Что даёт Aurelium
На любом сервере рано или поздно встаёт вопрос: как сделать торговлю между игроками удобной и честной? Ванильный Minecraft вообще не предлагает нормальной экономики. Aurelium решает это сразу: своя валюта, динамический серверный рынок, аукцион для игроков, система заявок на покупку и веб-панель для торговли через браузер. Всё красиво, быстро и без лишних заморочек.
Экономика
- Несколько валют - заводите Aurels, Dollars, Euro - что угодно, с уникальными символами и стартовыми балансами
- Привязка валюты к предметам - для каждого товара на рынке можно указать свою валюту
- Vault - полная поддержка плагинов вроде ShopGUI+ и Essentials
- База данных - SQLite или MySQL с автоматической миграцией
- Офлайн-доход - продажи на аукционе приносят деньги, даже когда игрок не в сети
Серверный рынок
Магазин, которым управляет сервер. Цены плавают в зависимости от спроса и предложения. Три режима интерфейса:
- Classic - обычный сундук
- Modern - стилизованный GUI с градиентами, рамками из стекла и форматированным описанием
- Web - браузерная панель (см. ниже)
Как работают цены:
- Покупаете чаще - цена растёт (спрос), продаёте - падает (предложение)
- Защита от накруток: цена продажи никогда не превышает цену покупки
- Минимальный порог: не ниже 20% от базы (настраивается)
- Потолок: не выше 500% от базы
- Каждые 10 минут цены немного возвращаются к базовым
Удобства:
- Интерфейс обновляется каждую секунду
- Книжки-индикаторы: "Страница 1 из 5"
- Кнопка поиска по компасу
- Оповещения о резком падении цен на дорогие вещи
- Умное пополнение: сначала заполняются неполные стаки
Производительность:
- Логика работает, только если игрок открыл меню
- Данные сохраняются в фоне пачками
- Кеш с быстрым доступом почти не грузит CPU
- Каталог огромный: все блоки + более 60 моб-спавнеров
Аукцион
Полноценный аукционный дом для игроков:
- Всё через GUI: продать, сделать ставку, отправить приватное предложение
- Подтверждение перед списанием денег
- Управление предложениями:
/ah offers- принять или отклонить - Живые обновления: изменения видны всем мгновенно, таймеры тикают каждую секунду
- Возврат денег при перебивании ставки
Заявки на покупку (Buy Orders)
Глобальная система запросов:
- Запросите любой предмет (включая 120+ зачарованных книг и слитки) по своей цене
- Другие игроки видят заявки и выполняют их из своего инвентаря
- Escrow-система: деньги держатся в безопасности, возвращаются при отмене
- Забрать выполненный заказ можно через
/ah collect, придёт уведомление при входе - Уведомления о выполнении - в реальном времени или при следующем входе
Обнаружение кастомных предметов
Aurelium сам находит предметы из популярных плагинов:
- Автоскан при старте - один раз, находит всё
- Поддерживаемые плагины (без жёстких зависимостей, через reflection): ItemsAdder, Oraxen, MMOItems, MythicMobs, ExecutableItems, Nexo, SX-Item
- Найденные предметы прописываются в
config.ymlв разделdiscovered-items:и сохраняются в таблицеcustom_items(схема v2, миграция автоматическая) - Если ни один из плагинов не установлен - сканер просто ничего не делает, без лишней нагрузки
Веб-панель
Современный адаптивный веб-интерфейс с почти 100% аптаймом:
- Покупка предметов с рынка - моментальная доставка в игру
- Ставки и выкуп лотов с аукциона
- Выполнение заявок на покупку из инвентаря
- График цен с историей за 7 дней: кривые Безье, градиенты, подсказки
Особенности:
- Живая синхронизация - изменения в игре сразу видны в браузере и наоборот
- Цены записываются каждые 10 минут, хранятся 7 дней
- Опциональный облачный хостинг через Render
- Поддержка нескольких валют (символы из
config.yml) - Запасные иконки для старых версий Minecraft
- Безопасные сессии:
/webгенерирует временную ссылку (на 1 час бездействия) - Энергосбережение: когда вкладка неактивна - ноль нагрузки, мгновенное пробуждение
- Память: меньше 1 МБ на сервер благодаря кешу сырых JSON строк
- Очередь активации при достижении лимита облачного сервера (500 МБ)
Команды
Игроки
| Команда | Описание | Право доступа |
|---|---|---|
/bal [игрок] [валюта] | Проверить баланс (свой или другого игрока) | aureleconomy.bal |
/pay <игрок> <сумма> [валюта] | Перевести деньги | aureleconomy.pay |
/market | Открыть серверный рынок | aureleconomy.market |
/sell | Продать предметы из инвентаря | aureleconomy.sell |
/stocks | Посмотреть тренды рынка | aureleconomy.stocks |
/web | Получить ссылку на веб-панель | aureleconomy.web |
/ah | Открыть аукцион | aureleconomy.ah |
/ah sell <цена> [длительность] [валюта] | Выставить предмет на продажу (BIN). Длительность: например, 1h, 7d | aureleconomy.ah |
/ah bid <цена> [длительность] | Выставить предмет на аукцион | aureleconomy.ah |
/ah offer <id> <количество> | Отправить приватное предложение по лоту | aureleconomy.ah |
/ah offers | Управлять входящими предложениями | aureleconomy.ah |
/ah collect | Забрать просроченные/купленные предметы | aureleconomy.ah |
/ah search <запрос> | Открыть фильтр аукциона | aureleconomy.ah |
/orders | Открыть меню заявок на покупку | aureleconomy.orders |
/orders create <предмет> <количество> <цена> [валюта] | Создать заявку | aureleconomy.orders |
/orders fill <id> [количество] | Выполнить заявку из инвентаря | aureleconomy.orders |
/orders cancel <id> | Отменить заявку и получить возврат | aureleconomy.orders |
/orders my | Список активных заявок | aureleconomy.orders |
/orders search <запрос> | Поиск заявок по названию предмета | aureleconomy.orders |
Админы
| Команда | Описание | Право доступа |
|---|---|---|
| `/eco <give | take | set> <игрок> <сумма> [валюта]` |
/customitems scan | Принудительно пересканировать все кастомные предметы | aureleconomy.admin |
/customitems list | Показать все найденные кастомные предметы | aureleconomy.admin |
/customitems info <id> | Информация о конкретном кастомном предмете | aureleconomy.admin |
/customitems reload | Перезагрузить конфиг с диска | aureleconomy.admin |
/customitems toggle <id> | Включить/выключить предмет в рынке | aureleconomy.admin |
/customitems price <id> <покупка> [продажа] | Установить цены для кастомного предмета | aureleconomy.admin |
Права доступа (Permissions)
| Право | Описание | По умолчанию |
|---|---|---|
aureleconomy.bal | Проверка баланса | Все |
aureleconomy.pay | Переводы | Все |
aureleconomy.market | Использование рынка | Все |
aureleconomy.sell | Команда /sell | Все |
aureleconomy.ah | Аукцион | Все |
aureleconomy.orders | Заявки на покупку | Все |
aureleconomy.stocks | Тренды рынка | Все |
aureleconomy.web | Команда /web | Все |
aureleconomy.admin | Админские команды (eco, customitems) | Только OP |
Установка
- Скачайте последнюю версию
Aurelium.jar - Положите в папку
plugins/вашего сервера - Перезапустите сервер
- Если Vault не найден, Aurelium сам установит его при первом запуске
Настройка
База данных
database:
type: sqlite # sqlite или mysql
file: "database.db" # только для SQLite
mysql: # только для MySQL
host: "localhost"
port: 3306
database: "aurelium"
username: "root"
password: "password"
Экономика
economy:
default-currency: "Aurels"
currencies:
Aurels:
symbol: "₳"
starting-balance: 100.0
max-balance: -1 # -1 = безлимит
min-pay-amount: 0.01
Товары рынка
Управляйте ценами напрямую:
market-items:
DIAMOND:
buy: 5000.0 # Цена покупки у сервера
sell: 0.0 # 0.0 = продажа отключена
DIRT:
buy: 1.0
sell: 0.5 # Игроки могут продать за 0.5
BEDROCK:
buy: -1.0 # -1.0 = покупка отключена
Настройки рынка
market:
enabled: true
gui-mode: modern # "classic" или "modern"
dynamic-pricing: true
price-increase-per-buy: 0.001 # +0.1% за покупку
price-decrease-per-sell: 0.001 # -0.1% за продажу
default-sell-ratio: 0.5
price-floor: 0.2 # Не ниже 20% от базы
price-ceiling: 5.0 # Не выше 500% от базы
price-recovery:
enabled: true
rate: 0.01 # 1% от разницы за цикл
interval-minutes: 10
Аукцион
eauction-house:
enabled: true
default-duration: 86400 # 24 часа (в секундах)
max-duration: 604800 # максимум 7 дней
listing-fee-percent: 2.0
sales-tax-percent: 5.0
max-listings-per-player: -1 # -1 = безлимит
min-listing-price: 1.0
Заявки на покупку
buy-orders:
enabled: true
max-active-orders-per-player: 10
min-price-per-piece: 0.1
max-order-value: -1 # -1 = безлимит
creation-fee-percent: 2.0
sales-tax-percent: 5.0
Веб-панель
web:
enabled: true
port: 8585
# Таймаут сессии: 1 час бездействия (жёстко зашито)
Синхронизация серверов (требуется MySQL)
Aurelium поддерживает кросс-серверную синхронизацию для BungeeCord и Velocity.
Для синхронизации нужен MySQL - SQLite не умеет шарить данные между серверами. Укажите всем серверам одну и ту же базу:
- Глобальные балансы - балансы игроков обновляются при входе на любой сервер сети
- Глобальный аукцион - активные лоты и коллекции доступны на всех серверах
- Локальные рынки - динамические цены хранятся в
config.ymlкаждого сервера, так что экономика может различаться на разных серверах, но кошелёк у игрока один
Язык
При старте создаётся файл messages.yml.
- Переводите - замените любое сообщение на свой язык
- Цвета - используйте MiniMessage (например,
<green>) или старые &-коды
Пара важных моментов
Если команды /market или /eco не работают и пишут "Неизвестная команда" - плагин не загрузился. Проверьте логи, убедитесь что Aurelium.jar лежит в plugins/, и что вы используете Paper (или Purpur, Pufferfish, Leaves). Стандартные игровые команды выданы всем, для админских нужна OP (/op <игрок>) или право aureleconomy.admin.
Скачать плагин Aurelium для Майнкрафт и установить на сервер - дело пары минут. Если вам нужна простая, но мощная экономика без танцев с бубном - присмотритесь к этому плагину. Он перекроет 90% потребностей среднего сервера.