Team Cards

Team Cards

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.

The cards

Each suit grants passive buffs at Levels 1 and 2, and an activated ability at Level MAX
bound to a keybind.

• Hearts — bonus maximum health and extra saturation from food. At MAX, a burst of
  temporary health and regeneration.
• Clubs — bonus damage with axes and maces, and a mace reworked to swing at axe speed.
  Entirely passive; Clubs has no activated ability.
• Diamonds — Haste and Fortune behaviour on diamond tools without enchanting them,
  Speed from a full diamond set, and a Turtle Master burst at MAX.
• Spades — immunity to fall damage, then to explosion damage, and at MAX an upward wind
  burst that scatters enemies and shreds cobwebs.
• Joker — rare and ritual-only. It has no Level 1 or 2 at all. Instead, every member of
  a Joker team individually chooses one of three personal abilities: Ghost Blocks that
  only your own team can see or stand on, Remote Redstone that toggles a placed block
  from any distance and any dimension, or a One Inch Punch that lands your next bare-fist
  hit with enormous knockback. A Joker team is a handful of specialists rather than four
  copies of the same buff.

Levelling and rerolling

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.

Built against betrayal

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.

Interface

• A three-tab menu showing every team on the server with full rosters, your own card and its
  effects at every level, and all the mod’s crafting recipes.
• A HUD timer showing your ability’s remaining duration and cooldown, which hides itself
  entirely when you have no ability to use.
• Team colours applied to nametags, chat and the player list.
• An animated card reveal whenever your team is dealt or upgrades a card.

Server configuration

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.

Requirements

• Minecraft 26.2
• NeoForge
• Must be installed on the server and every client — it adds a custom interface, a HUD
  overlay and keybinds, so it cannot run server-side only. Keep versions matched.

FAQ

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.