ItemsAdder

Le plugin ne gère aucune texture. ItemsAdder fournit les items, le plugin gère toute la logique. Le guide complet et la liste des 102 IDs attendus sont dans docs/ITEMSADDER.md.

Quatre packs prêts à installer sont fournis : itemsadder-pack-fr/ (textures en français : plaques de nom des cartes et libellés des paquets), itemsadder-pack/ (anglais), itemsadder-pack-es/ (espagnol) et itemsadder-pack-de/ (allemand). Les IDs des items sont identiques : installez un seul des quatre dans plugins/ItemsAdder/contents/, puis /iazip. Chaque pack contient les textures des 90 cartes (versions item et grand format) et de leurs versions brillantes, des 5 paquets, des 7 boosters, les images de l'animation plein écran d'ouverture et les fonds texturés des menus (couverture et pages du classeur).

En résumé :

• IDs attendus : tcg:<collection>_pack pour les paquets, tcg:<id de carte> pour les cartes (ex. tcg:nature_panda) et tcg:<id du booster> pour les boosters. Facultatif : tcg:<id de carte>_holo pour les versions brillantes.
• Un modèle prêt à l'emploi est copié dans plugins/TCG/itemsadder/tcg_items.yml.
• Au chargement des items ItemsAdder (et après chaque /iareload), TCG liste dans la console les IDs attendus mais introuvables. Ceux-là utilisent l'item de repli.
• Sans ItemsAdder, le plugin fonctionne entièrement avec des items vanilla (papier pour les cartes, livre brillant pour les paquets).
• itemsadder.recognize_raw_items: true : un item ItemsAdder donné hors du plugin (/iagive tcg:nature_pack, loot table...) est aussi reconnu comme paquet ou carte valide.

L'API ItemsAdder est appelée par réflexion, uniquement depuis fr.tcg.itemsadder.ItemsAdderHook. Aucune dépendance de compilation, et aucun appel ItemsAdder ailleurs dans le code.

English version

Chaque paquet, booster et carte peut être un item ItemsAdder. Le plugin le récupère par son ID, y ajoute sa marque PDC (tcg:card_id / tcg:pack_id / tcg:booster_id, plus tcg:holo pour une brillante) et, par défaut, son lore (rareté, collection, numéro). Quatre packs complets prêts à installer sont fournis : itemsadder-pack-fr/ (textures en français), itemsadder-pack/ (anglais), itemsadder-pack-es/ (espagnol) et itemsadder-pack-de/ (allemand). Les IDs sont identiques : installez un seul des quatre dans plugins/ItemsAdder/contents/, puis /iazip.

Mise en place

Avec un des packs fournis, les étapes 1 et 2 sont déjà faites. Pour créer vos propres items :

1. Copier le modèle plugins/TCG/itemsadder/tcg_items.yml (créé au premier démarrage, aussi dans src/main/resources/itemsadder/) vers : plugins/ItemsAdder/contents/tcg/configs/tcg_items.yml
2. Placer les textures PNG aux chemins indiqués dans le fichier, sous plugins/ItemsAdder/contents/tcg/textures/ :
   • item/packs/<collection>_pack.png (5 paquets)
   • item/boosters/<booster>.png (7 boosters)
   • item/cards/<collection>/<mob>.png (90 cartes)
   • item/cards_holo/<collection>/<mob>.png (90 versions brillantes, facultatif)
   • item/cards/unknown.png (placeholder optionnel)
3. /iazip puis /iareload (ou redémarrer).
4. Dans la console, TCG affiche au chargement des items :
   • ItemsAdder : les 102 items attendus sont tous présents. (101 en 1.21.11 / 26.1, où la carte Cube de soufre est masquée), ou
   • la liste exacte des IDs introuvables. Ceux-là utilisent l'item vanilla de repli en attendant.

Exemple d'entrée ItemsAdder :

info:
  namespace: tcg
items:
  nature_panda:
    display_name: "Panda"
    resource:
      material: PAPER
      generate: true
      textures:
        - item/cards/nature/panda.png

Règles

• Les IDs viennent de groups.yml (pack_itemsadder) et cards.yml (itemsadder_item, défaut <itemsadder.default_namespace>:<id de carte>). Changer un ID ItemsAdder ne casse pas les cartes déjà distribuées : elles sont identifiées par leur ID de carte TCG, pas par l'ID ItemsAdder.
• items.override_itemsadder_name: false (défaut) garde le nom défini dans ItemsAdder ; true impose le nom de cards.yml.
• items.apply_lore: true ajoute le lore TCG après le lore ItemsAdder éventuel.
• Placeholder des cartes non découvertes : items.unknown_card_itemsadder: "tcg:unknown_card" (optionnel).
• Icône d'une collection dans le menu : icon_itemsadder dans groups.yml (optionnel).
• itemsadder.recognize_raw_items: true : un item tcg:... obtenu hors du plugin (/iagive, loot table, boutique) est accepté comme paquet, booster ou carte (pas comme carte brillante : utilisez /tcg give <carte> 1 holo).
• Boosters : boosters.yml > itemsadder (défaut tcg:<id du booster>).
• Cartes brillantes : item <item de la carte><holo.itemsadder_suffix> (défaut tcg:nature_cow_holo). Facultatif et absent de la liste des items attendus : sans lui, la brillante garde la texture normale avec la brillance d'enchantement et un nom irisé.
• ItemsAdder charge ses items après le démarrage des plugins. Tant qu'il n'a pas fini, TCG utilise les items de repli, puis bascule automatiquement (évènement ItemsAdderLoadDataEvent).

Liste complète des IDs attendus

Placeholder optionnel : tcg:unknown_card

Paquets

Boosters

Animation plein écran d'ouverture (font images, 1.4)

Affichées une par une dans le sous-titre, 64x64 px (scale_ratio: 64, y_position: 44). S'il en manque une, TCG utilise l'animation texte à la place (activer debug pour savoir laquelle).

Un booster ou une carte ajoutés à la main ont besoin de leurs propres images pour profiter de l'animation plein écran.

Cartes

Nature (nature, 35 cartes)

Paquet : tcg:nature_pack

Monstres (monsters, 29 cartes)

Paquet : tcg:monsters_pack

Nether (nether, 11 cartes)

Paquet : tcg:nether_pack

End (end, 4 cartes)

Paquet : tcg:end_pack

Spéciales (special, 11 cartes)

Paquet : tcg:special_pack

tcg:monsters_sulfur_cube (mob apparu en Minecraft 26.2) n'est utilisé que sur les serveurs 26.2 et plus récents.