Ark:Донат-Магазин/Кастомные предметы

Кастомные предметы
<< Ark:Донат-Магазин | К концу статьи | Предыдущая глава: Система быстрой кастомизация товаров (Аффиксы) | Короткая ссылка

Кастомные предметы - это определяемые на уровне настроек конкретного сервера предметы, наборы или команды. С помощью них можно добавить на сервер любой предмет, присутствующий в моде или специализированную команду. С помощью кастомных предметов в магазине можно добавить уникальные товары, характерные для вашего хостинга или предметы с модов.

Каждый кастомный предмет должен иметь уникальное название, по которому он будет связан с товаром в панели магазина. При этом содержимое товара, которое нужно ввести в панели, не имеет особого значения - оно может быть любым (например стак соломы). При получении товара на сервере оно будет автоматически заменено командами, которые вы прописали для кастомного предмета.

 Если кастомный предмет не сработал (например поврежден конфиг-файл), то будет выдан предмет, прописанный в панели магазина

 Название кастомного предмета должно на 100% совпадать с названием соответствующего ему товара в панели магазина

Кастомные предметы прописываются в JSON-файле custom.json (или прямо в config.json, в соответствующем методе):

Пример:

{
 "Металлический слиток": {
   "type": "item",
   "stackSize": 200,
   "count": 400,
   "quality": 1,
   "blueprint": "Blueprint'/Game/PrimalEarth/CoreBlueprints/Resources/PrimalItemResource_MetalIngot.PrimalItemResource_MetalIngot'"
 },
 "Чертёж ТЕК-винтовки": {
   "type": "blueprint",
   "quality": 10,
   "blueprint": "Blueprint'/Game/PrimalEarth/CoreBlueprints/Weapons/PrimalItem_TekRifle.PrimalItem_TekRifle'"
 }
}

В данном примере определено 2 предмета - "Металлический слиток" и "Чертёж ТЕК-винтовки".

Виды предметов

