Qué es Oraxen

Oraxen es un plugin para crear objetos, bloques, muebles y equipo personalizados en servidores de Minecraft. No necesita mods en el cliente: en su lugar genera un paquete de recursos y se lo envía automáticamente a los jugadores cuando se conectan.

El plugin se apoya en CustomModelData (desde Minecraft 1.14) y en los componentes de objeto (1.20.5+) para que objetos vanilla ya existentes se vean como objetos totalmente nuevos. Del lado del servidor, cada objeto personalizado sigue siendo un objeto de Minecraft (por ejemplo, una espada de madera con CustomModelData 1001), pero el cliente lo muestra con una textura y un modelo 3D propios.

Oraxen está en GitHub. Puedes conseguirlo en SpigotMC o en Modrinth.

Cómo funciona por dentro

Oraxen combina tres mecanismos de Minecraft:

CustomModelData / componentes de objeto - permite asignar un modelo 3D personalizado a un objeto existente. El cliente muestra el modelo del paquete de recursos en lugar del predeterminado
Paquete de recursos - Oraxen genera automáticamente un paquete de recursos con las texturas y los modelos. El servidor lo aloja y obliga a descargarlo cuando un jugador se conecta
Estados de bloque de notas / bloque de hongo - los bloques personalizados usan estados sin utilizar del bloque de notas o del bloque de hongo para mostrar texturas únicas

Gracias a este enfoque, los jugadores no tienen que instalar ningún mod. Solo necesitan aceptar el paquete de recursos del servidor. El plugin es totalmente compatible con el cliente vanilla de Minecraft.

Crear objetos

Los objetos personalizados se definen en archivos YAML dentro de plugins/Oraxen/items/:

# ruby_sword.yml
ruby_sword:
  displayname: "&cEspada de rubí"
  material: DIAMOND_SWORD
  Pack:
    generate_model: true
    parent_model: item/handheld
    textures:
      - ruby_sword.png
  Mechanics:
    durability:
      value: 2000
  AttributeModifiers:
    attack_damage:
      amount: 12
      slot: MAINHAND
    attack_speed:
      amount: 1.6
      slot: MAINHAND

Pones la textura ruby_sword.png en plugins/Oraxen/pack/textures/, y Oraxen automáticamente:

Crea un modelo JSON a partir de la textura que le diste
Asigna un CustomModelData único
Genera un paquete de recursos con el modelo
Registra el objeto en el sistema

Para darles objetos a los jugadores, usa /oraxen give [player] ruby_sword. También puedes añadirlos a kits, tiendas y tablas de botín mediante la API de Oraxen o placeholders.

Bloques y muebles personalizados

Oraxen admite cuatro tipos de bloques y muebles personalizados:

NoteBlock - bloques de tamaño completo con texturas propias (usa los estados del bloque de notas). Pueden tener dureza, un drop y una herramienta necesaria para romperlos
StringBlock - bloques transparentes (por ejemplo flores, pasto, decoraciones) que usan el cable trampa
Furniture - muebles 3D basados en entidades de visualización (1.19.4+) o soportes para armadura. Sillas, mesas, lámparas, televisores: cualquier modelo
MushroomBlock - un sistema de bloques más antiguo, compatible con versiones anteriores

Un ejemplo de definición de mueble:

lamp:
  displayname: "&eLámpara"
  material: PAPER
  Pack:
    generate_model: true
    textures:
      - lamp.png
  Mechanics:
    furniture:
      type: DISPLAY_ENTITY
      hitbox:
        width: 1
        height: 2
      light: 14
      placeable_on:
        - FLOOR

Los jugadores colocan los muebles con clic derecho mientras sostienen el objeto. Los muebles pueden emitir luz, tener hitboxes para interactuar y tener animaciones.

Paquete de recursos

Oraxen genera y distribuye el paquete de recursos de forma automática. La configuración está en settings.yml:

Pack:
  generation:
    auto-generated: true          # generate automatically
    compression: BEST_COMPRESSION # pack compression
  upload:
    type: polymath               # pack hosting
  dispatch:
    send_pack: true              # send to players
    mandatory: true              # force the download

Opciones de alojamiento del paquete de recursos:

Polymath - alojamiento gratuito de Oraxen (el predeterminado)
Self-host - tu propio servidor HTTP
Amazon S3 / DigitalOcean Spaces - alojamiento en la nube

Después de cada cambio en texturas u objetos, ejecuta /oraxen reload all. El plugin reconstruye el paquete y envía la versión actualizada a los jugadores.

Consejos e integraciones

Modelos 3D - Oraxen admite modelos JSON personalizados de Blockbench. Exporta el modelo como Java Block/Item y ponlo en pack/models/
Recetas de crafteo - define recetas personalizadas directamente en la config del objeto
Integración con MythicMobs - usa objetos personalizados de Oraxen como drops de jefes
Integración con tiendas - ShopGUI+ y otros plugins de tienda admiten objetos de Oraxen
Compatibilidad - Oraxen funciona con ProtocolLib en versiones antiguas y de forma nativa con Paper 1.20.5+

Alternativas: Nova (un framework para contenido personalizado), ItemsAdder (de pago, con funciones similares), CraftEngine (una edición Community gratuita con licencia GPL-3.0, compatible con 26.x y Folia). Oraxen destaca por su desarrollo activo.