PlayerKitsPlugin для Hytale

Мощный, многофункциональный плагин управления наборами для серверов Hytale, который позволяет администраторам создавать, управлять и распространять предопределенные наборы элементов для игроков с широкими возможностями настройки.

Особенности

Основная функциональность

• Создавать наборы: Сохранение запасов игроков в качестве многоразовых наборов с одной командой
• Многокомпонентная поддержка: Наборы включают в себя хранение, броню, горячую панель, слоты для коммунальных услуг и предметы рюкзака
• Доступ на основе разрешенийНазначение конкретных разрешений для каждого комплекта
• Система охлажденияНастройка пользовательских охлаждений на комплект (от секунд до часов)
• Легкое распределение: Дайте наборы себе или другим игрокам с интуитивными командами

Административные инструменты

• Пакетные операции: Сохранить, перезагрузить или удалить несколько наборов одновременно
• Управление охлаждениемПросмотр и сброс охлаждений игрока через команды
• Информация о комплекте: Подробное представление содержимого набора и метаданных
• Файловое хранилищеКаждый набор сохранен в виде отдельного файла JSON для легкого резервного копирования

Игровой опыт

• Кит Браузер: Перечислите все доступные комплекты с поддержкой pagination
• Дисплей CooldownОтслеживание в реальном времени с отформатированным временем
• Отзывы о разрешении: Ясные сообщения, когда у игроков нет необходимых разрешений
• Безопасность инвентаряНеразрушающий набор, который уважает существующие элементы

командование

Игровые команды

Административные команды

Управление охлаждением

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

Файловая структура

Mods/RazorPlay_PlayerKitsPlugin/
─ ─ наборы / # Индивидуальный набор JSON файлов
│ │ ─ стартер. Джонсон
│ │ │ ─ воин. Джонсон
??????????
Недостатки - охлаждение. Джейсон # Player cooldown

Свойства Kit

Каждый комплект можно настроить с помощью:

• IDУникальный идентификатор (без пробелов/слэшей)
• ИмяНазвание дисплея, показанное игрокам
• Описание: Факультативное описание
• РазрешениеТребуемый узел разрешения (оставьте пустой для общественности)
• ОхлаждениеВремя между использованиями в секундах (0 без охлаждения)
• Пункты: Полный инвентарь, включая броню и рюкзак

Узлы разрешений

razorplay.playerkitsplugin.command.kit.* Все команды Kit
razorplay.playerkitsplugin.command.kit.create #Создать наборы
razorplay.playerkitsplugin.command.kit.delete # Удалить наборы
razorplay.playerkitsplugin.command.kit.give # Дайте наборы другим
razorplay.playerkitsplugin.command.kit.reload # Перезагрузка комплектов
razorplay.playerkitsplugin.command.kit.cooldown* Все команды cooldown

Разрешения Custom Kit

Создание пользовательских разрешений для конкретных наборов: kit.mykit.use # Пример: Пользовательское разрешение для «mykit»

Интеграция API

PlayerKitsPlugin предоставляет полный API для разработчиков

Получить экземпляр KitAPI
KitAPI kitAPI = PlayerKitsPlugin.getKitAPI();

Создание наборов программно
Kit kit = kitAPI.createKit("id", "name", player, "description");

Дайте наборы игрокам
boolean success = kitAPI.giveKit (плеер, плеерRef, «kitId»);

Система событий для пользовательского поведения
kitAPI.registerListener (новый KitEventListener) {
@Override
Общественная пустота на KitClaimed (событие KitClaimEvent)
// Пользовательская логика, когда набор заявлен
?
}

Проверка разрешения Async
CompletableFuture<List<Kit>> availableKits = kitAPI.getAvailableKitsAsync()
игрок Ид,
(uuid, permission) -> checkPermissionAsync (uuid, permission)
);

Примеры использования

1. Создание стартового набора

/kit создать стартер Стартер «Основные инструменты и броня для новых игроков»

2.Установка ежедневного вознаграждения

1. Создайте комплект с 24-часовым охлаждением: /kit создает ежедневно ежедневно

2. Отредактируйте файл JSON, чтобы установить «Cooldown»: 86400 (24 часа в секундах)

3. Установить разрешение: "Разрешение": "kit.daily.use"

3. Импорт общинных комплектов

импорт /kit /path/to/community_kit.json

Установка

1. Скачать последнюю PlayerKitsPlugin.jar
2. Поместите его в свой Моды / каталог сервера Hytale
3. Запустите или перезагрузите свой сервер
4. Плагин автоматически создаст необходимые каталоги и файлы

Технические детали

Система хранения

• НаборыОтдельные файлы JSON в модах/PlayerKitsPlugin/kits/
• ОхлаждениеЦентрализованный файл JSON с отслеживанием на основе игроков
• Сериализация: Использует систему кодеков Hytale для надежной сериализации элементов

Особенности исполнения

• кешированиеКэширование доступности набора для конкретного игрока (30-секундный TTL)
• Операции AsyncНеблокирующий файл I/O и проверка разрешения
• Эффективная погрузкаЛенивая загрузка файлов набора по требованию

Особенности безопасности

• Вводная валидацияСанитаризованные идентификаторы наборов для предотвращения проблем с файловой системой
• Обработка ошибокВсеобъемлющее обращение с исключениями при детальной вырубке
• Целостность данныхАвтоматическое резервное копирование через отдельные файлы набора

Устранение неполадок

Общие вопросы

1. "Кит не найден"Убедитесь, что идентификатор набора правильный и чувствительный к делу
2. Разрешение отказаноПроверьте узлы разрешений и настройки LuckPerms / группы
3. Инвентаризация не экономитПроверьте, есть ли у игрока предметы в инвентаре при создании набора
4. Файловые ошибки: Проверьте разрешения файлов в модах / RazorPlay_PlayerKitsPlugin / каталог

Логс

Проверьте журналы сервера для получения подробной информации об ошибках:

• [PlayerKitsPlugin] префиксированные сообщения показывают активность плагина
• Предупреждения указывают на некритические проблемы
• Ошибки требуют немедленного внимания

Вклад

Нашел ошибку или есть запрос функции? Пожалуйста, откройте вопрос в нашем репозитории GitHub!

Лицензия

Этот плагин предоставляется по лицензии MIT. См. файл Лицензии для деталей.

Кредиты

разработчикИсполнитель: Razorplay Испытание: Ваши вклады приветствуются!