MiniKit

A simple kit management mod designed to power a Hytale Kit PvP (kitpvp) style server with an intuitive kit selector. API available!

123.0 загрузок

Обновлён 12 дней назад

Геймплей Утилиты Улучшение Качества Жизни

Скачать последнюю версию (41.8 КБ)

Описание

Простой мод управления набором, предназначенный для питания сервера в стиле Hytale KitPvP с интуитивно понятным селектором набора

Особенности

Создайте неограниченные пользовательские наборы из вашего текущего инвентаря
Редактировать и удалять наборы с простыми командами
Включить/отключить комплекты без их удаления
Каждый комплект хранит полную планировку инвентаря и предметы (включая горячую панель, хранилище, броню, рюкзак и утилиту!)
Интуитивный пользовательский интерфейс для выбора набора
Гранульный контроль разрешения на комплект
Настраиваемое охлаждение между выбором набора
Переводы

Быстрое начало

Создаем набор:

/minikit создает Воин

Создает новый комплект под названием «Воин» с вашим текущим инвентарем.

Открыть MiniKit GUI:

/minikit

Список всех комплектов:

/minikit список

Показывает все комплекты с их идентификаторами, именами и статусом включенного / отключенного.

Удаление комплекта:

/minikit удалить 3

Удалите комплект с ID 3.

Команды и разрешения

Командование	Узел разрешений	Описание
`/minikit` (или) `/kit`, `Киты`, `/minikits`)	`minikit.use`	Позволяет открыть меню MiniKit GUI для просмотра и выбора наборов
GUI - Select Kit (Любой)	`minikit.select-kit.*`	Позволяет выбрать любой набор из меню GUI
GUI - Select Kit (Конкретный)	`minikit.select-kit.<kit Id>`	Позволяет выбрать конкретный комплект по ID (например, `minikit.select-kit.1`)
Охлаждение Bypass	`minikit.admin.bypass-cooldown`	Обходит таймер выбора набора cooldown
`/minikit create <kitName>`	`minikit.admin.create-kit`	Позволяет создать новый комплект из текущего инвентаря
`Обновление /minikit <kitId>`	`minikit.admin.update-kit`	Позволяет обновлять существующий инвентарь комплекта с текущим инвентарем
`/minikit удалить <kit Id>`	`minikit.admin.delete-kit`	Позволяет удалить существующий комплект по его идентификатору
`/minikitggle <kitId>`	`minikit.admin.toggle-kit`	Позволяет включить или отключить комплект по его идентификатору
`/minikit список`	`minikit.admin.list-kits`	Позволяет перечислять все доступные комплекты с их идентификаторами и статусом

Предоставление базового доступа

Дайте игрокам доступ к использованию наборов:

/perm group add Adventure minikit.use
/perm group add Adventure minikit.select-kit.*

Предоставление специального доступа

Разрешить игроку использовать только определенные наборы (например, идентификаторы наборов 1 и 3).

ПРИМЕЧАНИЕ: Для этого необходимо опустить wildcard.. *) разрешение выше.

/perm group add Adventure minikit.use
/perm group add Adventure minikit.select-kit.1
/perm group add Adventure minikit.select-kit.3

Предоставление доступа Admin

Полный административный контроль:

/perm group add Adventure minikit.use
/perm group add Adventure minikit.select-kit.*
/perm group добавит миникит Adventure. администратор. *

Варианты конфигурации

MiniKit автоматически создает конфигурационный файл при первом запуске. Вы можете найти его на своем сервере mods/com.jecsham_MiniKit/Config.json Файл.

настройка	по умолчанию	Описание
`Выберите KitCooldownSecs`	`5`	Количество секунд игроки должны ждать между выбором наборов
`HideKitIfNoРазрешение`	`ложный`	Если `истинный`Комплекты будут скрыты от игроков, у которых нет разрешения на их использование. Если `ложный`Наборы показаны, но не могут быть выбраны.
`CheckInventoryКонфликты`	`ложный`	Если `истинный`проверяет, доступны ли слоты инвентаря игрока, прежде чем применять комплект. Этот вариант игнорируется, если `Чистая инвентаризация` устанавливается `истинный`.
`Чистая инвентаризация`	`ложный`	Если `истинный`очищает инвентарь игрока перед применением набора. Если `ложный`, элементы комплекта добавляются в существующий инвентарь.

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

MiniKit предоставляет полный API для разработчиков, которые хотят интегрировать функциональность набора в свои собственные плагины.

Начало работы

Мини-кит как зависимость

В вашем манифесте. Джонсон

