Team Cards turns a Minecraft server into a contest between rival teams, each drawing on the power of a single playing card.
Players claim one of a fixed number of team slots, up to four players to a team. Claiming a slot deals that team a random suit — Hearts, Clubs, Diamonds or Spades — which they then level up to unlock progressively stronger team-wide abilities. A fifth card, the Joker, is rare and behaves unlike any of the others.
The mod is built for small servers where players fight each other. Every mechanic assumes teams are rivals, and several exist specifically to make betrayal costly.
Each suit grants passive buffs at Levels 1 and 2, and an activated ability at Level MAX bound to a keybind.
Cards are raised by crafting and consuming totems. Levels cannot be skipped, and totems are freely tradeable — including to rival teams, if you think that is a good idea.
Changing your suit requires building a Ritual Altar and gathering every member of your team inside its zone for a full minute, marked by a visible particle boundary. The reroll deals a new random suit, but resets the card back to Level 0. That reset is the real cost of rerolling, not the altar.
Teammates can still hit each other, so sparring and weapon testing work normally. But a single hit can never take a teammate below half a heart, and dealing too much damage to one inside a short window hits the attacker with Slowness and Weakness.
Leaving a team, being kicked, or disbanding starts a deserter lockout. During it you cannot join another team, and — importantly — you are still damage-capped and still take the betrayal penalty against your former teammates, while they may hit you freely. New members also receive no card buffs for a short warm-up period, so a maxed team cannot swap a specialist in mid-fight.
Every balance value in the mod is exposed in the server config file — 46 settings across eight sections. Cooldowns, ability durations, health bonuses, damage numbers, push strengths, the ritual length and radius, the deserter lockout, and the Joker's draw chance can all be retuned without recompiling anything. Durations are written in seconds, and every entry carries a comment explaining what it does.
Operators get commands for resizing the team pool, forcing a team's card, kicking players from any team, adding members, and reassigning team managers.
Can I include this in a modpack? Yes. You may include Team Cards in any modpack, public or private, without asking. Please link back to this project page.
Will you update it for newer Minecraft versions? Possibly. This mod is built primarily for my own server, and updates happen when I have time and reason to make them. Please treat any update as a bonus rather than an expectation.
Can I request a feature? You are welcome to ask, and requests will be read and considered at my own convenience. I make no commitment to implement anything, and features that do not suit a small PvP server are unlikely to be added.
Will you fix bugs? Genuine bugs are worth reporting and I will look at them when I can. Reports that include the server log and clear steps to reproduce are far more likely to get fixed.
Is it compatible with other mods? It should be, but it has only been tested in a lightly modded environment. Anything that deeply changes combat, attributes or chunk rendering is the most likely source of conflict.
Can I use the code? See the project licence.
Does it work in singleplayer? It loads and runs, but the mod is designed around several players competing. Most of it will not be meaningful alone.
