Item Manager

Advanced item management plugin for Hytale servers. Control crafting, usage, and death protection for any item. Features real-time updates, permission-based restrictions, and a beautiful GUI. Perfect for VIP systems and server economy control.

370.0 загрузок

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

Разное Геймплей Утилиты

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

Скриншоты

Описание

Сервер поддержки - https://discord.gg/DRxwt8Qg2W

Плагин управления элементами для серверов Hytale, который позволяет администраторам контролировать создание, использование и защиту от смерти для любого элемента в игре. Идеально подходит для VIP-систем, управления экономикой сервера и предотвращения потери элементов. Все управляется с помощью красивого, простого в использовании графического интерфейса - нужна только одна команда!

Особенности

Создание черного списка
Обновления в режиме реального времени - Изменения применяются немедленно без перезагрузки сервера
Рецепты требуют рабочего стола уровня 999 (невозможно достичь)

Защита от смерти
- Автоматическое восстановление - Защищенные предметы возвращаются в инвентарь после смерти
Чистый экран смерти - Защищенные предметы не выглядят как «потерянные» предметы
Селективная защита - Выберите, какие именно предметы следует защищать

Ограничения использования
Блокировка Hotbar - Игроки не могут выбирать предметы с ограниченным доступом
- Система разрешений для VIP/эксклюзивных предметов
Автоматическая блокировка слотов - система предотвращает ограниченное использование предметов

Расширенный GUI
- Красивый интерфейс - современный графический интерфейс с вкладками ("/itemmanage")
Функциональность поиска - Быстро найти элементы по имени / идентификатору
- Управление одним щелчком мыши - Добавление/удаление элементов одним щелчком мыши
- Визуальная обратная связь - см. все ограничения
Управление разрешениями - Установите разрешения непосредственно в GUI

Быстрый старт

1. Установите плагин:
"" пункт
Разместите ItemManager-1.0.0.jar в модах / папке вашего сервера
Перезагрузите свой сервер
"" пункт

2. Откройте GUI:
"" пункт
/itemmanage
"" пункт

3. Управление предметами через GUI:
- Crafting Blacklist: Click the "Crafting Blacklist" tab → Type item ID → Click "Add"
Защита от смерти: Нажмите кнопку «Смертельный протез». вкладка → Идентификатор типа → Нажмите «Добавить»
- Ограничения использования: Нажмите кнопку «Ограничение использования». вкладка → Идентификатор типа → Установить разрешение (необязательно) → Нажмите «Добавить»
- Удалить элементы: нажмите кнопку «Удалить» рядом с любым элементом
- Поиск: Используйте панель поиска для фильтрации элементов

Вот так! Все управляется через GUI — никаких команд не требуется.

установка

1. Скачать ‘ItemManager-1.0.0.jar пункт
2. Поместите файл JAR в папку «Моды /» вашего сервера
3. Перезагрузите свой сервер
4. Плагин автоматически создаст папку «Hyronix_ItemManager» пункт

Требования:
Hytale Server (последняя версия)
Java 21+
Разрешения администратора / ОП для управления элементами

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

Все управляется через GUI — нужна только одна команда!

| Командование | Описание
[скрыто] [скрыто] [скрыто] [скрыто] [скрыто]
| '/itemmanage' | Открывает расширенный графический интерфейс для управления всеми ограничениями на товары |

ГУИ Особенности:

GUI включает в себя три вкладки для полного управления объектами:

Скачать Blacklist Tab
Посмотреть все статьи в черном списке
Добавьте предметы, чтобы предотвратить крафт
Удалить предметы из черного списка
Поиск предметов по имени / ID
Обновления в реальном времени - изменения применяются немедленно

Смертельный Прот. вкладка
Просмотреть все защищенные предметы
Добавьте предметы для защиты от капель смерти
- Удалить защиту от предметов
Поиск предметов по имени / ID

Восстановление использования. вкладка
Просмотреть все ограниченные предметы
Добавить элементы для ограничения использования / оснащения
Установите дополнительные разрешения для VIP / эксклюзивных предметов
- Снять ограничения с предметов
Поиск предметов по имени / ID

Все операции выполняются непосредственно в GUI — никаких дополнительных команд не требуется!

Разрешения

Разрешения на ограничение использования

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

- Пустое разрешение: Блокирует всех, кроме администраторов / ОП
- Установить разрешение (например, "vip.use"): Только игроки с таким разрешением могут использовать предмет.

Пример: Создание VIP Система элементов

Шаг 1: Ограничьте предмет с разрешения
"" пункт
Открытый /itemmanage → «Usage Restr.» вкладка → Добавить элемент Установите разрешение на «vip.use»
"" пункт

