ItemsAdder: items y bloques personalizados en tu servidor

Qué es ItemsAdder

ItemsAdder es un plugin premium de pago creado por un desarrollador que se hace llamar LoneDev. Su objetivo principal es que los administradores de servidores de Minecraft puedan añadir su propio contenido (items, bloques, muebles, mobs, animaciones y overlays de interfaz) sin que los jugadores tengan que instalar mods.

Todo el mecanismo se apoya en dos pilares: un paquete de recursos que se envía al jugador automáticamente cuando entra al servidor y archivos de configuración YAML donde el administrador define todos los elementos personalizados. Para el jugador todo funciona como en Minecraft vanilla: solo necesita aceptar el paquete de recursos.

El plugin está disponible en SpigotMC por unos 25 EUR. Es una inversión que vale la pena considerar para servidores RPG, servidores de survival con contenido único o servidores con temática propia, donde destacar es clave.

ItemsAdder está en desarrollo activo desde 2019 y tiene una de las mayores comunidades entre los plugins premium. En SpigotMC el plugin ha reunido miles de reseñas positivas y se actualiza con regularidad para las nuevas versiones de Minecraft.

Cómo funciona el paquete de recursos

El corazón de ItemsAdder es su propio paquete de recursos, que el plugin genera automáticamente a partir de tus archivos de configuración. Cuando un jugador entra al servidor, Minecraft le pregunta si quiere descargar el paquete de recursos. Cuando lo acepta, ve todos los items, bloques y modelos personalizados.

ItemsAdder admite tres métodos para alojar el paquete de recursos:

• Servidor HTTP incorporado: el plugin sirve el archivo por sí mismo en un puerto (8163 por defecto). La solución más sencilla en un VPS con IP propia. Requiere abrir el puerto en el firewall.
• Alojamiento propio por FTP/SFTP: subes el paquete generado a tu propio servidor web o CDN. Más control, pero más configuración.
• Alojamiento externo: por ejemplo GitHub Releases, Dropbox o servicios dedicados de alojamiento de paquetes de recursos. Útil cuando tu proveedor de hosting bloquea puertos adicionales.

El punto clave: ItemsAdder usa CustomModelData, un número asignado a un item vanilla existente (por ejemplo, PAPER con CustomModelData 1001 muestra el modelo de una espada personalizada). Esta limitación viene de la arquitectura de Minecraft: hasta la versión 1.21.3 no hay una API oficial para crear nuevos IDs de items. A partir de la versión 1.21.4, Minecraft añadió compatibilidad con el componente item_model, que ItemsAdder ya usa.

Después de cada cambio en la configuración, tienes que reconstruir el paquete de recursos con el comando /iazip o /iareload. El plugin comprime los archivos y actualiza la URL automáticamente, así que los jugadores reciben la versión nueva la próxima vez que entran.

Crear items

Defines cada item personalizado en un archivo YAML dentro de la carpeta plugins/ItemsAdder/contents/. La estructura de directorios depende por completo de ti, así que puedes agrupar los items por paquete o por temática.

Un ejemplo de definición de una espada personalizada:

info:
  namespace: moj_serwer
items:
  miecz_ognia:
    display_name: "Espada de fuego"
    permission: moj_serwer.miecz_ognia
    resource:
      material: DIAMOND_SWORD
      generate: true
      textures:
        - item/miecz_ognia.png
    durability:
      max_custom_durability: 1024
    attribute_modifiers:
      mainhand:
        attackDamage: 8
    lore:
      - "&7Forjada en las llamas del Nether."
    events:
      interact:
        right:
          set_on_fire:
            duration: 5

El campo namespace es un identificador único de tu paquete de contenido, para que los items de distintos paquetes no choquen. El campo resource.material apunta al item vanilla que "hace de" tu modelo. Las texturas van en la carpeta contents/moj_serwer/textures/item/.

ItemsAdder admite:

• Modelos 3D en formato JSON (compatibles con Blockbench)
• Texturas animadas (mcmeta)
• Durabilidad y reparación personalizadas
• Efectos de partículas al usarlos
• Sonidos asociados a acciones
• Eventos, por ejemplo prender fuego a un jugador al golpear o curar al consumir
• Integración con sistemas de habilidades (MMOItems, AureliumSkills)

Puedes descargar paquetes de items ya hechos desde la wiki oficial y desde Polymart, donde la comunidad comparte sets gratuitos y de pago.

Crear bloques

Crear bloques personalizados es una de las partes técnicamente más difíciles de modificar un servidor de Minecraft. ItemsAdder lo resuelve con ingenio: usa estados de bloque musical o estados de bloque de hongo como "contenedores" para los bloques personalizados.

