ItemsAdder : objets et blocs custom sur votre serveur

Ce qu'est ItemsAdder

ItemsAdder est un plugin premium payant créé par un développeur qui se fait appeler LoneDev. Son but principal est de permettre aux admins de serveurs Minecraft d'ajouter leur propre contenu (objets, blocs, meubles, mobs, animations et overlays d'interface) sans que les joueurs aient à installer de mods.

Tout le mécanisme repose sur deux piliers : un resource pack envoyé automatiquement au joueur quand il rejoint le serveur, et des fichiers de configuration YAML où l'admin définit tous les éléments custom. Du côté du joueur, tout fonctionne comme dans Minecraft vanilla : il lui suffit d'accepter le resource pack.

Le plugin est disponible sur SpigotMC pour environ 25 EUR. C'est un investissement à envisager pour les serveurs RPG, les serveurs survie avec du contenu unique ou les serveurs à thème, où se démarquer est essentiel.

ItemsAdder est activement développé depuis 2019 et possède l'une des plus grandes communautés parmi les plugins premium. Sur SpigotMC, le plugin a réuni des milliers d'avis positifs et reçoit des mises à jour régulières pour les nouvelles versions de Minecraft.

Comment fonctionne le resource pack

Le cœur d'ItemsAdder est son propre resource pack, généré automatiquement par le plugin à partir de vos fichiers de configuration. Quand un joueur rejoint le serveur, Minecraft lui demande s'il veut télécharger le resource pack. Une fois qu'il accepte, il voit tous les objets, blocs et modèles custom.

ItemsAdder gère trois méthodes d'hébergement du resource pack :

• Serveur HTTP intégré - le plugin sert lui-même le fichier sur un port (8163 par défaut). La solution la plus simple sur un VPS avec sa propre IP. Elle demande d'ouvrir le port dans le pare-feu.
• Auto-hébergement via FTP/SFTP - vous envoyez le pack généré sur votre propre serveur web ou CDN. Plus de contrôle, mais plus de configuration.
• Hébergement externe - par exemple GitHub Releases, Dropbox ou des services dédiés à l'hébergement de resource packs. Utile quand votre hébergeur bloque les ports supplémentaires.

