17 KiB
Gameplay Rules (Current Scope)
This file captures confirmed gameplay rules so far. It is intentionally incomplete and will be expanded in later passes.
1) Match Entry and Deck Selection
- Players create decks of cards.
- Deck size has no minimum and no maximum.
- Every deck must contain at least one
Tier 1ArchSpirit. - Players can enter either:
- Ranked match
- Custom match (join or create)
- Before match start, each player selects:
- The deck they will use
- The
Tier 1 ArchSpiritthey will start with
2) Match Size and Battlefield
- Matches support
2..Nplayers. - Battlefield size scales based on player count.
- Each player has a defined starting side.
- Grid styles supported:
SquareHex
3) Opening Placement
- Each player places their selected
Tier 1 ArchSpiriton a tile in the first row of their side. - On placement, the
ArchSpiritaffinity is pushed to the placement tile itself and all valid adjacent tiles:- Square grid (non-corner): the placement tile +
3adjacent tiles =4tiles total. - Square grid (corner): the placement tile +
2adjacent tiles =3tiles total. - Hex grid (non-corner edge): the placement tile +
4adjacent tiles =5tiles total.
- Square grid (non-corner): the placement tile +
- Edge-side explanation:
- On a square edge, the tile behind the ArchSpirit is off the board, so only 3 adjacent tiles are valid.
- On a hex edge, two sides face off the board, leaving four valid adjacent tiles.
- Example (square, 5,0 placement): tiles
4,0,5,0,5,1,6,0all receive the affinity push.
3.1 Opening Draw
- At game start, each player draws
7cards. - This value is the default and may be overridden by custom match settings.
4) Turn Order
4.1 Free-for-All
Turn order is randomized among all players.
4.2 Team Play
- Team order alternates by team.
- Within each team slot, player order is randomized among that team's players.
- Example:
- Team 1 Player A
- Team 2 Player C
- Team 1 Player B
- Team 2 Player D
5) Turn Economy
- Base SP gain per turn is driven by game settings:
- Ranked: static/default ranked setting
- Custom: defined by custom rules
- Effects may modify SP gained per turn.
- SP currently has no enforced cap.
- SP cap should be supported by settings in the future.
- Default per-turn card draw is
1; may be modified by effects.
5.1 Resource Rules
Sacrifice Tokensare a separate resource fromSP.Sacrifice Tokensdo not accumulate automatically per turn.Sacrifice Tokensare obtained by other game effects/systems and spent to pay card costs.
6) Turn Flow (Current High-Level)
- Active player takes actions during their turn.
- Active player clicks "end turn" when finished;
UntilEndOfTurneffects expire at this point. - Turn advances to next player in current turn order.
6.0 Start-of-Turn Phase
At the start of each turn, the following resolve in order:
- MP replenishment — all friendly
ArchSpiritandSpiritunits restore movement points. - Defense restoration — all friendly
ArchSpiritandSpiritunits restore defense to max. - SP gain — the active player gains their current SP accumulation amount.
- Start-of-turn triggered abilities resolve.
- Card draw — the active player draws their current per-turn card count.
- Draw-triggered abilities resolve.
- Ruin activations — one ability activates at random for each Ruin tile occupied by a friendly unit.
6.1 Hand Rules
- There is no enforced hand size limit.
6.2 Turn-Timing Rule (Current)
During the active player's turn, they may channel:
SpiritRuinsTerramorphaRepentanceInstinct
The active player may continue channeling cards while they can still pay all required costs.
Channeling cards and taking unit actions (move, attack, ability, sacrifice) may be freely interleaved with no required ordering.
Special timing exception:
Instinctcards may also be played during other players' turns.Instinctcards may also be played as non-play interrupts.
6.2.1 Card Resolution and Interrupt Windows
- Card resolution follows play order (first played, first resolved in sequence).
- Between each card played and between each unit action (move, attack, ability use), there is a
10second interrupt window. - During that window, opponents may interrupt by playing an
Instinct. - An ability's actions resolve in full sequence without interrupt windows between individual actions — the window opens only after the entire ability has resolved.
6.3 Channeling Spirits
- A player may channel Spirit cards to tiles in the active
ArchSpirit's channeling range. - Channeling range is an
ArchSpirit-specific property withminandmaxvalues. - Range rules:
mincan never be less than1in normal cases.- If channeling range is set to
0, thatArchSpiritcannot channel.
- Channeling requires:
- Paying the channel cost
- Affinity validity on the target tile
- Affinity validation:
- If the card has a basic affinity,
Base1orBase2on the target tile must match that basic affinity. - If the card has a non-basic affinity, the target tile must match that final resolved affinity exactly.
- If the card has a basic affinity,
6.4 Channeling Terramorpha
- Players may channel
Terramorphacards by paying their cost. - Terramorpha pushes affinity to target tiles.
- Terramorpha can target any tile on the battlefield.
- Terramorpha types:
Mono: pushes affinity to one target tile.Di-morpha: target one tile, then target one adjacent tile.Tri-morpha: target one tile, then target one adjacent tile, then target one adjacent tile.
6.5 Unit Actions Per Turn
- A player may move their
ArchSpiritandSpiritunits until each unit is out of movement points. ArchSpiritcan attack once per turn, unless modified by an ability/effect.Spiritcan attack once per turn, unless modified by an ability/effect.ArchSpiritcan use one activated ability per turn, unless modified by an ability/effect.Spiritcan use one activated ability per turn, unless modified by an ability/effect.
6.6 Cost Types (Channeling and Activated Abilities)
Supported costs include:
Spirit PointsSacrifice Tokens- Discard card from hand (with optional restrictions such as specific card, card type, or card cost)
- Move card from top of deck to discard
- Move card from bottom of deck to discard
- Send a controlled
Spiritfrom battlefield to discard - Deal damage to own
ArchSpirit - Deal damage to own
Spirit
6.7 ArchSpirit Tier Actions
6.7.1 Transition
Transitionswaps theArchSpiritin play with aTier 1 ArchSpiritfrom that player's hand.Transitioncan only be performed during that player's turn.- The outgoing
ArchSpiritgoes to discard. - The incoming
ArchSpiritenters with full health and defense. Transitionuses the incomingArchSpirit's channeling cost.- The incoming
ArchSpiritmay move, attack, and use abilities during the turn it enters.
6.7.2 Ascend
Ascendupgrades the in-playArchSpiritby exactly one tier (for exampleTier 1 -> Tier 2).Ascendcan only be performed during that player's turn.- The target higher-tier
ArchSpiritmust be the direct predecessor/successor line of the in-playArchSpirit. - Valid example:
ArchSpirit A Tier 1 -> ArchSpirit A Tier 2
- Invalid examples:
ArchSpirit A Tier 1 -> ArchSpirit B Tier 2ArchSpirit A Tier 1 -> ArchSpirit A Tier 3+
Ascenduses the incoming (higher-tier)ArchSpirit's channeling cost.- The higher-tier
ArchSpiritsource zone is not restricted (hand, deck, or other). - The incoming
ArchSpiritmay move, attack, and use abilities during the turn it enters.
6.8 Movement Rules (Spirit and ArchSpirit)
- Movement is
1-to-1: moving one tile spends one MP. - A tile can contain at most one
SpiritorArchSpiritat a time. - Movement can be obstructed by other
Spirit/ArchSpiritunits. - Each
Spiritdefines:- Whether its own movement can be obstructed
- Whether it obstructs movement for others
- Supported movement styles include:
WalkFlightJumpTeleport
- Movement style behavior:
Walk: can be obstructed by anySpiritorArchSpiritoccupying a tile.Flight: can only be obstructed by units withFlight.Jump: cannot be obstructed. Has a min/max movement range. Costs1 MPper tile landed on (not per tile traversed in path).Teleport: cannot be obstructed. Same min/max range model asJump. Costs1 MPper tile landed on.
- Line-of-sight (
LOS) requirements:WalkandFlightdo not require LOS (path-based movement).Jumpdoes not require LOS.Teleportrequires LOS.
- Pathing:
- Movement pathing is built through adjacent tiles.
- On
Squaregrids, diagonal movement is not allowed. - On
Hexgrids, pathing uses standard BFS over adjacent tiles with 1-to-1 tile movement cost.
6.9 ArchSpirit/Spirit Shared Properties
6.9.1 Genus
Genusis an array of type tags (examples:Goblin,Undead,Warrior).- A unit is affected by any effect that matches any of its genus tags.
6.9.2 Health
- A unit with
Health <= 0is dead. - Dead units go to the discard unless an ability/effect specifies otherwise.
6.9.3 Defense
- Defense restores to max at the start of each turn (see §6.0).
- Incoming damage is applied to
Defensefirst. - Damage is applied to
Healthonly afterDefensereaches0. - Example:
- Start:
Health = 5,Defense = 2 - Take
1damage ->Health = 5,Defense = 1 - Before defense restore, take
2damage ->Defensegoes to0, remaining1damage applies to health ->Health = 4 - At next turn start, defense restores to its full value (
2in this example)
- Start:
6.10 Attack System (Spirit and ArchSpirit)
SpiritandArchSpiritunits define:attackStyleminAttackRangemaxAttackRangedamage
- Units can target friendly units (
Spirit/ArchSpirit) with attacks, but friendly-target attack attempts require confirmation. - Damage normally applies through defense first, unless an ability/effect specifies defense bypass.
- Attack style may define whether line-of-sight (
LOS) is required. - Attack definitions may be:
- Single target
- Multi-target (
Ntargets)
- Attacks may include dynamic damage modifiers that decrease or increase damage based on defined factors.
- Attacks may be
AOE. - Attack range behavior may be constrained to linear-only targeting.
- Attack range behavior may be constrained to diagonal-only targeting.
6.11 Ability System
See abilities.md for the full ability model (types, action model, effect types, conditions, durations).
6.12 Mutable Properties
See object-context.md for the canonical mutable property inventory and card-design.md for card-specific state properties.
6.13 Card Instance Rule
Gameplay operates on card instances. There is no permanent card loss/gain of base definitions during play.
6.14 Stateful Mutation Model (Object-by-Object)
All mutable changes support duration metadata so effects can expire or be undone.
Duration model (applies to all objects):
Instant(one-time change, no ongoing state)UntilEndOfTurnUntilStartOfOwnerTurnUntilStartOfSourceOwnerTurnForNTurnsWhileConditionPermanentInMatch
For reversible/temporary effects, the game must retain source + modifier context so rollback can be resolved correctly when duration ends.
6.14.1 PlayerState (Mutable Properties)
SPTotalSPAccumulationAmountAccumulatesSP(bool)STTotalCardsDrawnPerTurnCanDrawCards(bool)CanAscendArchSpirit(bool)CanTransitionArchSpirit(bool)CanChannelSpirit(bool)CanSacrificeSpirit(bool)CanChannelRepentance(bool)CanChannelInstinct(bool)CanChannelRuin(bool)CanChannelTerramorphaMono(bool)CanChannelTerramorphaDi(bool)CanChannelTerramorphaTri(bool)
6.14.2 TileState (Mutable Properties)
BaseAffinitySlot1BaseAffinitySlot2PushAffinity(push basic affinity into Base2 with slot shift)PushFinalAffinity(set Base1/Base2 to the pair required for a target final affinity)- Occupancy-driven behavior/effects
- Occupant-targeting behavior/effects
Current occupant classes that tile behavior can reference:
SpiritArchSpiritSpiritToken(temporary spirit/summon)Ruin
6.14.3 Canonical Object Property Inventory (WIP)
This section is the normalized source for object properties.
6.14.3.1 Player
Non-mutable:
IdNameSelectedDeckSelectedArchSpirit
Mutable:
- See
PlayerStatein6.14.1.
6.14.3.2 Tile
Non-mutable:
IdCoords
Mutable:
CanBeOccupiedBy:Spirit,ArchSpirit,RuinBaseAffinitySlot1BaseAffinitySlot2PushAffinityPushFinalAffinity- Occupancy-based effects
- Occupant-targeting effects
6.14.3.3 Battlefield
Non-mutable:
- Battlefield is a collection of tiles.
Mutable:
- Derived from tile state mutations and battlefield-level effects/rules.
6.14.3.4 CardState
See card-design.md for full CardState definitions (Shared, ArchSpirit, Spirit, Repentance, Terramorpha, Ruin, Instinct).
6.14.3.5 Deck / Hand / Discard Mutable Operations
Deck:
- Return card from
Hand/Discard/Battlefieldto deck - Shuffle deck
- Place card from source zone to top or bottom of deck
- Draw
Xcards - Place
Xcards from deck into discard
Hand:
- Discard
Ncards - Reveal cards to
Nplayers - Discard random cards
- Target player selects card(s) to discard
- Put
Ncards from hand on top/bottom of deck - Put
Ncards from hand to battlefield as Instinct - Play
Ncards from hand for modified costX
Discard:
- Return cards from discard to deck
- Return cards from discard to hand
- Return cards from discard to battlefield
6.14.4 Global Targeting Filters and Location Scopes
Additional target filters:
OwnerAllyEnemyAnyRandom
Location scopes:
HandDeckDiscardBattlefield
6.14.5 Duration Rule Primitives
Supported duration timing patterns:
UntilEndOfTurnUntilStartOfTurn- Duration anchors can be scoped to specific player turns:
- Until end of
Xplayer's turn - Until start of
Xplayer's turn
- Until end of
- Delayed start/end:
- Effect starts after
Xturns - Effect ends after
Xturns
- Effect starts after
- Conditional durations:
- While condition
Xis true - While condition
Xis false
- While condition
6.14.6 Summon and Occupancy Limits
- There are no summon limits.
- If a tile is in valid range and meets summon requirements, it is a valid summon target.
- Every tile on the battlefield can be occupied.
6.15 Sacrifice Action
- Sacrifice is a free action (does not consume an attack or ability use).
- A player may sacrifice a
Spiritonly if thatSpiritis adjacent to the player'sArchSpirit. - The sacrificed
Spiritgoes to discard. - Sacrifice value is computed first:
SpiritSacValue = (CardSTCost * 3) + CardSPCost
- Sacrifice Token (
ST) return is computed from currentSTandSpiritSacValue. - Sacrifice return function:
public int GetSTReturn(int CurrentST, int SpiritSacValue)
{
int STReturn = 0;
if (CurrentST == 0)
{
if (SpiritSacValue <= 15)
{
STReturn = 1;
}
if (SpiritSacValue >= 16)
{
STReturn = 2;
}
}
if (CurrentST == 1)
{
if (SpiritSacValue <= 2)
{
STReturn = 0;
}
if (SpiritSacValue >= 3 && SpiritSacValue <= 15)
{
STReturn = 1;
}
if (SpiritSacValue >= 16)
{
STReturn = 2;
}
}
if (CurrentST == 2)
{
if (SpiritSacValue <= 6)
{
STReturn = 0;
}
if (SpiritSacValue >= 7 && SpiritSacValue <= 15)
{
STReturn = 1;
}
if (SpiritSacValue >= 16)
{
STReturn = 2;
}
}
if (CurrentST == 3)
{
if (SpiritSacValue <= 9)
{
STReturn = 0;
}
if (SpiritSacValue >= 10 && SpiritSacValue <= 15)
{
STReturn = 1;
}
if (SpiritSacValue >= 16)
{
STReturn = 2;
}
}
if (CurrentST >= 4)
{
STReturn = 0;
}
return STReturn;
}
7) Win Condition (Current)
Last ArchSpirit standing wins.
8) Deferred Rules (To Be Added Next)
The following are intentionally not defined yet:
- Full timing windows and reaction timing
- Affinity push timing and replacement edge cases
- Elimination timing details for team modes
- Mulligan rules
- Status effects, death checks, and simultaneous resolution order
- Ranked ruleset constants and custom rules schema
- Full adjacent-tile targeting constraints for
Di-morpha/Tri-morpha