Магазин
Товары, наборы, категории и склад покупок
Магазин собирается из товаров (один предмет), китов (набор предметов по общей цене) и категорий (как это разложено на витрине). Всё привязано к серверам. Товар без сервера в магазине не появится.
Товар
E-Commerce → Магазин → Каталог → Создать.
| Поле | Что означает |
|---|---|
| Название, описание, иконка товара | Витрина |
| Цена | В реальной валюте |
| Скидка | Перечёркнутая старая цена рядом с новой |
| Свой процент оплаты бонусами | Личное значение вместо общего из настроек |
| Количество (кратно) | Продавать только по 8, 16, 64 штуки |
| Серверы | Где товар доступен. Можно несколько |
| Категории | Куда попадёт на витрине |
| ID предмета | Игровой идентификатор, например minecraft:diamond_sword |
| NBT-теги | Зачарования, имя, лор |
| Способ выдачи | UnicoreConnect (предмет), UnicoreConnect (команды) или RCON (команды) |
Количество (кратно) нужно для расходников. Если поставить 64, игрок не сможет купить 5 алмазов — только 64, 128 и так далее.
NBT и зачарования
Зачарования удобнее задавать отдельным списком, тогда админка соберёт NBT сама. Ручное поле NBT остаётся для всего остального: имя предмета, лор, кастомная моделька, флаги.
{display:{Name:'{"text":"Меч админа"}'},Unbreakable:1b}NBT зависит от версии
Формат отличается между 1.12, 1.16 и 1.20+. Строку, которая работает на одной сборке, на другой сервер молча проигнорирует. Проверяйте на тестовом сервере, а не на живом магазине.
Способ выдачи
У каждого товара он свой и перекрывает настройку сервера:
| Значение | Что происходит |
|---|---|
| UnicoreConnect (предмет) | Покупка ложится на склад, плагин заберёт её при заходе игрока |
| UnicoreConnect (команды) | То же, но плагин ещё выполнит команды из поля «Команды» |
| RCON (команды) | Сайт сам отправит эти команды в консоль сервера |
Подробности в разделе Выдача покупок.
Киты
Кит — это набор товаров с общей ценой. Берёте уже заведённые товары, каждому задаёте количество, а цену вписываете руками: от суммы она не считается. Обычно её ставят ниже.
У кита свои иконка, описание, скидка и доля оплаты бонусами.
Категории
Плоский список с приоритетом сортировки, иконкой и описанием. Товар может лежать сразу в нескольких категориях, скажем, и в «Оружии», и в «Ивентовом».
Экспорт и импорт
В каталоге есть кнопки экспорта и импорта. Экспорт складывает весь магазин в ZIP-архив вместе с иконками, импорт заливает его обратно. Пригодится в двух случаях:
- Собрать магазин на тестовом сайте и перенести на боевой одним файлом.
- Забэкапить каталог перед большой переделкой.
Импорт добавляет товары, а не заменяет каталог: если залить архив дважды, товары задвоятся.
Склад покупок
Купленный предмет не появляется в инвентаре сразу, сначала он попадает на склад. Дальше всё зависит от способа выдачи: плагин разгружает склад при заходе игрока, RCON отправляет команды сразу.
Склад видит и игрок (в кабинете, с выбором сервера), и админ (в карточке пользователя). Оттуда же позицию можно удалить, если выдали лишнего.
Склад копится, значит связи нет
Если позиции лежат неделями, значит плагин не ходит на сайт или у сервера не настроен RCON. Игрок при этом уверен, что его обманули: деньги списались, предметов нет.
Массовые операции
В таблице каталога можно выделить несколько товаров и разом поменять цену, скидку или набор серверов, либо удалить их. Права на это отдельные: editor.store.products.update.many и editor.store.products.delete.many.
Товары прямо из игры
Плагин на сервере умеет закинуть в каталог предмет прямо из рук админа: игровой ID и NBT приезжают на сайт готовыми, руками останется вписать цену и картинку. Зачарованные сеты так и заводят, потому что вручную такой NBT не наберёшь.