Item Manager

Servidor de soporte – https://discord.gg/DRxwt8Qg2W

Un plugin de gestión de ítems para servidores de Hytale que permite a los administradores controlar la elaboración, uso y protección contra la muerte de cualquier ítem en el juego. Perfecto para sistemas VIP, control de economía del servidor y prevención de pérdida de ítems. Todo se gestiona a través de una hermosa y fácil de usar GUI – ¡solo se necesita un comando!

Características

Lista negra de elaboración
– Actualizaciones en tiempo real – Los cambios se aplican de inmediato sin reiniciar el servidor
– Bloqueo de recetas – Las recetas requieren un banco de trabajo de nivel 999 (imposible de alcanzar)

Protección contra la muerte
– Restauración automática – Los ítems protegidos se devuelven al inventario al morir
– Pantalla de muerte limpia – Los ítems protegidos no aparecen como ítems “perdidos”
– Protección selectiva – Elige exactamente qué ítems proteger

Restricciones de uso
– Bloqueo de barra rápida – Los jugadores no pueden seleccionar ítems restringidos
– Basado en permisos – Sistema de permisos opcional para ítems VIP/exclusivos
– Bloqueo automático de ranuras – El sistema impide el uso de ítems restringidos

GUI avanzada
– Interfaz hermosa – GUI moderna con pestañas (`/itemmanage`)
– Funcionalidad de búsqueda – Encuentra rápidamente ítems por nombre/ID
– Gestión con un clic – Agrega/elimina ítems con un solo clic
– Retroalimentación visual – Ve todas las restricciones
– Gestión de permisos – Establece permisos directamente en la GUI

Inicio rápido

1. Instala el plugin:
“`
Coloca ItemManager-1.0.0.jar en la carpeta mods/ de tu servidor
Reinicia tu servidor
“`

2. Abre la GUI:
“`
/itemmanage
“`

3. Gestiona ítems a través de la GUI:
– Lista negra de elaboración: Haz clic en la pestaña “Lista negra de elaboración” → Escribe el ID del ítem → Haz clic en “Agregar”
– Protección contra la muerte: Haz clic en la pestaña “Prot. de muerte” → Escribe el ID del ítem → Haz clic en “Agregar”
– Restricciones de uso: Haz clic en la pestaña “Restringir uso” → Escribe el ID del ítem → Establece el permiso (opcional) → Haz clic en “Agregar”
– Eliminar ítems: Haz clic en el botón “ELIMINAR” junto a cualquier ítem
– Buscar: Usa la barra de búsqueda para filtrar ítems

¡Eso es todo! Todo se gestiona a través de la GUI – no se necesitan comandos.

Instalación

1. Descarga `ItemManager-1.0.0.jar`
2. Coloca el archivo JAR en la carpeta `mods/` de tu servidor
3. Reinicia tu servidor
4. El plugin creará automáticamente una carpeta `Hyronix_ItemManager` con `config.json`

Requisitos:
– Servidor de Hytale (última versión)
– Java 21+
– Permisos de Admin/OP para gestionar ítems

Comandos

Todo se gestiona a través de la GUI – ¡solo se necesita un comando!

Características de la GUI:

La GUI incluye tres pestañas para la gestión completa de ítems:

Pestaña de lista negra de elaboración
– Ver todos los ítems en la lista negra
– Agregar ítems para prevenir la elaboración
– Eliminar ítems de la lista negra
– Buscar ítems por nombre/ID
– Actualizaciones en tiempo real – los cambios se aplican de inmediato

Pestaña de protección contra la muerte
– Ver todos los ítems protegidos
– Agregar ítems para proteger de caídas al morir
– Eliminar protección de ítems
– Buscar ítems por nombre/ID

Pestaña de restricciones de uso
– Ver todos los ítems restringidos
– Agregar ítems para restringir su uso/equipamiento
– Establecer permisos opcionales para ítems VIP/exclusivos
– Eliminar restricciones de ítems
– Buscar ítems por nombre/ID

¡Todas las operaciones se realizan directamente en la GUI – no se necesitan comandos adicionales!

Permisos

Permisos de restricción de uso

Al agregar una restricción de uso, puedes especificar un permiso:

– Permiso vacío: Bloquea a todos excepto a administradores/OP
– Establecer permiso (por ejemplo, `vip.use`): Solo los jugadores con ese permiso pueden usar el ítem

Ejemplo: Crear un sistema de ítems VIP

Paso 1: Restringir el ítem con un permiso
“`
Abrir /itemmanage → pestaña “Restringir uso” → Agregar ítem → Establecer permiso a “vip.use”
“`

Paso 2: Dar a los jugadores el permiso

Opción A – Permiso directo:
“`bash
/perm user add <player-uuid> vip.use
“`

Opción B – Basado en grupos (recomendado):
“`bash
/perm group add VIP vip.use

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

¡Ahora solo los jugadores con el permiso `vip.use` pueden usar la espada VIP!

Configuración

El plugin crea automáticamente `Hyronix_ItemManager/config.json` con tus configuraciones. Puedes editar este archivo directamente o usar la GUI.

Estructura de configuración:

“`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
}
}
}
“`

Notas de configuración:
– `enabled`: Establecer en `false` para desactivar temporalmente una restricción sin eliminarla
– `permission`: Para restricciones de uso, deja vacío para bloquear a todos (excepto administradores), o establece una cadena de permiso
– Los cambios en el archivo de configuración requieren un reinicio del servidor o `/reload` (si es compatible)

Cómo funciona

Lista negra de elaboración:
1. Cuando se agrega un ítem a la lista negra de elaboración, el plugin modifica su receta
2. El nivel de banco de trabajo requerido para la receta se establece en 999 (imposible de alcanzar)
3. La receta desaparece completamente de los menús de elaboración
4. Los cambios se aplican de inmediato a todos los jugadores a través de actualizaciones de paquetes
5. Los administradores/OP aún pueden elaborar estos ítems (sistema de bypass)

Protección contra la muerte:
1. Cuando un jugador muere, el plugin intercepta el evento de muerte
2. Los ítems protegidos se restauran automáticamente al inventario del jugador
3. Los ítems protegidos se filtran de la pantalla de muerte
4. Otros ítems caen normalmente (ítems no protegidos)
5. Sin problemas de duplicación – los ítems se restauran exactamente como estaban

Restricciones de uso:
1. Cuando un jugador intenta seleccionar un ítem restringido en su barra rápida, la selección se bloquea
2. Una verificación periódica (cada 1 segundo) asegura que los ítems restringidos no puedan ser usados
3. Si un ítem restringido ya está seleccionado, el jugador se cambia automáticamente a una ranura segura
4. Los jugadores reciben una notificación (sin spam en el chat) cuando son bloqueados
5. Los jugadores con el permiso requerido (si se establece) pueden usar el ítem normalmente

Encontrando IDs de ítems

Los IDs de ítems siguen la convención de nombres de Hytale. Aquí hay algunos ejemplos:

Patrones comunes de ID de ítems: