What's new

What's new in 1.5

• Expansions (DLC): drop an expansion folder into plugins/TCG/expansions/ (e.g. expansions/wildlife_1/), install its ItemsAdder pack, then /tcg reload and /iazip. Its collections, cards and boosters are added to yours without touching your groups.yml, cards.yml or boosters.yml. /tcg expansions lists what is installed.
  • Each expansion has an expansion.yml (id, name, version, author, requires) and its own groups.yml, cards.yml, boosters.yml (same format as the plugin files), plus lang/fr/, lang/es/ and lang/de/ for French, Spanish and German servers.
  • gui_slot: auto places the collection in the first free slot of the main menu. If the menu is full (more than 20 expansions with 3 rows), the collection still loads without a slot: in BOOK mode (default) the gallery shows it as usual; in the other modes a console warning suggests raising gui.main.rows and the collection still opens with /tcg collection <id>. A hand-written invalid gui_slot is still an error.
  • An expansion that is broken, needs a newer plugin, or reuses an existing id is skipped as a whole with a console warning: it never prevents the rest from loading.
• The opening animation always uses the card backs of the base pack, so expansion boosters only ship their own frames.
• Open binder (gui.collection.mode: BOOK, new default): /tcg opens a gallery of the collections, one large illustrated tile per collection (6 per page, expansions included). Clicking a tile opens that collection: two pages of 4 cards each, cards drawn in their sleeves (backs colored by rarity for missing ones), page turning animation, and clicking an owned card shows it in large format with arrows to browse the others. Without ItemsAdder the same layout works with normal item icons. Optional collection tabs: book.tab_slots.
• Full-screen binder: with ProtocolLib (already required by ItemsAdder), the binder menus hide the player's items underneath and the textures cover the whole window, so it looks like a real menu. Visual only: nothing moves on the server, the real inventory is sent back when the menu closes. gui.collection.hide_player_inventory: false to disable. Navigation buttons are drawn in the textures (invisible items carry the tooltips).
• Paid expansions advertised in the gallery (store in config.yml): each listed expansion that is not installed shows a greyed tile with a question mark; clicking it sends its purchase link in the chat (clickable). Put your store link in store.expansions.<id>.url (empty = "coming soon"), or show_locked_expansions: false to hide them. Installing the expansion replaces the locked tile with the real collection.

Available expansions

Each species (mythic:... mob) belongs to a single expansion. All 27 are advertised in store.expansions (locked gallery tiles: 6 pages of 6 tiles, 4 pages of 9 in full screen, with the 5 base collections); an existing server gets the new entries automatically on startup (missing keys are filled in from the jar). The former realm_1 (Knights and Brigands) and horde_1 (Orcs and Goblins) expansions are replaced by one expansion per faction: remove their realm_1 / horde_1 entries from store.expansions on an already configured server.

Faction boosters: with 5 cards in the collection, a booster of 5 independent draws would almost complete the collection with the first purchase (and give many duplicates), so the 5-card factions use a 3-card booster (150 dust, rare or better guaranteed), like the base pack's booster_3; the ore golems (8 cards, 2 legendaries) keep the 5-card booster (250).

Boss booster (Kharzûl, 3 cards: the Titan, legendary, and his two epic servants): 3 cards for 250 dust. Every card is epic or better, so the epic guarantee is always met and the price sits above the factions' 150. The Titan comes from the normal rarity roll (epic 7 against legendary 1, about one booster in three holds him): rare, never out of reach. The Kharzûl pack drops 1 time in 10 from the Titan and his servants, since the boss itself is very rare. The Glutton Lord's Banquet (4 cards: the Baron, legendary, and his three epic servants) follows the same rules: a 3-card booster for 250, pack 1 time in 10.

What's new in 1.4

• Full-screen opening animation (ItemsAdder): every pack and booster shakes faster and faster, glows, tears open and bursts; then each card appears back first, glows in the color of its rarity (longer for rarer cards), flips and shows its face, with the card name in the action bar. Holo cards sparkle. Sneak to skip. Falls back to the text animation when ItemsAdder or an image is missing (packs.animation.style: TEXT forces it).
• One booster per collection: Nature, Monsters, Nether, End and Special boosters (5 cards, at least one Rare, 200 dust), with their own textures. Booster x3 and Premium Booster x5 have a new design.

