How Moonfall's AI Game Master Works

Every card game has a referee. Usually it's invisible — a rules engine buried in code that compares numbers and resolves interactions the same way every time. Moonfall pulls the referee into the light and gives it a mind. The AI Game Master is a language model that reads each card you play, decides what it does in the moment, updates the board, and narrates the result like a storyteller running a table. This is the piece that makes Moonfall an AI card game rather than a game with AI sprinkled on top.

Referee and storyteller at once

The Game Master wears two hats simultaneously. As a storyteller, it turns your plays into prose — the clash of your creatures, the taunt before a finishing blow, the way a spell warps the battlefield. As a game engine, it issues the actual state changes: this player loses health, that creature is frozen, this card moves to the discard pile. The narration and the mechanics are produced together, from the same reading of the moment, so the narration and the state change come from one reading of the same moment.

How it judges a card

A Moonfall card is just a name, a mana cost, and a line of text — no attack, no health. So the Game Master's first job is to infer what a card is from how it's written. From the name and description it deduces characteristics like:

• Power — how hard it hits, and what it can overcome.
• Size — a giant aimed at one target may still catch the crowd around it.
• Durability — is this a tank, or something fragile?
• Speed and evasiveness — can it chase down a runner, or slip an attack?
• Intelligence, persuasion, loyalty, luck — and many more.

Then it weighs those traits against context: the state of both boards, the story so far, your opponent's position, the array of cards in play, and even the battle location, which can subtly tilt outcomes. The same card is not a constant. Command a fire elemental against a lone foe and it simply burns it; send it into a packed board and its flames may spread. None of that comes from a lookup table — the board is read as it stands.

Wording is everything

Because the model reads meaning, the words on a card carry real mechanical weight. A card described as a guardian will tend to interpose itself and protect your side, the way a "Taunt" works elsewhere — but it can also, wisely, choose not to block, anticipating your opponent's plan and saving itself for the threat that matters. A card that says its sage "perceives distant times and places" can genuinely reveal hidden information. A creature written as a swarm behaves like a swarm.

This extends to your plays. Characters are commanded by dragging them onto a target; the model decides what that command means. For deliberately powerful, high-cost characters it goes a step further and offers you a few tactical intents — strike, shield, control — so you disambiguate what your big play is trying to do, and it resolves accordingly. Spells are more precise commands: their own description is the instruction, resolved directly.

Fair, but firm

A thinking referee could sound exploitable, so Moonfall's Game Master works inside deliberate design limits. It's asked to keep the meta balanced — steering away from "win the game" effects, instant summoner kills, and game-breaking combos. Health, mana, turn structure, and a five-card board limit are design limits it works within, not around. And it punishes misplays: aim a spell at an illegal target and you may simply lose the card and its mana, exactly as a strict human judge would rule at a real table. You're free to be inventive; you're not free to cheat.

That full-match behavior is also why automated self-play is useful: it can surface confusing card text without turning the game into a spreadsheet.

Why creativity beats net-decking

In a traditional card game, the strongest deck is a solved problem. Someone computes the optimal list, publishes it, and everyone copies it — the "net-deck." The cards resolve identically for everyone, so the edge goes to whoever memorized the best sixty.

Moonfall breaks that loop. When a referee interprets your plays, there is no single solved line, because outcomes depend on wording, timing, and situation that no tier list can capture. A clever, well-motivated play that fits the story can beat the statistically "correct" one. Your imagination becomes the strongest card in your hand — and two players with the same deck can play completely different games.

The story is the receipt

There's one more thing the Game Master produces that no rules engine can: a record worth keeping. Because it narrates as it adjudicates, every match already exists as a story by the time it ends — and Moonfall inks that story into a shareable manga storybook. The finishing blow you set up three turns earlier isn't just a number in a log; it's a panel. The AI didn't only decide who won. It wrote how.

That's the AI Game Master: a referee that thinks, a storyteller that remembers, and the reason no two Moonfall matches ever play out the same. Want to see it read your cards? Play a match free, or start with how to play Moonfall.