En Minecraft, un bloque musical tiene 800 estados únicos. ItemsAdder reserva esos estados para tus bloques: el jugador ve el modelo del paquete de recursos y el motor del servidor ve un bloque musical en un estado concreto. Como resultado, los bloques se comportan como bloques reales: se pueden recoger, colocar y minar a la velocidad adecuada.

Un ejemplo de definición de bloque:

items:
  rubin_ore:
    display_name: "Mineral de rubí"
    resource:
      material: PAPER
      generate: false
      model_path: block/rubin_ore
    specific_properties:
      block:
        placed_model:
          type: REAL_NOTE
          break_particles_material: DIAMOND_ORE
        hardness: 5
        blast_resistance: 6
        drop_exp:
          min: 2
          max: 5

El tipo REAL_NOTE significa usar un estado de bloque musical: el bloque es "real", tiene colisión, puedes pararte sobre él y puedes minarlo. Las alternativas son REAL_TRANSPARENT (admite transparencia) y REAL_WIRE (basado en el hilo trampa, para elementos delgados).

Los bloques también admiten drops personalizados. Puedes configurar tu mineral para que suelte algo solo con un nivel de minería concreto o con un item específico, lo que encaja muy bien con los sistemas RPG.

Mobs personalizados

ItemsAdder te permite crear mobs personalizados con sus propios modelos 3D y animaciones. Los mobs se definen de forma muy parecida a los items, en archivos YAML que hacen referencia a un modelo de Blockbench.

Los modelos de mobs para ItemsAdder se hacen en Blockbench con el plugin de ItemsAdder. El plugin admite un conjunto completo de animaciones: caminar, correr, atacar, morir, comer y animaciones personalizadas definidas por el creador.

El mayor poder aparece con la integración de MythicMobs. Puedes asignar un modelo de ItemsAdder a un mob de MythicMobs y obtienes una criatura con un aspecto único y una IA avanzada, fases de combate, ataques especiales y recompensas. Esta combinación se usa en decenas de servidores RPG.

Un ejemplo de configuración de un mob personalizado en ItemsAdder:

info:
  namespace: moj_serwer
entity_models:
  smok_ognia:
    display_name: "Dragón de fuego"
    model: entity/smok_ognia
    animations:
      walk:
        speed_multiplier: 1.0
      attack:
        duration: 1.2

Luego, en MythicMobs, haces referencia a este modelo con la opción Options.ItemsAdder: moj_serwer:smok_ognia. El jugador ve un modelo 3D precioso y MythicMobs gestiona toda la lógica de comportamiento.

Muebles y decoración

Una de las funciones más apreciadas de ItemsAdder es su sistema de muebles. Los muebles son estructuras decorativas de varios bloques (sillas, mesas, camas, lámparas, cofres) que puedes colocar en el mundo del juego.

Técnicamente, los muebles se construyen con soportes para armadura invisibles que llevan modelos del paquete de recursos. Eso permite que tengan dimensiones propias, que sobresalgan de un solo bloque y que se coloquen en distintos ángulos.

ItemsAdder trae varios sets de muebles de fábrica, pero el verdadero valor está en poder crear los tuyos. Exportas un modelo desde Blockbench, configuras las hitboxes y listo. Los muebles admiten:

• Sentarse (los jugadores pueden sentarse en una silla o banca)
• Colisión con el jugador (bloquea el movimiento)
• Interacciones (abrir gabinetes, activar mecanismos)
• Colocación en paredes y techos (por ejemplo, cuadros y lámparas)
• Rotación en 8 o 16 direcciones

Los plugins FurnitureLib y FurnitureEngine son alternativas para el sistema de muebles, pero ItemsAdder integra todo en un solo ecosistema, lo que elimina los problemas de compatibilidad entre plugins.

Emotes

ItemsAdder admite emotes animados para los jugadores: animaciones completas del personaje que los demás jugadores ven en tiempo real. Un jugador puede saludar, bailar, reírse o hacer cualquier animación que el administrador haya definido.

Los emotes funcionan reemplazando el modelo del jugador en el paquete de recursos y reproduciendo la animación del lado del cliente. Para que los demás vean un emote, ItemsAdder usa trucos de protocolo con metadatos de entidades.

Ejemplos de cómo se usan los emotes:

• Saludos VIP en el spawn (una animación especial para donadores)
• Animaciones de clases de personaje en juegos RPG (un mago lanzando hechizos)
• Bailes y gestos en zonas sociales
• Animaciones de muerte en lugar de la caída predeterminada del personaje

Los emotes se pueden vincular a rangos con LuckPerms; por ejemplo, solo los jugadores con el rango VIP acceden a animaciones poco comunes. Es una parte popular de la oferta de monetización en los servidores.

