Rust Kits

Rust Kits — Наборы предметов, автокиты, перезарядка комплектов и многое другое

Разрешите вашим игрокам выкупать готовые наборы предметов

Характеристики

• Простое в использовании меню пользовательского интерфейса для создания и утверждения наборов
• Установите ограничения на использование с максимальным количеством использований, перезарядкой и стоимостью покупки
• Создавайте VIP-наборы, для которых требуются пользовательские разрешения
• Создайте наборы администраторов, использующие систему Rusts auth-level system
• Назначайте автоматические наборы после смерти, указав список наборов в конфигурации и используя систему приоритетов
• Работает с HumanNPC, чтобы иметь наборы, доступные только при взаимодействии с NPC
• Поддерживает CopyPaste, позволяя наборам наклеивать предварительно созданные структуры.
• Настройте цветовую схему пользовательского интерфейса в конфигурации

Разрешения Rust Kits

Этот плагин использует систему разрешений. Чтобы назначить разрешение, используйте 

oxide.grant <user or group> <name or steam id> <permission>. Чтобы удалить разрешение, используйте 

oxide.revoke <user or group> <name or steam id> <permission>.

• kits.admin Игроки с этим разрешением могут использовать функциональность команды администратора

Команды Rust Kits

Этот плагин предоставляет команды для чата и консоли с использованием одного и того же синтаксиса. При использовании команды в чате добавьте к ней косую черту: `/`.

Команды чата игрока

• /kit Открывает меню набора
• /kit <name> Используется игроком для получения указанного комплекта
• /kit autokit Позволяет игроку выбирать, получать ли наборы при появлении. Эта опция должна быть включена в конфигурации

Команды Чата администратора

• /kit help Показать меню справки со всеми доступными командами
• /kit list Показать полный список названий комплектов
• /kit add/kit new Начните создавать новый комплект
• /kit edit <kitname> Начните редактировать ранее созданный набор
• /kit remove <kitname>/kit delete <name> Удалить указанный комплект
• /kit give <player name | player id> <kitname> Предоставьте указанному игроку указанный комплект
• /kit givenpc <kitname> Передайте указанный комплект NPC, на которого вы в данный момент смотрите
• /kit reset Сбросьте все данные об использовании комплекта плеера
• /kit resetuses <player name | player id> <kitname> Сбросьте настройки использования указанного комплекта и плеера

Команды консоли администратора

• kit list Перечислите все комплекты
• kit remove <kitname>kit delete <kitname> Удалить указанный комплект
• kit give <player name | player id> <kitname> Предоставьте указанному игроку указанный комплект
• kit reset Сбросьте все данные об использовании комплекта плеера
• kit resetuses <player name | player id> <kitname> Сбросьте настройки использования указанного комплекта и плеера

Как создавать наборы

Прежде чем начать, очистите свой инвентарь и используйте меню администратора, чтобы добавить в набор все нужные вам предметы.

После этого введите в чате «/kit new» или нажмите кнопку «Создать новый» в правом верхнем углу интерфейса.

Вам будет представлен следующий экран

Все параметры набора находятся слева, а вид предмета — справа.

Для начала нажмите кнопку «Копировать из инвентаря» в правом нижнем углу. Это добавит все предметы из вашего инвентаря в набор.

Затем вы можете перейти к заполнению информации с левой стороны.

Детали комплекта

• Name это название набора
• Description является описанием комплекта. Этот параметр не является обязательным
• Icon URL Это URL-адрес изображения набора, отображаемого в сетке пользовательского интерфейса. Это необязательный параметр

Полномочия по использованию

• Permission используется для ограничения использования этого набора только игроками с указанным разрешением. Разрешение должно начинаться с ‘kits.’ (например, ‘kits.awesomekit’).
• Auth Level используется для ограничения использования этого набора игроками с уровнем авторизации не ниже указанного (0 — игрок, 1 — модератор, 2 — администратор)
• Is Hidden Это поле для переключения. Если оно включено, этот набор не будет отображаться в сетке наборов для обычных игроков

Сведения об использовании

• Maximum Uses используется для указания максимального количества раз, которое игрок может использовать этот набор за цикл уничтожения
• Cooldown Это количество секунд, которое игрок должен подождать, прежде чем сможет снова воспользоваться этим набором
• Purchase Cost используется для того, чтобы заставить игроков заплатить за получение набора. Тип валюты определяется в конфигурации

Поддержка КопиПасты

• File Name это имя файла, который нужно скопировать. Если оно указано, то при использовании игроком этого набора будет предпринята попытка создать указанный файл для копирования

Когда вы закончите, нажмите кнопку «Сохранить набор» в левом нижнем углу экрана, чтобы сохранить набор

Автокиты

Автокомплекты — это наборы, которые выдаются игроку после возрождения после смерти.

Какие наборы включены, указывается в файле конфигурации в разделе «Наборы, упорядоченные по приоритету» с помощью названия наборов

Плагин будет перебирать каждый набор, указанный в конфигурации, пока не сможет выдать один из них игроку.

Эти автоматические наборы подчиняются тем же правилам активации, что и при активации вручную, поэтому на них распространяются такие условия, как Maximum Uses и Cooldown

Вот пример форматирования, используемого в конфигурации

"Autokits ordered by priority": [
  "example1",
  "example2",
  "example3"
],

Наборы NPC

Плагин поддерживает получение комплектов через поставщиков NPC из плагина HumanNPC.