Upgrading from 1.3:

1. Replace the jar with TCGPlugin-1.5.0.jar and restart. The new packs.animation options are added to your config.yml automatically.
2. ItemsAdder: reinstall itemsadder-pack/contents/tcg (or itemsadder-pack-fr/), then /iazip. The animation frames are font images: until the new pack is installed, the text animation is used.
3. boosters.yml is never overwritten: to sell the new collection boosters, copy the booster_nature to booster_special entries from the default file (/tcg language backups or the jar) into yours.

What's new in 1.3

• English by default, French included: language: en|fr option in config.yml, /tcg language <en|fr> command (automatic backup of the current files to plugins/TCG/backups/language-<timestamp>/, see Language).
• Two ItemsAdder packs: itemsadder-pack/ (English textures, card name plates and pack labels in English) and itemsadder-pack-fr/ (French). Same item IDs: install only one of them.
• Console and admin validation messages are now in English.

Upgrading from 1.2:

1. Replace the jar with TCGPlugin-1.3.0.jar and restart. Collections and the database are kept as they are.
2. Your config.yml has no language key, so the server stays in French: nothing changes for your players.
3. To switch to English: /tcg language en (your current files are backed up first; see Language).
4. To get English textures: install itemsadder-pack/ in place of the old pack in plugins/ItemsAdder/contents/, then /iazip.

What's new in 1.2

• Admin tools: /tcg inspect, history, markethistory, takecard, forgetcard, takedust, setdust, reset, on online or offline players.
• Trade history in the database (table tcg_trades), viewable with /tcg history <player>.
• MySQL / MariaDB to share collections across the servers of a network.
• Textured and configurable menus: recycle, shop, trade, auction house and objectives have an ItemsAdder background (pack provided) and slots, materials and buttons adjustable in config.yml > gui.*.
• Holo binder with large holo images, progress, reward and dedicated titles.
• /tcg show, auction house, Vault, daily and weekly objectives.

Upgrading from 1.1:

1. Replace the jar with TCGPlugin-1.2.0.jar and restart. The database is migrated automatically.
2. New config.yml options and new texts are taken from the jar automatically; objectives.yml is created.
3. The holo binder button is on slot 26 of the main menu: if one of your collections is there, the button is hidden (warning at startup); change gui.main.holo_slot.
4. ItemsAdder: reinstall itemsadder-pack/contents/tcg (backgrounds of the new menus, holo cover, 90 large holo cards), then /iazip.

What's new in 1.1 and upgrading from 1.0

Features: trades, recycling and dust shop, boosters (including seasonal ones), holo cards, milestones at 25 / 50 / 75%, titles, leaderboards, statistics, viewing other players' binders, PlaceholderAPI. The "Owned: xN" counter now follows trades and recycling.

Upgrade:

1. Replace the jar with TCGPlugin-1.1.0.jar and restart (no /reload).
2. The SQLite database is migrated automatically, without loss.
3. config.yml and messages.yml: new options and new texts are taken from the jar automatically, your existing settings and texts are kept. The help text (help) therefore stays the one in your file: to see the new commands in /tcg help, delete the help section of messages.yml (it will be taken from the jar) or add the lines by hand.
4. boosters.yml is created at startup (two example boosters, for sale in the shop; boosters: {} to offer none).
5. By default, milestones give packs (1, 2, 3) and are caught up on join for players who are already advanced (milestones_retroactive). Adjust milestones before going live if that is not what you want.
6. ItemsAdder: reinstall the itemsadder-pack/contents/tcg folder (boosters and 90 holo cards added), then /iazip.

Fixes included:

• A messages.yml text missing from the server's file (key added by an update) was shown empty instead of falling back to the jar value. Same for config.yml options read with a default value.
• If a player disconnected during the pack opening animation, the collection completion reward (already marked as given in the database) was never handed out.