//...
{
"Зависимость": {
"com.jecsham:MiniKit": "*"
?
// или
"Необязательные зависимости": {
"com.jecsham:MiniKit": "*"
?
?
//...

Грейдл:

зависимости {
составлять Только файлы ('libs/MiniKit-<version>.jar')
?

API использование

Доступ к API

// в вашем основном классе:
приватный MiniKitAPI miniKitAPI = нуль;

// внутри вашего метода установки():
Попробуйте {
miniKitAPI = MiniKit.getAPI();
если (miniKitAPI != null)
Возможность интеграции MiniKit
LOGGER.atInfo().log("Общие комплекты от MiniKit:" + miniKitAPI.getKitCount());
?
} catch (NoClassDefFoundError | Исключение e) {
// Мини-мини Комплект недоступен, продолжается без него
// или выйти из программы, если ваши плагины зависят от MiniKit
?

API Методы

метод	Возвращение	Описание
`получать KitById (int id)`	`Необязательно <Kit>`	Получает комплект по его уникальному идентификатору
`получать Kit (название струны)`	`Необязательно <Kit>`	Получает набор по его имени
`HasKit (int id)`	`булевый`	Проверяет, существует ли комплект с указанным идентификатором
`HasKit (Стринговое имя)`	`булевый`	Проверяет, существует ли комплект с указанным именем
`GetAllKits()`	`Map<Integer, Kit>`	Возвращает все наборы, нанесенные на карту их идентификаторами
`GetKitCount()`	`инт`	Возвращает общее количество комплектов

Пожалуйста, комментируйте ошибки или предложения!

Показать оригинальное описание (English)

A simple kit management mod designed to power a Hytale KitPvP-style server with an intuitive kit selector

Features

Create unlimited custom kits from your current inventory
Edit and delete kits with simple commands
Enable/disable kits without deleting them
Each kit stores complete inventory layout and items (including hotbar, storage, armor, backpack and utility!)
Intuitive custom UI for kit selection
Granular permission control per kit
Configurable cooldown between kit selections
Translations

Quick start

Creating a Kit:

/minikit create Warrior

Creates a new kit named "Warrior" with your current inventory.

Open MiniKit GUI:

/minikit

Listing All Kits:

/minikit list

Shows all kits with their IDs, names, and enabled/disabled status.

Deleting a Kit:

/minikit delete 3

Removes the kit with ID 3.

Commands & Permissions

Command	Permission Node	Description
`/minikit` (or `/kit`, `/kits`, `/minikits`)	`minikit.use`	Allows opening the MiniKit GUI menu to view and select kits
GUI - Select Kit (Any)	`minikit.select-kit.*`	Allows selecting any kit from the GUI menu
GUI - Select Kit (Specific)	`minikit.select-kit.<kitId>`	Allows selecting a specific kit by ID (e.g., `minikit.select-kit.1`)
Cooldown Bypass	`minikit.admin.bypass-cooldown`	Bypasses the kit selection cooldown timer
`/minikit create <kitName>`	`minikit.admin.create-kit`	Allows creating a new kit from current inventory
`/minikit update <kitId>`	`minikit.admin.update-kit`	Allows updating an existing kit's inventory with current inventory
`/minikit delete<kitId>`	`minikit.admin.delete-kit`	Allows deleting an existing kit by its ID
`/minikit toggle <kitId>`	`minikit.admin.toggle-kit`	Allows enabling or disabling a kit by its ID
`/minikit list`	`minikit.admin.list-kits`	Allows listing all available kits with their IDs and status

Granting Basic Access

Give players access to use kits:

/perm group add Adventure minikit.use
/perm group add Adventure minikit.select-kit.*

Granting Kit-Specific Access

Allow a player to only use specific kits (e.g., kit IDs 1 and 3).

NOTE: This requires omitting the wildcard (.*) permission above.

/perm group add Adventure minikit.use
/perm group add Adventure minikit.select-kit.1
/perm group add Adventure minikit.select-kit.3

Granting Admin Access

Give full administrative control:

/perm group add Adventure minikit.use
/perm group add Adventure minikit.select-kit.*
/perm group add Adventure minikit.admin.*

Configuration Options

MiniKit automatically creates a configuration file on first run. You can find it in your server's mods/com.jecsham_MiniKit/Config.json file.

Setting	Default	Description
`SelectKitCooldownSecs`	`5`	Number of seconds players must wait between selecting kits
`HideKitIfNoPermission`	`false`	If `true`, kits will be hidden from players who don't have permission to use them. If `false`, kits are shown but cannot be selected.
`CheckInventoryConflicts`	`false`	If `true`, checks if the player's inventory slots are available before applying a kit. This option is ignored if `ClearInventory` is set to `true`.
`ClearInventory`	`false`	If `true`, clears the player's inventory before applying a kit. If `false`, kit items are added to existing inventory.

For Developers

MiniKit provides a comprehensive API for developers who want to integrate kit functionality into their own plugins.

Getting Started

Add MiniKit as a Dependency

In your manifest.json

// ...
{
  "Dependencies": {
      "com.jecsham:MiniKit": "*"
  }
   // or
   "OptionalDependencies": {
         "com.jecsham:MiniKit": "*"
   }
}
// ...

Gradle:

dependencies {
    compileOnly files('libs/MiniKit-<version>.jar')
}

API Usage

Accessing the API

// in your Main class:
private MiniKitAPI miniKitAPI = null;

// inside your setup() method:
try {
   miniKitAPI = MiniKit.getAPI();
   if (miniKitAPI != null) {
      // MiniKit integration enabled
      LOGGER.atInfo().log("Total kits from MiniKit: " + miniKitAPI.getKitCount());
      }
   } catch (NoClassDefFoundError | Exception e) {
      // MiniKit not available, continuing without it
      // or exit the program if your plugins depends on MiniKit
   }

API Methods

Method	Returns	Description
`getKitById(int id)`	`Optional<Kit>`	Retrieves a kit by its unique ID
`getKit(String name)`	`Optional<Kit>`	Retrieves a kit by its name
`hasKit(int id)`	`boolean`	Checks if a kit exists with the specified ID
`hasKit(String name)`	`boolean`	Checks if a kit exists with the specified name
`getAllKits()`	`Map<Integer, Kit>`	Returns all kits mapped by their IDs
`getKitCount()`	`int`	Returns the total number of kits