GUI y HUD

ItemsAdder incluye un sistema avanzado para crear overlays sobre la interfaz del jugador (HUD). Puedes mostrar tus propias barras, íconos, contadores e información directamente en la pantalla del jugador, sin plugins adicionales.

El HUD en ItemsAdder funciona reemplazando la bossbar o la actionbar con una Bitmap Font personalizada del paquete de recursos. El efecto: el jugador ve en pantalla un overlay de pixel art que parece parte de la interfaz del juego.

Usos típicos del HUD:

• Barra de maná/energía: un recurso de hechizos que se muestra junto a la barra de vida
• Contador de moneda: un saldo o puntos de experiencia en la esquina de la pantalla
• Indicador de temperatura/hambre/contaminación: para servidores de survival con mecánicas de supervivencia
• Miniatura de brújula: dirección y coordenadas en la parte superior de la pantalla
• Notificaciones de logros: banners animados cuando se desbloquea algo

Para armar un HUD puedes usar el editor integrado en el plugin o herramientas externas como HMCCosmetics. ItemsAdder también ofrece una API para desarrolladores, de modo que otros plugins pueden registrar sus propios elementos de HUD.

Precio y licencia

ItemsAdder es un plugin premium de pago disponible solo en la plataforma SpigotMC. El precio actual es de unos 25 EUR por licencia. Revisa el precio vigente en la página de SpigotMC, ya que puede cambiar.

Tu compra incluye:

• Una licencia para un servidor (una IP o una red de proxy)
• Acceso a todas las actualizaciones por tiempo ilimitado
• Acceso al canal oficial de soporte en Discord
• Acceso a la wiki oficial con la documentación

Puntos importantes de la licencia:

• Cada servidor necesita una licencia aparte, porque una licencia no cubre una granja de servidores
• Las redes BungeeCord/Velocity pueden contar como una sola licencia, pero conviene confirmarlo con el autor
• Descargas el plugin desde el panel de SpigotMC después de comprarlo, ya que el archivo .jar no está disponible públicamente
• No hay versión de "prueba". Antes de comprar solo puedes probar en un entorno local, con algunas limitaciones

El precio puede parecer alto frente a alternativas gratuitas como Oraxen CE (Community Edition), pero ItemsAdder ofrece muchas más funciones, mejor documentación y soporte activo. Para servidores con presupuesto, es una inversión sólida que se recupera rápido con una mejor experiencia de los jugadores.

Comparación con Oraxen

El principal competidor de ItemsAdder es Oraxen. Durante años la elección fue "alternativa gratuita vs premium de pago", pero la situación se complicó: Oraxen introdujo un plan premium de pago (Oraxen Pro), mientras que ItemsAdder se mantuvo con un precio fijo.

Cuándo elegir ItemsAdder: tienes presupuesto, necesitas emotes y un HUD amplio, quieres integración nativa con MythicMobs y te importa el soporte profesional y una gran comunidad de recursos.

Cuándo elegir Oraxen CE: no tienes presupuesto para plugins, solo necesitas items y bloques personalizados y valoras el código abierto y la posibilidad de modificar el código.

Compatibilidad

ItemsAdder es compatible con:

• Versiones de Minecraft: 1.14 - 1.21.x (se actualiza continuamente)
• Software de servidor: Paper (recomendado), Spigot, Purpur, Pufferfish
• Redes: BungeeCord, Velocity (el plugin se instala por separado en cada backend)
• MythicMobs: integración nativa de modelos y mobs
• MMOItems: estadísticas personalizadas vinculadas a items de ItemsAdder
• AureliumSkills / AuraSkills: un sistema de habilidades con items de ItemsAdder
• LuckPerms: permisos para items, emotes y rangos
• EssentialsX: kits y tiendas con items de ItemsAdder
• PlaceholderAPI: placeholders personalizados para HUDs y chats
• WorldGuard: protección de regiones que tiene en cuenta los bloques de ItemsAdder

Limitaciones conocidas:

• No funciona en Bedrock Edition (solo Java)
• Requiere que el jugador acepte el paquete de recursos, y los jugadores que lo tienen desactivado solo ven items vanilla
• Los paquetes de recursos grandes pueden hacer más lenta la entrada al servidor (tiempo de descarga)
• Los límites de estados del bloque musical/bloque de hongo restringen la cantidad de bloques únicos (unos 800 de bloque musical + 54 de hongo)
• No es compatible con otros plugins que usen los mismos estados de bloque musical sin una integración dedicada

Encontrarás más sobre plugins de servidor en el catálogo de plugins. Si estás armando un servidor RPG, revisa también MythicMobs: combinar los dos plugins abre grandes posibilidades para crear jefes y aventuras únicos.