Le point clé : ItemsAdder utilise CustomModelData, un nombre attribué à un objet vanilla existant (par exemple un PAPER avec CustomModelData 1001 affiche le modèle d'une épée custom). Cette limite vient de l'architecture de Minecraft : jusqu'à la version 1.21.3, il n'existe aucune API officielle pour créer de nouveaux ID d'objets. À partir de la version 1.21.4, Minecraft a ajouté la prise en charge du composant item_model, qu'ItemsAdder utilise déjà.

Après chaque modification de la configuration, vous devez reconstruire le resource pack avec la commande /iazip ou /iareload. Le plugin compresse automatiquement les fichiers et met à jour l'URL, les joueurs reçoivent donc la nouvelle version à leur prochaine connexion.

Créer des objets

Vous définissez chaque objet custom dans un fichier YAML du dossier plugins/ItemsAdder/contents/. L'arborescence est entièrement libre, vous pouvez donc regrouper les objets par pack ou par thème.

Un exemple de définition d'épée custom :

info:
  namespace: moj_serwer
items:
  miecz_ognia:
    display_name: "Épée de feu"
    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:
      - "&7Forgée dans les flammes du Nether."
    events:
      interact:
        right:
          set_on_fire:
            duration: 5

Le champ namespace est un identifiant unique de votre pack de contenu, pour que les objets de packs différents n'entrent pas en collision. Le champ resource.material désigne l'objet vanilla qui « fait semblant » d'être votre modèle. Vous placez les textures dans le dossier contents/moj_serwer/textures/item/.

ItemsAdder gère :

• Les modèles 3D au format JSON (compatibles Blockbench)
• Les textures animées (mcmeta)
• La durabilité et la réparation custom
• Les effets de particules à l'utilisation
• Les sons liés aux actions
• Les événements, par exemple enflammer un joueur au coup ou soigner à la consommation
• L'intégration avec les systèmes de compétences (MMOItems, AureliumSkills)

Vous pouvez télécharger des packs d'objets tout prêts depuis le wiki officiel et sur Polymart, où la communauté partage des ensembles gratuits comme payants.

Créer des blocs

Créer des blocs custom est l'une des parties techniquement les plus difficiles du modding d'un serveur Minecraft. ItemsAdder la résout astucieusement : il utilise les états du bloc musical ou les états des blocs de champignon comme « conteneurs » pour les blocs custom.

Dans Minecraft, un bloc musical a 800 états uniques. ItemsAdder réserve ces états pour vos blocs : le joueur voit le modèle du resource pack, et le moteur du serveur voit un bloc musical dans un état précis. Résultat, les blocs se comportent comme de vrais blocs : on peut les récupérer, les poser et les miner à la bonne vitesse.

Un exemple de définition de bloc :

items:
  rubin_ore:
    display_name: "Minerai de rubis"
    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

Le type REAL_NOTE signifie qu'on utilise un état du bloc musical : le bloc est « réel », il a une collision, on peut se tenir dessus et le miner. Les alternatives sont REAL_TRANSPARENT (gère la transparence) et REAL_WIRE (basé sur le fil de déclenchement, pour les éléments fins).

Les blocs gèrent aussi les drops custom. Vous pouvez configurer votre minerai pour qu'il ne lâche son drop qu'à un niveau de minage précis ou avec un objet précis, ce qui s'accorde bien avec les systèmes RPG.

Mobs custom

ItemsAdder permet de créer des mobs custom avec leurs propres modèles 3D et animations. Les mobs se définissent à peu près comme les objets, dans des fichiers YAML qui référencent un modèle Blockbench.

Les modèles de mobs pour ItemsAdder se font dans Blockbench avec le plugin ItemsAdder. Le plugin gère un ensemble complet d'animations : marche, course, attaque, mort, repas et animations custom définies par le créateur.

La plus grande puissance apparaît avec l'intégration de MythicMobs. Vous pouvez attribuer un modèle ItemsAdder à un mob MythicMobs, et vous obtenez une créature à l'apparence unique, avec une IA avancée, des phases de combat, des attaques spéciales et des récompenses. Cette combinaison est utilisée sur des dizaines de serveurs RPG.

Un exemple de configuration de mob custom dans ItemsAdder :

info:
  namespace: moj_serwer
entity_models:
  smok_ognia:
    display_name: "Dragon de feu"
    model: entity/smok_ognia
    animations:
      walk:
        speed_multiplier: 1.0
      attack:
        duration: 1.2

Ensuite, dans MythicMobs, vous référencez ce modèle avec l'option Options.ItemsAdder: moj_serwer:smok_ognia. Le joueur voit un beau modèle 3D, et MythicMobs gère toute la logique de comportement.

Meubles et décorations

L'une des fonctions d'ItemsAdder les plus appréciées est son système de meubles. Les meubles sont des structures décoratives de plusieurs blocs (chaises, tables, lits, lampes, coffres) que vous pouvez placer dans le monde du jeu.

Techniquement, les meubles sont construits à partir de porte-armures invisibles auxquels sont attachés des modèles du resource pack. Ils peuvent ainsi avoir des dimensions custom, dépasser d'un seul bloc et être posés sous différents angles.

ItemsAdder est livré avec plusieurs ensembles de meubles, mais la vraie valeur est de pouvoir créer les vôtres. Vous exportez un modèle depuis Blockbench, vous configurez les hitboxes, et c'est terminé. Les meubles gèrent :

• S'asseoir (les joueurs peuvent s'asseoir sur une chaise ou un banc)
• La collision avec les joueurs (elle bloque le déplacement)
• Les interactions (ouvrir des placards, activer des mécanismes)
• La pose sur les murs et les plafonds (par exemple tableaux et lampes)
• La rotation dans 8 ou 16 directions

Les plugins FurnitureLib et FurnitureEngine sont des alternatives pour le système de meubles, mais ItemsAdder intègre tout dans un seul écosystème, ce qui élimine les problèmes de compatibilité entre plugins.

Emotes

ItemsAdder gère des emotes de joueur animées : de vraies animations du personnage que les autres joueurs voient en temps réel. Un joueur peut saluer, danser, rire ou exécuter n'importe quelle animation définie par l'admin.

Les emotes fonctionnent en remplaçant le modèle du joueur dans le resource pack et en jouant l'animation côté client. Pour rendre une emote visible aux autres, ItemsAdder utilise des astuces de protocole avec les métadonnées d'entité.

Exemples d'utilisation des emotes :

• Salutations VIP au spawn (une animation spéciale pour les donateurs)
• Animations de classe de personnage dans les jeux RPG (un magicien qui lance des sorts)
• Danses et gestes dans les zones sociales
• Animations de mort à la place de la chute par défaut du personnage

Les emotes peuvent être liées aux grades via LuckPerms, par exemple seuls les joueurs avec le grade VIP accèdent aux animations rares. C'est un élément courant de l'offre de monétisation des serveurs.

GUI et HUD

ItemsAdder inclut un système avancé pour créer des overlays sur l'interface du joueur (HUD). Vous pouvez afficher vos propres barres, icônes, compteurs et informations directement sur l'écran du joueur, sans plugin supplémentaire.

