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

Материал из SurvivalHost Wiki
Перейти к навигации Перейти к поиску

Кастомные предметы
<< 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 будет ему отображено при следующем появлении на сервере
 Перед тем как использовать этот тип товара, не забудьте добавить все необходимые группы на сервер

Примеры

Ссылки


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

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

Источник — https://survivalhost.wiki/index.php?title=Ark:Донат-Магазин/Кастомные_предметы&oldid=1072