WebShopX (Вебшопикс)

Плагин для серверов Майнкрафт, который объединяет официальный веб-магазин, рынок между игроками и аукционы. Игроки покупают товары, выставляют и ищут предметы, получают заказы в игре, а администрация управляет экономикой и магазином через веб-панель.

Возможности

• Официальный магазин продаёт товары с выдачей предметов, выполнением команд, наложением эффектов, приёмом предметов на переработку и групповыми купонами.
• Для товаров задаются запас, лимит покупок на игрока и расписание публикации.
• Рынок игроков поддерживает продажу, заявки на покупку с удержанием средств, поиск, фильтры, сортировку, теги, налоги, комиссии и ограничения для предметов и валют.
• Контейнеры снабжения могут автоматически пополнять лоты.
• Доступны английский, голландский, викри- и свечной аукционы. В английском аукционе можно продлевать торги при ставке перед завершением; в свечном время окончания случайно выбирается на финальном этапе.
• Для товаров магазина работает динамическая цена: она меняется от покупок и переработки, затем постепенно возвращается к равновесному значению.
• Есть два кошелька — ShopCoin и GameCoin, обмен валют, возвраты, уведомления, история сделок и внутриигровая почта.
• Если игрок не в сети или его инвентарь заполнен, покупка остаётся доступной для получения вручную либо отправляется в почту.
• Веб-панель позволяет управлять товарами, заказами, возвратами, доставкой, рынком, аукционами, пользователями, валютами, комиссиями, объявлениями, языками и темами. Также в ней можно собрать отдельную главную страницу сервера с блоками, материалами и историей изменений.

Команды

Основная команда — /webshopx; короткий вариант — /ws.

• /ws или /ws gui — открыть интерфейс рынка.
• /ws home — показать в чате ссылку на главную страницу сервера.
• /ws password <new_password> — создать или изменить пароль для входа на сайт.
• /ws market sell <price> [amount] [currency] — выставить предмет в руке на продажу.
• /ws market logs [count] — посмотреть недавние сделки.
• /ws claim [all|token] — забрать ожидающие выдачи покупки.
• /ws mailbox — открыть внутриигровую почту.
• /ws mailbox collect — забрать всё из почты.
• /ws reload — перезагрузить конфигурацию и веб-ресурсы.
• /ws recharge fix <orderId> — проверить платёжный сервис и исправить заказ пополнения.
• /ws gamecoin <player> <delta> — изменить баланс GameCoin.
• /ws shopcoin <player> <delta> — изменить баланс ShopCoin.

Права

В панели предусмотрены роли SUPER_ADMIN, SHOP_ADMIN, MARKET_MODERATOR, SUPPORT_ADMIN и AUDITOR. Роли можно дополнять собственными наборами разрешений.

Настройка

Сайт можно развернуть тремя способами:

• встроенный режим: плагин сам отдаёт API и файлы сайта через порт 8819;
• внешний режим: API остаётся у плагина, а файлы сайта размещаются через Nginx, панель хостинга или CDN;
• режим Relay: сервер сам подключается к Relay, поэтому не требуется открывать в интернет порт Майнкрафт или магазина.

Для Relay используются параметры:

webshop:
  server-mode: relay

relay:
  url: ""
  access-key: "wsx_user_xxxxxxxxx"

В сети серверов каждому экземпляру нужен свой server-id.

Требования

Плагин работает на Paper, Purpur, Spigot и Folia; файл плагина должен соответствовать используемому ядру сервера и Java. База данных: SQLite, MySQL или MariaDB. SQLite подходит для одиночного сервера и работает только в режиме standalone; для сети серверов нужны общая MySQL/MariaDB и Redis для синхронизации событий и присутствия игроков.

Vault, WebShopX-Payments и другие платёжные компоненты подключаются при необходимости. Встроены только языки zh-CN и en-US.