ItemsAdder : objets, blocs et meubles personnalisés sur son serveur

ItemsAdder ajoute à un serveur Paper des objets, des blocs, des meubles, des émojis et des interfaces qui n'existent pas dans Minecraft, sans que les joueurs installent le moindre mod. Tout passe par un pack de ressources que le serveur envoie à la connexion. C'est l'un des plugins les plus utilisés pour donner une identité visuelle à un serveur.

Ce qu'il permet

• Des objets : armes, outils, nourriture, avec leur texture et leur modèle 3D.
• Des blocs : minerais, décorations, qui se posent et se cassent comme des blocs normaux.
• Des meubles : chaises où l'on s'assoit, tables, lampes.
• Des émojis et des polices utilisables dans le chat, les noms et les menus.
• Des interfaces : menus personnalisés, barres d'affichage à l'écran (HUD).

Il fonctionne sur Paper (et ses dérivés) : voir Paper, Spigot, Purpur ou Fabric.

Installation

ItemsAdder est un plugin payant, vendu par son auteur sur les grandes plateformes de plugins. Il dépend d'autres plugins, dont ProtocolLib : la page du plugin donne la liste exacte pour votre version, installez-les tous.

1. Déposez ItemsAdder et ses dépendances dans plugins/, démarrez le serveur une fois.
2. Choisissez comment le pack de ressources sera hébergé (voir plus bas).
3. Générez le pack : /iazip.
4. Reconnectez-vous : le jeu propose de télécharger le pack.

/ia ouvre le menu des objets disponibles, /iaget <objet> en donne un.

Créer un premier objet

Les contenus se rangent par espace de noms (votre serveur, par exemple) dans le dossier contents du plugin. Un fichier de configuration décrit l'objet :

info:
  namespace: monserveur
items:
  epee_rubis:
    display_name: "&cÉpée de rubis"
    resource:
      material: DIAMOND_SWORD
      generate: false
      model_path: item/epee_rubis

La texture et le modèle se placent dans le dossier de ressources de cet espace de noms. Après chaque modification : /iazip pour reconstruire le pack. Le validateur YAML repère les erreurs d'indentation avant qu'elles n'empêchent l'objet de se charger.

La documentation officielle d'ItemsAdder détaille chaque option : comportements, recettes, dégâts, sons. Suivez celle de votre version, la structure des dossiers a évolué au fil des mises à jour.

Héberger le pack de ressources

Le pack doit être téléchargeable par les joueurs. Deux solutions :

• L'hébergement intégré : ItemsAdder sert le pack lui-même, sur un port à ouvrir en plus de celui du jeu. Simple, mais pensez au pare-feu et à la redirection de port si vous êtes chez vous.
• Un hébergement externe : le pack est déposé ailleurs, et le serveur donne son adresse. Plus robuste quand beaucoup de joueurs se connectent en même temps.

Pour obliger les joueurs à l'accepter, activez require-resource-pack dans server.properties (le générateur de server.properties l'explique). Un joueur qui refuse verrait des objets sans texture.

Les pièges

• Deux plugins de contenu en même temps (ItemsAdder et Oraxen, par exemple) : leurs packs de ressources se marchent dessus. Choisissez-en un.
• Les autres packs : si un autre plugin envoie aussi un pack (un plugin de musique, par exemple), fusionnez-les, sinon le dernier envoyé remplace l'autre.
• Les joueurs Bedrock : avec Geyser, les objets personnalisés demandent une conversion du pack et une configuration spécifique ; sans elle, ils voient des objets de base. Testez avec un compte Bedrock avant d'annoncer quoi que ce soit.
• Les performances : les meubles sont des entités. Des centaines de chaises dans une ville se sentent sur les TPS ; un profil Spark le confirmera.
• La taille du pack : un pack de 100 Mo décourage les joueurs sur mobile ou en 4G. Compressez les textures, supprimez ce qui ne sert pas.

ItemsAdder ou Oraxen ?

Les deux font la même chose avec une philosophie différente : ItemsAdder est très complet et fourni avec des contenus prêts à l'emploi, Oraxen mise sur des fichiers simples et un hébergement du pack automatique. Pour la liste des autres plugins utiles, voir Les plugins Minecraft les plus populaires.