Для каждого NPC можно настроить разные наборы, и когда игрок взаимодействует с NPC, ему отображается меню наборов, указанных в конфигурации

Пример в конфигурации показывает, как это настроить.

Вы можете указать, какие наборы доступны через NPC, и получить ответ в чате при взаимодействии с ними

Первый параметр — это идентификатор пользователя NPC

"Kit menu items when opened via HumanNPC (NPC user ID | Items)": {
  "0": {
    "The list of kits that can be claimed from this NPC": [
      "ExampleKitName",
      "OtherKitName"
    ],
    "The NPC's response to opening their kit menu": "Welcome to this server! Here are some free kits you can claim"
  },
  "1111": {
    "The list of kits that can be claimed from this NPC": [
      "ExampleKitName",
      "OtherKitName"
    ],
    "The NPC's response to opening their kit menu": "Welcome to this server! Here are some free kits you can claim"
  }
},

Протоколирование комплекта

В конфигурации есть опция «Записывать выданные наборы». Когда игрок использует набор, он записывается в /oxide/log/Kits/Kits_Received

Конфигурация

Настройки и параметры можно изменить в файле 

Kits в каталоге 

config. Рекомендуется использовать редактор и валидатор, чтобы избежать проблем с форматированием и синтаксическими ошибками.

{
  "Kit chat command": "kit",
  "Currency used for purchase costs (Scrap, Economics, ServerRewards)": "Scrap",
  "Log kits given": false,
  "Wipe player data when the server is wiped": false,
  "Use the Kits UI menu": true,
  "Allow players to toggle auto-kits on spawn": false,
  "Show kits with permissions assigned to players without the permission": false,
  "Players with the admin permission ignore usage restrictions": false,
  "Autokits ordered by priority": [
    "ExampleKitName",
    "OtherKitName"
  ],
  "Post wipe cooldowns (kit name | seconds)": {
    "ExampleKitName": 3600,
    "OtherKitName": 600
  },
  "Parameters used when pasting a building via CopyPaste": [
    "deployables",
    "true",
    "inventories",
    "true"
  ],
  "UI Options": {
    "Panel Color": {
      "Hex": "#232323",
      "Alpha": 1.0
    },
    "Disabled Color": {
      "Hex": "#3e3e42",
      "Alpha": 1.0
    },
    "Color 1": {
      "Hex": "#007acc",
      "Alpha": 1.0
    },
    "Color 2": {
      "Hex": "#6a8b38",
      "Alpha": 1.0
    },
    "Color 3": {
      "Hex": "#d85540",
      "Alpha": 1.0
    },
    "Color 4": {
      "Hex": "#d08822",
      "Alpha": 1.0
    },
    "Default kit image URL": "https://chaoscode.io/oxide/Images/kiticon.png",
    "View kit icon URL": "https://chaoscode.io/oxide/Images/magnifyingglass.png"
  },
  "Kit menu items when opened via HumanNPC (NPC user ID | Items)": {
    "0": {
      "The list of kits that can be claimed from this NPC": [
        "ExampleKitName",
        "OtherKitName"
      ],
      "The NPC's response to opening their kit menu": "Welcome to this server! Here are some free kits you can claim"
    },
    "1111": {
      "The list of kits that can be claimed from this NPC": [
        "ExampleKitName",
        "OtherKitName"
      ],
      "The NPC's response to opening their kit menu": "Welcome to this server! Here are some free kits you can claim"
    }
  },
  "Version": {
    "Major": 4,
    "Minor": 0,
    "Patch": 15
  }
}

Для разработчиков

Крючки

// Return any non-null value to abort redeeming of kit.
// Player notification as to why it was aborted should be handled
// from the plugin that is cancelling it
object CanRedeemKit( BasePlayer player )

// Return any non-null value to abort redeeming of a auto kit.
object CanRedeemAutoKit( BasePlayer player )

// Called when a player claims a kit
void OnKitRedeemed(BasePlayer player, string kitName)

API

// Give a kit to the target player.
// Returns a (string) message if unsuccessful, or (bool) true if successful
object GiveKit(BasePlayer player, string name)

// Returns true if the specified kit exists, otherwise returns false
bool IsKit(string name)

// Add all available kit names to the provided list
void GetKitNames(List<string> list)

// Returns the kit image URL if specified in the kit data
// else returns a empty string
string GetKitImage(string name)

// Returns the kit description if specified in the kit data
// else returns a empty string
string GetKitDescription(string name)

// Returns the kit maximum uses per player if specified in the kit data
// else returns 0
int GetKitMaxUses(string name)

// Returns the kit cooldown time (seconds) if specified in the kit data
// else returns 0
int GetKitCooldown(string name)

// Returns the number of time the specified player has used the specified kit
int GetPlayerKitUses(ulong playerId, string name)

// Allows you to set the specified players number of uses of the specified kit
void SetPlayerKitUses(ulong playerId, string name, int amount)

// Returns the remaining cooldown time (seconds) of the
// specified kit for the specified player
double GetPlayerKitCooldown(ulong playerId, string name)

// Allows you to set the remaining cooldown time of the specified kit
// for the specified player
void SetPlayerCooldown(ulong playerId, string name, double seconds)

// Returns a JObject of the kits data.
// Look at the implementation in the plugin to see the data structure
JObject GetKitObject(string name)

// Returns an enumerator that creates the items in the specified kit
IEnumerable<Item> CreateKitItems(string name)

Дополнительные плагины для игры Rust можно найти в разделе: Rust плагины

Скачать, а также страница плагина на английском Rust Kits