Deck archetypes

Royal Hogs bridge spam, Hog cycle, Log Bait - the names players use, on every deck Elixir serves, and understood when a person says one.

Players talk about decks by name, and Elixir speaks the language in both directions. Every deck object it serves, on battles_query, battles_decks (the one deck asked for by deck_hash; its list rows carry the label alone, archetype_label) and players_summary: carries an archetype: the deck's family and win condition(s), a descriptive label composed from them, and the average elixir the deck runs at. And a name a person uses, a family, a label, or a community name like LavaLoon, is understood by the archetype argument of battles_decks, which narrows a list to that shape.

"archetype": {
  "family": "bridge_spam",
  "win_conditions": [{ "id": 26000059, "name": "Royal Hogs", "form": "evolution" }],
  "label": "Evo Royal Hogs bridge spam",
  "average_elixir": 3.62,
  "basis": "cards and the catalog's current elixir costs; the win condition's form is in the label, other cards' forms are not",
  "grammar_version": "2026-09",
  "roles_version": "2026-09-20T17:51:59.000Z"
}

A label is a noun, never a verdict. It is Elixir's descriptive name for the deck's shape, built from what the community means by each word; it is not a claim about what players call that exact eight cards, and it says nothing about how the deck performs. There is no matchup table and no "family X beats family Y" anywhere in Elixir, on purpose.

Two layers, kept apart

The community keeps two things separate, and so does Elixir.

Families are a small, stable taxonomy that the deck sites filter on and every guide teaches, beatdown, control, cycle, bait, bridge spam, siege, plus unclassified for a deck whose cards carry no cost at all. A deck has one family. Some guides add "hybrid"; here a deck may carry two win conditions, which is how a hybrid shows.

Named decks: "2.6 Hog", "LavaLoon", "PEKKA Bridge Spam", "Splashyard", are hand-curated titles for particular card sets. Deck Shop titles each exact deck by hand; no site publishes a rule for them. Elixir does not assert one: it never labels a deck "LavaLoon". It understands those names when a person uses them (see resolving, below).

The grammar

<win condition(s)> <family>: "Royal Hogs bridge spam", "Hog Rider cycle", "Lava Hound Balloon beatdown", "X-Bow siege". The win condition's form is said the way players say it, "Evo Royal Hogs bridge spam", "Hero Musketeer control", and other cards' forms are not, so two deck identities that differ only in a support card's form share a label. A deck with no attested win condition is named by its cost alone: "Cycle", "Control", "Beatdown".

Composition, in order:

1. The win conditions in the deck, by priority. A siege building anchors first, then the heavy tanks (Golem, Lava Hound, Electro Giant, Goblin Giant, Elixir Golem, Three Musketeers, in that order), then Graveyard, then Giant and Royal Giant, Balloon, Sparky, then a Goblin Barrel with a real bait package (two or more bait units), then P.E.K.K.A and Mega Knight, then light bait (a Barrel with one bait unit, Skeleton Barrel), then the chip and bridge win conditions (Hog Rider, Ram Rider, Royal Hogs, Battle Ram, Miner, Goblin Drill, Wall Breakers, Minion Giant), then the newer bridge cards (Elite Barbarians, Boss Bandit, Ronin), then Goblinstein, then Rocket, which names a deck only with no troop or building win condition in it. A Golem names the deck before the Miner beside it.
2. The family the anchor implies, with three tests: a Goblin Barrel is bait only with at least one bait unit beside it (a lone barrel is chip); P.E.K.K.A, Mega Knight, Ram Rider, Elite Barbarians, Boss Bandit and Ronin are bridge spam only with a bridge partner beside them (Bandit, Battle Ram, Royal Ghost, Royal Hogs, Prince, Dark Prince, Lumberjack, Golden Knight, Boss Bandit, Ronin, Mighty Miner…), else control; and Hog Rider, Royal Hogs, Royal Giant, Balloon, Miner, Goblin Drill, Wall Breakers, Minion Giant, Goblinstein and Rocket are cycle when the deck's average elixir is at or under the cycle bound, else their usual family.
3. A paired second win condition, when present: Balloon beside Lava Hound (LavaLoon), Sparky beside Goblin Giant or Giant, Wall Breakers beside Miner (which makes it cycle), Giant beside Graveyard (which makes it beatdown, the community's "Giant Graveyard").
4. No win condition: by cost, at or under the cycle bound cycle, 4.0 and over beatdown, between them control, led by the card that names the deck when one is present: "Rune Giant beatdown" for a deck whose tower damage is chip from enchanted troops behind the tank. Such a card (named_by) is not a win condition and never anchors over one; win_conditions stays empty.

secondary_win_conditions[] carries every other attested win condition in the deck, by priority, what the label leaves out, so "Miner control" can be said as "Miner control, with Goblin Barrel and Boss Bandit" without reading the cards.

The average excludes Mirror (it has no cost), as the deck sites do, and uses the catalog's current costs: a balance change re-prices history, which is how the sites read it too.

The cycle bound

The descriptive grammar uses a fixed cycle bound of 3.4 and a beatdown bound of 4.0. These label deck shapes; they do not rank decks or recommend one to play.

Where the vocabulary lives, and who keeps it

Grammar in code, vocabulary in data. The rules above are code in the contract package and carry grammar_version. Which cards are win conditions, at what priority, implying which family, and which cards are bait units and bridge partners, are facts about cards with a public source each: data/card-roles.json in the standalone Clash Royale API reference, alongside data/deck-aliases.json and the reference's own page on how players name decks. The reference's build refuses an entry without a public URL, a family outside the six, or a rewrite that drops a long-standing win condition. Elixir imports the two files at deploy; the commit time is roles_version on every archetype object, so a label can always be traced to the vocabulary that produced it.

A card absent from the file is not a win condition, however new. A deck built around one lands honestly on its bare family until a public source names it; the reference lists those cards as unattested, and the domain's research agent treats that list as its queue. The vocabulary is not versioned by season: a role is a property of the card, not of the month it was learned in, and when the vocabulary improves, history is relabelled. The deck was always that shape.

Where the community disagrees, Elixir picks and says so in the entry's source line: Royal Hogs is bridge spam (the deck sites) rather than bait (one guide); an X-Bow or Mortar deck at cycle cost keeps the siege family ("Mortar cycle" resolves to it by alias); P.E.K.K.A is control in the guides and bridge spam on the deck sites, and the partner test is the difference.

Resolving a name

cards_archetype answers the two questions on their own, with no population attached: { name } says what a name means, family, win conditions and the other names for that shape, and { cards } names a deck from up to eight cards (ids or names; Evo / Hero before a name sets its form), with no record required. Called with nothing it returns the vocabulary itself.

battles_decks takes archetype, a string, resolved the same way in three layers, first match wins. A form said before a win condition ("Evo Royal Hogs bridge spam") keeps to that form's decks; a name without one ("Royal Hogs bridge spam") matches every form of the card, and cards_archetype says so in a note.

1. An alias: the community names the grammar does not produce: LavaLoon, LumberLoon, Log Bait, Splashyard, Miner Poison, Hog EQ, 2.6 Hog, Hog cycle, Giant Graveyard, PEKKA Bridge Spam, Rocket cycle, RG cycle, Mortar cycle, X-Bow cycle, Wall Breakers cycle, Drill cycle, eBarbs bridge spam and the rest of the aliases file, case and punctuation free.
2. A family: bridge spam, beatdown, and so on: any win condition.
3. A composed label: <card(s)> <family>, the cards by catalog name (pekka and P.E.K.K.A both), an evo/hero prefix setting the form: "evo royal hogs bridge spam" is Evo Royal Hogs, bridge spam, and keeps to that form's decks, as above.

The response echoes applied.archetype: family, win_conditions, resolved_from (alias, family or label) and any aliases that name the resolved shape, and a note says what was matched. A name that is nothing is refused (bad_request) with the six families and the grammar in the hint; it is never a silent empty list that reads as "nobody plays that". The filter reads the selected player's recorded decks by their stamp.

Recorded deck labels

Every recorded deck carries a descriptive archetype stamp. It is written when the deck first appears and brought up to the current vocabulary and grammar overnight. battles_decks, battles_query and players_summary use those labels to describe the games you played.

What is not here

• No matchup or expected-advantage number.
• No quality in a label. A label describes its cards and pace; it is not a recommendation.
• No named-deck catalog. Aliases are read on the way in only.
• No model. The same cards and the same vocabulary name the same archetype on every call and every surface.