Le HUD d'ItemsAdder fonctionne en remplaçant la bossbar ou l'actionbar par une police Bitmap custom du resource pack. Résultat : le joueur voit à l'écran un overlay en pixel art qui ressemble à une partie de l'interface du jeu.

Utilisations typiques du HUD :

• Barre de mana/énergie - une ressource de sorts affichée à côté de la barre de vie
• Compteur de monnaie - un solde ou des points d'expérience dans un coin de l'écran
• Indicateur de température/faim/pollution - pour les serveurs survie avec des mécaniques de survie
• Mini-boussole - direction et coordonnées en haut de l'écran
• Notifications de succès - des bannières animées quand quelque chose est débloqué

Pour construire un HUD, vous pouvez utiliser l'éditeur intégré au plugin ou des outils externes comme HMCCosmetics. ItemsAdder fournit aussi une API pour les développeurs, afin que d'autres plugins puissent enregistrer leurs propres éléments de HUD.

Prix et licence

ItemsAdder est un plugin premium payant disponible uniquement sur la plateforme SpigotMC. Le prix actuel est d'environ 25 EUR par licence. Vérifiez le prix actuel sur la page SpigotMC, car il peut changer.

Votre achat vous donne :

• Une licence pour un serveur (une IP ou un réseau de proxy)
• L'accès à toutes les mises à jour, sans limite de durée
• L'accès au canal de support Discord officiel
• L'accès au wiki officiel avec la documentation

Points importants sur la licence :

• Chaque serveur a besoin d'une licence séparée, car une licence ne couvre pas une ferme de serveurs
• Les réseaux BungeeCord/Velocity peuvent compter comme une seule licence, mais mieux vaut le confirmer auprès de l'auteur
• Vous téléchargez le plugin depuis le panneau SpigotMC après l'achat, car le fichier .jar n'est pas disponible publiquement
• Il n'y a pas de version d'« essai ». Avant d'acheter, vous ne pouvez tester qu'en local, avec quelques limitations

Le prix peut sembler élevé à côté d'alternatives gratuites comme Oraxen CE (Community Edition), mais ItemsAdder offre bien plus de fonctions, une meilleure documentation et un support actif. Pour les serveurs qui ont un budget, c'est un investissement solide qui s'amortit vite grâce à une meilleure expérience de jeu.

Comparatif avec Oraxen

Le principal concurrent d'ItemsAdder est Oraxen. Pendant des années, le choix était « alternative gratuite contre premium payant », mais la situation s'est compliquée : Oraxen a introduit une offre premium payante (Oraxen Pro), tandis qu'ItemsAdder est resté à un prix fixe.

Quand choisir ItemsAdder : vous avez un budget, vous avez besoin d'emotes et d'un HUD étendu, vous voulez l'intégration native de MythicMobs, et vous tenez à un support professionnel et à une grande communauté de ressources.

Quand choisir Oraxen CE : vous n'avez aucun budget pour les plugins, vous n'avez besoin que d'objets et de blocs custom, et vous appréciez l'open source et la possibilité de modifier le code.

Compatibilité

ItemsAdder est compatible avec :

• Versions de Minecraft : 1.14 - 1.21.x (mises à jour en continu)
• Logiciels serveur : Paper (recommandé), Spigot, Purpur, Pufferfish
• Réseaux : BungeeCord, Velocity (le plugin s'installe séparément sur chaque backend)
• MythicMobs - intégration native des modèles et des mobs
• MMOItems - des stats custom liées aux objets IA
• AureliumSkills / AuraSkills - un système de compétences avec des objets IA
• LuckPerms - permissions pour les objets, les emotes et les grades
• EssentialsX - kits et boutiques avec des objets IA
• PlaceholderAPI - placeholders custom pour les HUD et les chats
• WorldGuard - protection de régions qui tient compte des blocs IA

Limites connues :

• Il ne fonctionne pas sur Bedrock Edition (Java uniquement)
• Il exige que le joueur accepte le resource pack, et les joueurs qui l'ont désactivé ne voient que les objets vanilla
• Les gros resource packs peuvent ralentir la connexion au serveur (temps de téléchargement)
• Les limites d'états du bloc musical/bloc de champignon plafonnent le nombre de blocs uniques (environ 800 pour le bloc musical + 54 pour le champignon)
• Il n'est pas compatible avec d'autres plugins qui utilisent les mêmes états de bloc musical sans intégration dédiée

Vous trouverez plus d'informations sur les plugins de serveur dans le catalogue de plugins. Si vous construisez un serveur RPG, jetez aussi un œil à MythicMobs : associer les deux plugins ouvre de belles possibilités pour créer des boss et des aventures uniques.