Server Market

Server Market — это серверный мод для Fabric, который приносит на ваш сервер полноценную экономику и торговую площадку, управляемую игроками. Игроки могут проверять баланс, переводить деньги другим (даже офлайн-игрокам) и просматривать историю транзакций — всё через простые команды или интуитивный GUI. Мод включает как игровой рынок, так и системный магазин, где предметы можно выставлять, покупать и продавать с полной поддержкой вариантов NBT. Также поддерживаются заказы на покупку с доставкой через посылочную станцию, так что покупатели могут оставлять запросы, а продавцы — выполнять их без личной встречи. Администраторы могут по желанию вводить физические предметы-валюту, настраивать цены системного магазина, управлять балансами игроков напрямую и конфигурировать экономику под свои нужды. По умолчанию хранилище — SQLite для работы без настройки, но его можно переключить на MySQL с опциональным зеркалированием записей XConomy для сред с общей базой данных. Для владельцев серверов на 1.21.9 или новее мод включает поддержку Placeholder API из коробки. Разработчики могут подключаться к открытому API и системе событий, чтобы запрашивать балансы, обрабатывать переводы, перехватывать покупки или интегрировать экономику в свои моды.

Требования

Обязательные:

• Fabric API (версия под вашу версию MC)
• Fabric Language Kotlin 1.13.8+kotlin.2.3.0
• Fabric Permissions API 0.5.0

Опциональные:

• LuckPerms (рекомендуется) для управления правами
• Placeholder API (только JAR для 1.21.9+)

Команды

Игрок:

/svm
/svm menu

/svm money
/svm balance
/svm pay <player> <amount>
/svm history [page]

/svm sell <price>
/svm restock <quantity>
/svm pull

/svm list
/svm search <keyword>

/svm buy <quantity> <item> [seller]

/svm cash <value> <quantity>
/svm exchange <amount>

/svm order <price> <amount>
/svm supply <quantity>

Админ:

/svm admin balance <player>
/svm admin set <player> <amount>
/svm admin add <player> <amount>
/svm admin remove <player> <amount>
/svm admin rank
/svm admin history <player> [page]

/svm admin price <price> [limit]
/svm admin pull
/svm admin purchase <price> [limit]

/svm admin cash <value>
/svm admin cash get
/svm admin cash del
/svm admin cash list [item]

/svm admin reload

Обновления

• Обновлены формулировки команд:

  • заказ на покупку: /svm purchase -> /svm order
  • продажа покупателю: /svm selltopurchase -> /svm supply
• Удалена группа команд: /svm edit (админ-команды теперь под /svm admin).
• Устарело: /svm admin lang

Placeholder API

Доступно в JAR только для 1.21.9+ при установленном Placeholder API:

• %server-market:balance%
• %server-market:balance_short%
• %server-market:parcel_count%
• %server-market:player_name%
• `%server-market:top_name:%` (ранг 1–10)
• `%server-market:top_balance:%` (ранг 1–10)
• `%server-market:top_balance_short:%` (ранг 1–10)

API для интеграции

Точка входа: asagiribeta.serverMarket.api.ServerMarketApiProvider

• getBalance, hasEnough, getParcelCount
• addBalance, withdraw, setBalance, transfer
• getTopBalances, getHistory, format, openMenu, getModVersion

EconomyProvider (в стиле Vault): asagiribeta.serverMarket.api.economy.EconomyProviderRegistry

• withdraw, format

События:

• ServerMarketEvents.BALANCE_CHANGED
• ServerMarketEvents.PRE_PURCHASE (верните false для отмены)
• ServerMarketEvents.POST_PURCHASE

Конфигурация / Хранилище

Файл конфигурации: config/server-market/config.properties

Перезагрузка в игре: /svm admin reload

Экономика

Хранилище (SQLite — по умолчанию)

Хранилище (MySQL / XConomy)

Установите storage_type=mysql и настройте mysql_host, mysql_port, mysql_database, mysql_user, mysql_password, mysql_use_ssl, mysql_jdbc_params.

Имена таблиц XConomy (при использовании существующей базы данных):

Установите xconomy_write_record=true, чтобы дублировать транзакции в таблицу записей XConomy (только MySQL).

Отладка