Предмет	Пример конфигурации
Прокачка персонажа или дино Выдает опыт выжившему или (если сидит верхом) - дино.	"Прокачка персонажа или дино": { "type": "experience", "amount": 1000000000 } amount - количество выдаваемого опыта
Товар-услуга Любая услуга, на которую нет автоматической команды. Реализуется через отправку сообщения в специальный чат админу.	"Вытащить забаганного дино": { "type": "message", "webHook": "hook1", "webHookMessage": "Сервер %serverInfo%, %playerInfo% попросил вытащить забаганного дино.", "message": "Сообщение отправлено администратору, ожидайте. Если вдруг администратор не пришел - напишите в чат-группу сервера" } webHook - название вебхука webHookMessage - сообщение для администратора. Поддерживаются слова-заменители: %serverInfo% - название сервера %playerInfo% - steamId, steam-ник, имя выжившего и трайб игрока %characterName% - имя выжившего %steamName% - steam-ник %tribeName% - трайб %steamId% - steam-ID %title% - название товара message - сообщение для игрока (в игровой чат)
Summon-команда Аналогично admincheat summon.	"Белый луч": { "type": "summon", "className": "SupplyCrate_Level03_C" } className - класс вызываемого предмета, см. [1]
Предмет Аналогично admincheat summon.	"Металлический слиток": { "type": "item", "stackSize": 200, "count": 400, "quality": 1, "blueprint": "Blueprint'/Game/PrimalEarth/CoreBlueprints/Resources/PrimalItemResource_MetalIngot.PrimalItemResource_MetalIngot'" } stackSize - размер стака, по умолчанию 1 count - сколько предметов выдать (обязательный параметр) quality - качество (если предмет его поддерживает) blueprint - блюпринт предмета (обязательный параметр)
Чертеж Выдача чертежа предмета.	"Чертёж ТЕК-винтовки": { "type": "blueprint", "quality": 10, "blueprint": "Blueprint'/Game/PrimalEarth/CoreBlueprints/Weapons/PrimalItem_TekRifle.PrimalItem_TekRifle'" } quality - качество чертежа blueprint - блюпринт предмета (обязательный параметр)
Энграмма Выдача чертежа предмета.	"Энграмма ТЕК-винтовки": { "type": "engram", "blueprint": "Blueprint'/Game/PrimalEarth/CoreBlueprints/Weapons/PrimalItem_TekRifle.PrimalItem_TekRifle'" } blueprint - блюпринт предмета (обязательный параметр)
Динозавр Выдача существа.	"Тек-раптор: { "type": "dino", "level": 400, "neutered": true, "gender": 1, "imprint": true, "experience": 5000, "age": 1.0, "wild": false, "blueprint": "Blueprint'/Game/PrimalEarth/Dinos/Raptor/BionicRaptor_Character_BP.BionicRaptor_Character_BP'", "dcMinutes": 0, "dcHours": 2, "dcDays": 0, "dcInfinite": false } level - уровень выдаваемого существа, обязательный параметр neutered - кастрирован или нет (если не указан - то в соответствии с настройками плагина) gender - пол, 1 - М, 2 - Ж imprint - привязать существо (да или нет) experience - стартовый опыт age - возраст (от 0 до 1), 0 выдаст детеныша, 1 - взрослая особь wild - заспавнить дикого blueprint - блюпринт динозавра (обязательный параметр) Право покраски только что выданного дино (команда /красить или /sdc): dcMinutes - на сколько минут dcHours - на сколько часов dcDays - на сколько дней dcInfinite - бессрочно (true/false)  Обязателен только уровень и блюпринт, остальные параметры можно не указывать - тогда у них будет значение по умолчанию
Набор предметов Выдача набора из нескольких предметов. Можно комбинировать предметы разного типа. Количество предметов в наборе не ограничено.	"ТЕК-винтовка + энграмма для использования": { "type": "pack", "items": { { "type": "engram", "blueprint": "Blueprint'/Game/PrimalEarth/CoreBlueprints/Weapons/PrimalItem_TekRifle.PrimalItem_TekRifle'" }, { "type": "item", "count": 1, "quality": 3, "blueprint": "Blueprint'/Game/PrimalEarth/CoreBlueprints/Weapons/PrimalItem_TekRifle.PrimalItem_TekRifle'" } } }
Право покраски дино Выдача права на покраску любого дружественного дино на этом сервере	"Право покраски дино": { "type": "dinocolor", "minutes": 0, "hours": 0, "days": 3, "infinite": false } minutes - на сколько минут hours - на сколько часов days - на сколько дней infinite - бессрочно (true/false)
Пермишены Интеграция с плагином Ark Permissions. Добавить или удалить игрока из группы.	"Добавление в группу Premium": { "type": "permissions", "do": "add", "group": "Premium" }, "Добавление в группу Premium на 3 дня": { "type": "permissions", "do": "add", "group": "Premium", "minutes": 0, "hours": 0, "days": 3, "endMessage": "Время Премиум истекло" } do - действие (add или remove) group - название группы minutes - на сколько минут hours - на сколько часов days - на сколько дней endMessage - это сообщение будет отображено игроку по окончанию времени  если игрок оффлайн - то endMessage будет ему отображено при следующем появлении на сервере  Перед тем как использовать этот тип товара, не забудьте добавить все необходимые группы на сервер
PlayerCommand Запуск игровой команды. Поддерживается с версии 2.8.	"Вознесение Бета": { "type": "playercommand", "command": "Ascend2" }, "Роквелл-Вознесение Альфа (Aberration)": { "type": "playercommand", "command": "AbAscend3" } command - текст команды, типичные значения для Ark: Ascend1, Ascend2, Ascend3 - вознесения Tek Cave AbAscend1, AbAscend2, AbAscend3 - вознесения Абберации EXTAscend1, EXTAscend2, EXTAscend3 - вознесения Extinction
Чит Запуск чит-команды от игрока. Поддерживается с версии 2.8.	"Выдать все краски x5": { "type": "cheat", "command": "GiveColors 5" }, "Самоубийство": { "type": "cheat", "command": "hurtme 10000000" }, "Отрастить волосы": { "type": "cheat", "command": "SetHeadHairPercent 100" }, "Затамить выбранного дино": { "type": "cheat", "command": "DoTame" } command - текст команды. Поддерживаются слова-заменители: %characterName% - имя выжившего %steamName% - steam-ник %tribeName% - имя трайба %steamId% - steam-Id %playerId% - player-Id  Стабильная работа чит-команд не гарантируется! Например, если для товара "Затамить выбранного дино" не нацелиться на дино, то ничего не произойдет, но выдача будет засчитана. Этот чит исключительно опасен на PvP, так как можно целить рейдовых дино. Имейте в виду, что разработчики игры в любой момент могут выключить те или иные читы, и разработчики магазина ничего не смогут с этим поделать. Используйте чит-команды на свой страх и риск, всегда их тестируйте и продумывайте все варианты их активации игроками.

Примеры

• Пример custom.json
• Пример custom.json (все виды товаров)

Ссылки

• Заказать сервер игры ARK Survival Evolved
• Обсудить ARK Survival Evolved в чате

---

Далее: Вебхуки

<< Ark:Донат-Магазин | К началу статьи