ItemsAdder

The plugin does not handle any texture. ItemsAdder provides the items, the plugin handles all the logic. The full guide and the list of the 102 expected IDs are in docs/ITEMSADDER.md.

Four ready-to-install packs are provided: itemsadder-pack/ (English textures: card name plates and pack labels in English), itemsadder-pack-fr/ (French), itemsadder-pack-es/ (Spanish) and itemsadder-pack-de/ (German). Item IDs are identical: install only one of them into plugins/ItemsAdder/contents/, then run /iazip. Each pack contains the textures of the 90 cards (item and large versions) and their holo versions, the 5 packs, the 7 boosters, the full-screen opening animation images, and textured menu backgrounds (binder cover and pages).

In short:

• Expected IDs: tcg:<collection>_pack for packs, tcg:<card id> for cards (e.g. tcg:nature_panda) and tcg:<booster id> for boosters. Optional: tcg:<card id>_holo for holo versions.
• A ready-to-use template is copied to plugins/TCG/itemsadder/tcg_items.yml.
• When ItemsAdder items are loaded (and after each /iareload), TCG lists in the console the expected IDs that cannot be found. Those use the fallback item.
• Without ItemsAdder, the plugin works fully with vanilla items (paper for cards, enchanted book for packs).
• itemsadder.recognize_raw_items: true: an ItemsAdder item given outside the plugin (/iagive tcg:nature_pack, loot table...) is also recognized as a valid pack or card.

The ItemsAdder API is called through reflection, only from fr.tcg.itemsadder.ItemsAdderHook. No compile-time dependency, and no ItemsAdder call anywhere else in the code.

Version française

Every pack, booster and card can be an ItemsAdder item. The plugin fetches it by its ID, adds its PDC mark (tcg:card_id / tcg:pack_id / tcg:booster_id, plus tcg:holo for a holo card) and, by default, its lore (rarity, collection, number). Four complete ready-to-install packs are provided: itemsadder-pack/ (English textures: card name plates and pack labels in English), itemsadder-pack-fr/ (French), itemsadder-pack-es/ (Spanish) and itemsadder-pack-de/ (German). The IDs are identical: install only one of them into plugins/ItemsAdder/contents/, then run /iazip.

Setup

With one of the provided packs, steps 1 and 2 are already done. To create your own items:

1. Copy the template plugins/TCG/itemsadder/tcg_items.yml (created on first startup, also in src/main/resources/itemsadder/) to: plugins/ItemsAdder/contents/tcg/configs/tcg_items.yml
2. Put the PNG textures at the paths given in the file, under plugins/ItemsAdder/contents/tcg/textures/:
   • item/packs/<collection>_pack.png (5 packs)
   • item/boosters/<booster>.png (7 boosters)
   • item/cards/<collection>/<mob>.png (90 cards)
   • item/cards_holo/<collection>/<mob>.png (90 holo versions, optional)
   • item/cards/unknown.png (optional placeholder)
3. /iazip then /iareload (or restart).
4. When the items are loaded, TCG prints in the console:
   • a message confirming that all 102 expected items are present (101 on 1.21.11 / 26.1, where the Sulfur Cube card is hidden), or
   • the exact list of IDs that cannot be found. Those use the vanilla fallback item in the meantime.

Example ItemsAdder entry:

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

Rules

• IDs come from groups.yml (pack_itemsadder) and cards.yml (itemsadder_item, default <itemsadder.default_namespace>:<card id>). Changing an ItemsAdder ID does not break cards already handed out: they are identified by their TCG card ID, not by the ItemsAdder ID.
• items.override_itemsadder_name: false (default) keeps the name defined in ItemsAdder; true forces the name from cards.yml.
• items.apply_lore: true adds the TCG lore after any ItemsAdder lore.
• Placeholder for undiscovered cards: items.unknown_card_itemsadder: "tcg:unknown_card" (optional).
• Collection icon in the menu: icon_itemsadder in groups.yml (optional).
• itemsadder.recognize_raw_items: true: a tcg:... item obtained outside the plugin (/iagive, loot table, store) is accepted as a pack, booster or card (not as a holo card: use /tcg give <card> 1 holo).
• Boosters: boosters.yml > itemsadder (default tcg:<booster id>).
• Holo cards: item <card item><holo.itemsadder_suffix> (default tcg:nature_cow_holo). Optional and not part of the expected items list: without it, the holo card keeps the normal texture with the enchantment glint and an iridescent name.
• ItemsAdder loads its items after the plugins have started. Until it is done, TCG uses the fallback items, then switches automatically (ItemsAdderLoadDataEvent event).

Full list of expected IDs

Optional placeholder: tcg:unknown_card

Packs

Boosters

Full-screen opening animation (font images, 1.4)

Shown one at a time in the subtitle, 64x64 px (scale_ratio: 64, y_position: 44). If one of them is missing, TCG uses the text animation instead (enable debug to see which one).

A custom booster or card needs its own frames to use the full-screen animation.

Cards

Nature (nature, 35 cards)

Pack: tcg:nature_pack

Monsters (monsters, 29 cards)

Pack: tcg:monsters_pack

Nether (nether, 11 cards)

Pack: tcg:nether_pack

End (end, 4 cards)

Pack: tcg:end_pack

Special (special, 11 cards)

Pack: tcg:special_pack

tcg:monsters_sulfur_cube (mob added in Minecraft 26.2) is only used on 26.2 and newer servers.