OmegaTCG

OmegaTCG is a complete, fully configurable trading card game system for Minecraft 1.20+ servers. Players open card packs, discover collectible mob and item cards with animated reveal effects, track their progress in a GUI binder, and trade duplicate cards with others using a secure voucher system — everything is driven by simple YAML files, so adding content never requires a code change.

Core Features

• Collectible Card System — 38 ready-made cards across 8 categories (Animals, Mobs, Blocks, Tools, Weapons, Armour, Food, Miscellaneous) with 6 rarity tiers: Common, Uncommon, Rare, Epic, Legendary and Mythic.
• Configurable Packs — define unlimited pack types in YAML with per-card chances, rarity rules and custom item appearance. Four ready-made packs included (Common, Rare, Epic, Legendary).
• Cinematic Pack Opening — every rarity gets its own reveal animation with configurable particles, sounds, fireworks, titles, action bars and open duration. First-time discoveries get a grand celebration; duplicates get a shorter reveal.
• Binder GUI — a browsable collection GUI organised by category, showing owned/missing cards, per-category progress percentages and completion status.
• Duplicate Vouchers — duplicate cards automatically convert into tradeable vouchers that other players can right-click to claim, with no wasted pulls.
• Voucher Security — every voucher carries a unique UUID in its PersistentDataContainer, and redeemed IDs are persisted server-side, so creative-mode copies and dupes can never be redeemed twice.
• Milestones & Completion Rewards — configurable card-count milestones, category completion celebrations, per-rarity reward commands, and a global "TCG Master" reward for completing the entire collection. Rewards are console commands, so they integrate with any economy or reward plugin.
• Collection Statistics — a stats GUI (or chat output) showing cards owned, completion percentages and pack opening history, plus PlaceholderAPI placeholders for scoreboards and chat.

Admin Tooling

• Offline player support — /tcg give and /tcg givecard work on offline players; packs and reward grants are queued and delivered automatically when the player next joins.
• Server-wide distribution — /tcg giveall pack/card distributes to all online players with a configurable per-player delay to prevent lag, plus anti-spam protection.
• Random rewards — /tcg give random <player> [rarity] [category] draws a random card, filterable by rarity and/or category — perfect for events and giveaways.
• Detailed reload feedback — /tcg reload reports exactly how many cards, packs, rarities and categories loaded, lists every warning and configuration error with file and section details, and never lets one bad entry wipe valid data.
• Crash-safe pack opening — the rolled card is saved before the pack is consumed; disconnects, deaths and restarts mid-animation grant the result on next join.

Fully Configurable

• Add content without touching code — one YAML file per card, one per pack; drop in new files and reload. Custom rarities and categories are added purely through config and automatically get their own colours, glow, particles, sounds and fireworks.
• Mythic auto-generation — cards without a defined Mythic variant can be auto-generated from a template.
• Separate config files — main settings, messages, cards, packs and GUI layouts each live in their own file with in-game reload support.
• Every message customisable — all player-facing text, GUI titles and item names come from messages.yml.
• Pack cooldown — optional per-player cooldown between pack openings as a performance safeguard (disabled by default).

Commands

• /tcg binder — open your collection binder
• /tcg cards — browse all cards
• /tcg stats — view collection statistics
• /tcg give <player> <pack> [amount] — give packs (online or offline)
• /tcg givecard <player> <card> <rarity> — grant a collected card directly
• /tcg give random <player> [rarity] [category] — give a random card
• /tcg giveall pack/card <id> [amount] — distribute to all online players
• /tcg reload — reload all configs with a detailed summary

Requirements

• Paper (or Spigot) 1.20+
• PlaceholderAPI (optional, for placeholders)
• No other dependencies — data is stored in flat YAML files per player