Шаг 2: Дайте игрокам разрешение

Вариант А - Прямое разрешение:
Баш
/perm user add <player-uuid> vip.use
"" пункт

Вариант В - Группа на основе (рекомендуется):
Баш
/perm group add VIP vip.use

/perm user group add <player-uuid> VIP
"" пункт

Теперь только игроки с разрешением vip.use могут использовать VIP-меч!

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

Плагин автоматически создает «Hyronix_ItemManager/config.json» с вашими настройками. Вы можете редактировать этот файл напрямую или использовать GUI.

конфигурация Структура:

Джонсон
{
«Crafting Blacklist»: {
«Weapon_Sword_Crude»: {
"Включено": правда,
"разрешение": "
?
"Armor_Cobalt_Head": {
"Включено": правда,
"разрешение": "
?
?
«Черный список»: {
"Weapon_Bow_VIP":
"Включено": правда,
"разрешение": "vip.use"
?
"Tool_Pickaxe_Premium": {
"Включено": правда,
"разрешение": "premium.tools"
?
?
"Защищенные от смерти": {
"Armor_Mithril_Head": {
«Включено»: истинно
?
"Оружие_Меч_Подпись": {
«Включено»: истинно
?
?
?
"" пункт

Конфигурационные примечания:
- "допускается": Настройка на «ложное» временное отключение ограничения без его снятия
- "разрешение": Для ограничений использования оставьте пустым блокировать всех (кроме администраторов) или установите строку разрешения.
Изменения в файле конфигурации требуют перезагрузки сервера или «/перезагрузки» (при поддержке)

Как это работает

Составление черного списка:
1. Когда элемент добавляется в черный список, плагин изменяет свой рецепт.
2. Рецепт рецепта должен быть установлен на уровне 999 (невозможно достичь).
3. Рецепт полностью исчезает из меню
4. Изменения касаются всех игроков с помощью пакетных обновлений.
5. Администраторы / ОП все еще могут создавать эти элементы (обходная система)

Защита от смерти:
1. Когда игрок умирает, плагин перехватывает событие смерти.
2. Защищенные предметы автоматически восстанавливаются в инвентаре игрока.
3. Защищенные предметы фильтруются с экрана смерти
4. Другие предметы обычно падают (незащищенные предметы)
5. Нет проблем с дублированием - предметы восстановлены точно так же, как они были

Ограничения использования:
1. Когда игрок пытается выбрать ограниченный элемент в своей горячей панели, выбор блокируется.
2. Периодическая проверка (каждую 1 секунду) гарантирует, что ограниченные предметы не могут быть использованы.
3. Если ограниченный элемент уже выбран, игрок автоматически переключается на безопасный слот.
4. Игроки получают уведомление (не спам в чате) при блокировке
5. Игроки с требуемым разрешением (если установлено) могут использовать элемент обычно.

Поиск идентификаторов элементов

Идентификаторы предметов следуют соглашению об именах Hytale. Вот несколько примеров:

Паттерны идентификаторов Common Item:

"Оружие_Меч_Жестокость", "Оружие_Bow_VIP", "Оружие_Кинжалы_Митрил" !
«Armor_Mithril_Head», «Armor_Cobalt_Chest», «Armor_Copper_Legs» !
«Tool_Pickaxe_Cobalt», «Tool_Axe_Mithril», «Tool_Shovel_Copper» !
↑ «Ingredient_Fibre», «Food_Bread», «Material_Wood_Log» !

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

Support Server - https://discord.gg/DRxwt8Qg2W

An item management plugin for Hytale servers that allows administrators to control crafting, usage, and death protection for any item in the game. Perfect for VIP systems, server economy control, and preventing item loss. Everything is managed through a beautiful, easy-to-use GUI - just one command needed!

Features

Crafting Blacklist
- Real-time updates - Changes apply immediately without server restart
- Recipe locking - Recipes require tier 999 workbench (impossible to achieve)

Death Protection
- Automatic restoration - Protected items are returned to inventory on death
- Clean death screen - Protected items don't appear as "lost" items
- Selective protection - Choose exactly which items to protect

Usage Restrictions
- Hotbar blocking - Players cannot select restricted items
- Permission-based - Optional permission system for VIP/exclusive items
- Automatic slot locking - System prevents restricted item usage

Advanced GUI
- Beautiful interface - Modern tabbed GUI (`/itemmanage`)
- Search functionality - Quickly find items by name/ID
- One-click management - Add/remove items with a single click
- Visual feedback - See all restrictions
- Permission management - Set permissions directly in GUI

Quick Start

1. Install the plugin:
```
Place ItemManager-1.0.0.jar in your server's mods/ folder
Restart your server
```

2. Open the GUI:
```
/itemmanage
```

3. Manage items through the GUI:
- Crafting Blacklist: Click the "Crafting Blacklist" tab → Type item ID → Click "Add"
- Death Protection: Click the "Death Prot." tab → Type item ID → Click "Add"
- Usage Restrictions: Click the "Usage Restr." tab → Type item ID → Set permission (optional) → Click "Add"
- Remove items: Click "REMOVE" button next to any item
- Search: Use the search bar to filter items

That's it! Everything is managed through the GUI - no commands needed.

Installation

1. Download `ItemManager-1.0.0.jar`
2. Place the JAR file in your server's `mods/` folder
3. Restart your server
4. The plugin will automatically create a `Hyronix_ItemManager` folder with `config.json`

Requirements:
- Hytale Server (latest version)
- Java 21+
- Admin/OP permissions to manage items

Commands

Everything is managed through the GUI - only one command needed!

| Command | Description |
|---------|-------------|
| `/itemmanage` | Opens the advanced GUI for managing all item restrictions |

GUI Features:

The GUI includes three tabs for complete item management:

Crafting Blacklist Tab
- View all blacklisted items
- Add items to prevent crafting
- Remove items from blacklist
- Search for items by name/ID
- Real-time updates - changes apply immediately

Death Prot. Tab
- View all protected items
- Add items to protect from death drops
- Remove protection from items
- Search for items by name/ID

Usage Restr. Tab
- View all restricted items
- Add items to restrict usage/equipping
- Set optional permissions for VIP/exclusive items
- Remove restrictions from items
- Search for items by name/ID

All operations are done directly in the GUI - no additional commands needed!

Permissions

Usage Restriction Permissions

When adding a usage restriction, you can specify a permission:

- Empty permission: Blocks everyone except admins/OP
- Set permission (e.g., `vip.use`): Only players with that permission can use the item

Example: Creating a VIP Item System

Step 1: Restrict the item with a permission
```
Open /itemmanage → "Usage Restr." tab → Add item → Set permission to "vip.use"
```

Step 2: Give players the permission

Option A - Direct permission:
```bash
/perm user add <player-uuid> vip.use
```

Option B - Group-based (recommended):
```bash
/perm group add VIP vip.use

/perm user group add <player-uuid> VIP
```

Now only players with `vip.use` permission can use the VIP sword!

Configuration

The plugin automatically creates `Hyronix_ItemManager/config.json` with your settings. You can edit this file directly or use the GUI.

Configuration Structure:

```json
{
"craftingBlacklist": {
"Weapon_Sword_Crude": {
"enabled": true,
"permission": ""
},
"Armor_Cobalt_Head": {
"enabled": true,
"permission": ""
}
},
"usageBlacklist": {
"Weapon_Bow_VIP": {
"enabled": true,
"permission": "vip.use"
},
"Tool_Pickaxe_Premium": {
"enabled": true,
"permission": "premium.tools"
}
},
"deathProtected": {
"Armor_Mithril_Head": {
"enabled": true
},
"Weapon_Sword_Signature": {
"enabled": true
}
}
}
```

Configuration Notes:
- `enabled`: Set to `false` to temporarily disable a restriction without removing it
- `permission`: For usage restrictions, leave empty to block everyone (except admins), or set a permission string
- Changes to the config file require a server restart or `/reload` (if supported)

How It Works

Crafting Blacklist:
1. When an item is added to the crafting blacklist, the plugin modifies its recipe
2. The recipe's required workbench tier is set to 999 (impossible to achieve)
3. The recipe disappears from crafting menus entirely
4. Changes apply immediately to all players via packet updates
5. Admins/OP can still craft these items (bypass system)

Death Protection:
1. When a player dies, the plugin intercepts the death event
2. Protected items are automatically restored to the player's inventory
3. Protected items are filtered from the death screen display
4. Other items drop normally (unprotected items)
5. No duplication issues - items are restored exactly as they were

Usage Restrictions:
1. When a player tries to select a restricted item in their hotbar, the selection is blocked
2. A periodic check (every 1 second) ensures restricted items can't be used
3. If a restricted item is already selected, the player is automatically switched to a safe slot
4. Players receive a notification (not chat spam) when blocked
5. Players with the required permission (if set) can use the item normally

Finding Item IDs

Item IDs follow Hytale's naming convention. Here are some examples:

Common Item ID Patterns: