Discord
Oraxen
Wiki - Plugins

Oraxen : objets et blocs personnalisés

Oraxen permet de créer des objets, blocs, meubles, chapeaux et outils entièrement nouveaux sur les serveurs Minecraft, sans exiger de mods chez les joueurs. Le plugin s'appuie sur les resource packs et CustomModelData pour afficher des modèles 3D personnalisés.

Temps de lecture : ~6 min Plateforme : Paper / Spigot / Purpur

Qu'est-ce qu'Oraxen

Oraxen est un plugin qui permet de créer des objets, blocs, meubles et équipements personnalisés sur les serveurs Minecraft. Il n'exige aucun mod côté client : à la place, il génère un resource pack et l'envoie automatiquement aux joueurs lorsqu'ils se connectent.

Le plugin utilise CustomModelData (depuis Minecraft 1.14) et les composants d'objet (1.20.5+) pour donner à des objets vanilla l'apparence d'objets totalement nouveaux. Côté serveur, chaque objet personnalisé reste un objet Minecraft (par exemple une épée en bois avec le CustomModelData 1001), mais le client l'affiche avec une texture et un modèle 3D personnalisés.

Oraxen est disponible sur GitHub. Vous pouvez le télécharger sur SpigotMC ou Modrinth.

Comment ça marche en coulisses

Oraxen combine trois mécanismes de Minecraft :

  • CustomModelData / composants d'objet - permet d'attribuer un modèle 3D personnalisé à un objet existant. Le client affiche le modèle du resource pack à la place du modèle par défaut
  • Resource pack - Oraxen génère automatiquement un resource pack avec les textures et les modèles. Le serveur l'héberge et impose son téléchargement à la connexion d'un joueur
  • États du bloc musical / du bloc de champignon - les blocs personnalisés utilisent des états inutilisés du bloc musical ou du bloc de champignon pour afficher des textures uniques

Grâce à cette approche, les joueurs n'ont aucun mod à installer. Ils doivent seulement accepter le resource pack du serveur. Le plugin est entièrement compatible avec le client Minecraft vanilla.

Créer des objets

Les objets personnalisés se définissent dans des fichiers YAML placés dans plugins/Oraxen/items/ :

# ruby_sword.yml
ruby_sword:
  displayname: "&cRuby Sword"
  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

Vous placez la texture ruby_sword.png dans plugins/Oraxen/pack/textures/, puis Oraxen s'occupe automatiquement de :

  1. Créer un modèle JSON à partir de la texture fournie
  2. Attribuer un CustomModelData unique
  3. Générer un resource pack contenant le modèle
  4. Enregistrer l'objet dans le système

Pour donner des objets aux joueurs, utilisez /oraxen give [player] ruby_sword. Vous pouvez aussi les ajouter à des kits, des boutiques et des tables de butin via l'API d'Oraxen ou des placeholders.

Blocs personnalisés et meubles

Oraxen prend en charge quatre types de blocs personnalisés et de meubles :

  • NoteBlock - blocs pleins avec leurs propres textures (ils utilisent les états du bloc musical). Ils peuvent avoir une dureté, un butin et un outil requis pour les casser
  • StringBlock - blocs transparents (par exemple fleurs, herbe, décorations) qui utilisent le fil de déclenchement
  • Furniture - meubles 3D basés sur les entités d'affichage (1.19.4+) ou sur des porte-armures. Chaises, tables, lampes, télévisions : tous les modèles sont possibles
  • MushroomBlock - un ancien système de blocs, compatible avec les versions antérieures

Exemple de définition d'un meuble :

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

Les joueurs placent un meuble par un clic droit en tenant l'objet en main. Les meubles peuvent émettre de la lumière, avoir des hitboxes pour l'interaction et proposer des animations.

Resource pack

Oraxen génère et distribue le resource pack automatiquement. La configuration se trouve dans settings.yml :

Pack:
  generation:
    auto-generated: true          # générer automatiquement
    compression: BEST_COMPRESSION # compression du pack
  upload:
    type: polymath               # hébergement du pack
  dispatch:
    send_pack: true              # envoyer aux joueurs
    mandatory: true              # imposer le téléchargement

Options d'hébergement du resource pack :

  • Polymath - hébergement gratuit proposé par Oraxen (option par défaut)
  • Self-host - votre propre serveur HTTP
  • Amazon S3 / DigitalOcean Spaces - hébergement dans le cloud

Après chaque modification des textures ou des objets, exécutez /oraxen reload all. Le plugin reconstruit le pack et envoie la version à jour aux joueurs.

Conseils et intégrations

  • Modèles 3D - Oraxen prend en charge les modèles JSON personnalisés créés avec Blockbench. Exportez le modèle au format Java Block/Item et placez-le dans pack/models/
  • Recettes de craft - définissez des recettes personnalisées directement dans la config de l'objet
  • Intégration MythicMobs - utilisez des objets Oraxen personnalisés comme butin de boss
  • Intégration des boutiques - ShopGUI+ et d'autres plugins de boutique prennent en charge les objets Oraxen
  • Compatibilité - Oraxen fonctionne avec ProtocolLib sur les anciennes versions et nativement avec Paper 1.20.5+

Alternatives : Nova (un framework de contenu personnalisé), ItemsAdder (payant, fonctions similaires), CraftEngine (édition Community gratuite sous licence GPL-3.0, compatible avec 26.x et Folia). Oraxen se distingue par son développement actif.