Plugin de Minecraft ItemJoin

🔌 Acerca de ItemJoin

ItemJoin es un plugin de Minecraft para dar automáticamente a los jugadores objetos personalizados altamente configurables. Los objetos pueden otorgarse en eventos como join, first-join, respawn, world-switch, region-enter y region-leave. El plugin se centra en definiciones flexibles de objetos (itemflags), eventos activadores y comandos vinculados a objetos, para que los servidores puedan ofrecer menús de lobby, kits iniciales o herramientas sensibles al contexto sin mods personalizados en el cliente.

🎯 Propósito

ItemJoin resuelve el problema de entregar de forma fiable a los jugadores objetos personalizados o interactivos vinculados a eventos y mundos del servidor. Es útil para servidores de hub/lobby, servidores de minijuegos, redes de survival (donde los objetos deben limitarse por mundo) y redes que necesitan menús basados en objetos o elementos que ejecutan comandos.

⚙️ Características

• Otorga objetos mediante activadores configurables: join, first-join, respawn, world-switch, region-enter/exit y eventos similares.
• itemflags por objeto que alteran el comportamiento (slot, overwrite, reglas de stack, bloqueo de movimiento/recogida, límites de gamemode, probabilidad de recibirlo, cooldowns).
• ItemCommands: adjunta comandos a los objetos y configura el contexto de ejecución (console, player, server, message) y los tipos de acción (clic izquierdo/derecho, clic en inventario, físico, multi-clic).
• Integración con PlaceholderAPI para nombres/lore dinámicos de objetos y soporte para placeholders.
• Soporte para cabezas de jugador personalizadas (texturas y dueños personalizados), imágenes en mapas, tipped arrows, libros, banners, fuegos artificiales, personalización de armaduras de cuero y niveles de encantamiento personalizados.
• Opcionalmente bloquea el movimiento o la recogida de objetos en mundos específicos y restringe objetos por dirección IP o por estado de first-join.
• Creador de GUI dentro del juego para construir conjuntos de objetos y un flujo integrado de importación/creación.
• API para otros plugins: disponible en me.RockinChaos.itemjoin.api.ItemJoinAPI.

🧩 Para quién es

• Propietarios de servidores que necesitan objetos automáticos de lobby/hub o kits iniciales.
• Operadores de minijuegos y redes que requieren objetos específicos por mundo o brújulas de menú.
• Desarrolladores que quieren un sistema de objetos conectable mediante una API.

🏗️ Casos de uso de ejemplo

• Dar a los jugadores una brújula de menú al entrar que ejecute comandos distintos al hacer clic.
• Ofrecer kits iniciales de un solo uso en el first-join mientras se evita el traspaso de objetos entre mundos especificados.
• Crear objetos interactivos que ejecuten comandos de economía/tienda con cooldowns y costes.

⌨️ Comandos

Nota: estos comandos y subcomandos provienen del conjunto de comandos documentado del plugin. El plugin ofrece subcomandos adicionales en su wiki y en la salida de ayuda generada.

🔐 Permisos

El comportamiento de los permisos específicos por objeto es configurable; las comprobaciones de permisos de objetos están desactivadas por defecto y deben activarse en la configuración del plugin para surtir efecto.

⚙️ Instalación

📥 Configuración

• Descarga el jar oficial de ItemJoin y colócalo en la carpeta plugins/ de tu servidor.
• Asegúrate de que no haya archivos jar duplicados de ItemJoin en plugins/ (por ejemplo, ItemJoin(1).jar).
• Reinicia el servidor para que el plugin genere su configuración y registre las funciones para la versión de tu servidor.
• Revisa los logs de la consola del servidor para confirmar la carga del plugin y consulta la wiki del plugin para una configuración detallada.

📦 Dependencias

El plugin no tiene requisitos obligatorios en tiempo de ejecución, pero enumera varias soft-dependencies e integraciones comunes (opcionales y habilitadas cuando están presentes):

• Vault
• AuthMe
• BetterNick
• HeadDatabase
• PlaceholderAPI
• SkinRestorerX
• TokenEnchant
• WorldEdit
• WorldGuard

Activa o configura las integraciones según sea necesario; el plugin funciona sin ellas, pero funciones como los placeholders, las cabezas/skins personalizadas y los hooks de economía dependen de los plugins correspondientes.

🧠 Notas técnicas

• Plataformas: confirmado para servidores tipo Spigot (Spigot, Bukkit, Paper, Purpur, Folia).
• Rango de Minecraft compatible/probado: 1.8 hasta 1.21.
• El código fuente y las versiones publicadas están disponibles, y el proyecto expone una API en me.RockinChaos.itemjoin.api.ItemJoinAPI para que otros plugins se integren.
• Licencia: LGPL-3.0.

🤝 Cuándo es útil este plugin

Si necesitas un sistema flexible y configurable para dar a los jugadores objetos interactivos y sensibles al contexto (menús, kits iniciales, herramientas específicas por mundo) y quieres una API para integraciones, ItemJoin ofrece esas funciones con soporte para plugins comunes de placeholders y skins.