Files
cardgen/references/game_mechanics_readable.md

11 KiB
Raw Permalink Blame History

SOR Game Mechanics — Readable Guide

This document summarizes the current gameplay model in a readable form, based primarily on:

  • SOR/Shared/context-files/gameplay.md

This is not meant to replace source-of-truth engine rules forever, but it is a much easier reference for design and content work.


1. Match setup

Players build decks, then enter either:

  • ranked matches
  • custom matches

Each player chooses:

  • a deck
  • a starting Tier 1 ArchSpirit

Current deck rule notes in the gameplay doc:

  • deck size currently has no minimum or maximum
  • every deck must include at least one Tier 1 ArchSpirit

2. Battlefield model

The game is intended to support:

  • 2..N players
  • square grids
  • hex grids

Each player has a defined starting side. The battlefield size can scale with player count.

So the long-term model is wider than just 1v1 square maps.


3. Opening sequence

3.1 ArchSpirit placement

At game start, each player places their selected Tier 1 ArchSpirit on the first row of their side.

When the ArchSpirit is placed, its affinity is pushed to:

  • the placement tile
  • all valid adjacent tiles

That means opening placement is also the first terrain-shaping action in the match.

3.2 Opening draw

By default, each player draws:

  • 7 cards

The gameplay doc notes this can be overridden by custom settings.


4. Turn order

Free-for-all

Turn order is randomized among all players.

Team play

Teams alternate, and player order inside each team slot is randomized.

Example:

  • Team 1 Player A
  • Team 2 Player C
  • Team 1 Player B
  • Team 2 Player D

5. Resources

5.1 Spirit Points (SP)

SP is your main spendable action/channeling resource.

Rules currently documented:

  • base SP gain per turn comes from game settings
  • effects can modify SP gain
  • no enforced SP cap yet
  • a future cap is expected to be supported

5.2 Sacrifice Tokens (ST)

ST is a separate resource.

Important differences from SP:

  • ST does not accumulate automatically each turn
  • ST comes from other systems/effects
  • ST is used to help pay some card costs

So SP is your normal tempo currency; ST is more conditional / conversion-based.


6. Start-of-turn order

The gameplay doc gives a specific start-of-turn sequence:

  1. replenish movement points on friendly ArchSpirit / Spirit units
  2. restore defense to max on friendly ArchSpirit / Spirit units
  3. gain SP
  4. resolve start-of-turn triggers
  5. draw cards for turn
  6. resolve draw triggers
  7. activate Ruins (one random eligible Ruin ability per occupied Ruin)

This order matters a lot for ability design.


7. Hand rules

Currently:

  • there is no enforced hand size limit

8. Turn timing and what can be interleaved

During your turn, you can channel:

  • Spirit
  • Ruin
  • Terramorpha
  • Repentance
  • Instinct

You can also perform ArchSpirit progression actions during your turn:

  • Transition: take a Tier 1 ArchSpirit from your hand, put it into play where your current ArchSpirit is, and send the current ArchSpirit to discard
  • Ascend: upgrade your current ArchSpirit from its present tier to the next tier in its line

And you may interleave card play with unit actions.

That means there is no required action ordering like:

  • “all movement first”
  • “then attacks”
  • “then card play”

Instead, the current model is intentionally loose:

  • move
  • channel
  • attack
  • ability
  • channel again
  • sacrifice
  • move again with another unit
  • etc.

As long as the action is legal and the costs can be paid, it can slot into the turn.


9. Interrupts

Instinct is special.

Instinct cards may be played:

  • during the active player’s turn
  • during other players’ turns
  • as interrupts / non-play responses

The current timing note says:

  • after each card played
  • and after each unit action (move, attack, ability)
  • there is a 10-second interrupt window

During that window, opponents may play an Instinct.

Important exception:

  • an ability’s internal action sequence resolves fully first
  • there is not an interrupt window between each sub-action of one ability

So the interrupt window is between whole actions, not inside a single action list.


10. Channeling Spirits

A Spirit can be channeled if:

  • it is in the active ArchSpirit’s channel range
  • its cost can be paid
  • the target tile satisfies affinity legality

Channel range

ArchSpirit channel range has:

  • minimum
  • maximum

If channel range is 0, that ArchSpirit cannot channel.

Affinity legality

  • basic-affinity Spirit: one of the tile base slots must match
  • non-basic-affinity Spirit: the tile’s final resolved affinity must match exactly

This ties Spirit play tightly to the affinity system.


11. Channeling Terramorpha

Terramorpha can target any tile on the battlefield.

Types:

  • Mono = 1 tile
  • Di-morpha = first tile, then an adjacent tile
  • Tri-morpha = first tile, then adjacent, then adjacent again

The current gameplay doc is still a little high-level here, but the intent is clear:

  • Terramorpha shapes battlefield affinity directly
  • Di/Tri are connected-tile effects

12. Unit actions per turn

Each ArchSpirit / Spirit may generally:

  • move until out of MP
  • attack once per turn unless modified
  • use one activated ability per turn unless modified

Those limits can be altered by abilities/effects.


13. Cost model

Supported cost types currently documented include:

  • Spirit Points
  • Sacrifice Tokens
  • discard from hand
  • mill from top of deck
  • mill from bottom of deck
  • send own Spirit from battlefield to discard
  • deal damage to own ArchSpirit
  • deal damage to own Spirit

That is a pretty broad cost vocabulary already.


14. Transition and Ascend

14.1 Transition

Transition means swapping your current ArchSpirit for a Tier 1 ArchSpirit from hand.

Rules documented:

  • only during your turn
  • outgoing ArchSpirit goes to discard
  • incoming one enters at full health/defense
  • uses incoming ArchSpirit’s channeling cost
  • incoming ArchSpirit may still move/attack/use abilities that turn

So Transition is not “summoning sickness”-style restricted.

14.2 Ascend

Ascend upgrades the current ArchSpirit by exactly one tier in its own line.

Rules documented:

  • only during your turn
  • must be direct progression
  • cannot skip tiers
  • cannot switch to a different ArchSpirit line
  • uses incoming higher-tier cost
  • higher-tier source zone is not restricted
  • new form may still act that turn

So Ascend is an aggressive tempo upgrade, not just a slow replacement.


15. Movement rules

Movement is 1 MP per tile moved.

A tile can contain at most one:

  • Spirit
  • ArchSpirit

Movement can be obstructed depending on movement type and unit flags.

Supported movement types:

  • Walk
  • Flight
  • Jump
  • Teleport

Walk

  • path-based
  • can be obstructed by units
  • no LOS requirement

Flight

  • path-based
  • can only be obstructed by units with Flight
  • no LOS requirement

Jump

  • not obstructed
  • min/max jump range
  • costs MP per tile landed, not path traversed
  • no LOS requirement

Teleport

  • not obstructed
  • min/max range
  • costs MP per tile landed
  • does require LOS

Pathing

  • square grids: no diagonal walking pathing
  • hex: BFS over adjacent hexes

This is important because movement legality is more nuanced than just Manhattan range.


16. Unit properties

16.1 Genus

Genus is a list of tags like:

  • Goblin
  • Undead
  • Warrior

Effects can match against any genus tag a unit has.

16.2 Health

  • if health goes to 0 or below, the unit dies
  • dead units normally go to discard unless an effect says otherwise

16.3 Defense

Defense is a replenishing shield layer.

Rules:

  • defense restores to max at start of turn
  • incoming damage is absorbed by defense first
  • overflow spills to health

This is not just “armor reduction” — it is a renewable buffer.


17. Attacks

Units define:

  • attack style
  • min attack range
  • max attack range
  • damage

Current implemented/observed combat note:

  • when a Spirit attacks, the defender currently counterattacks if it survives
  • you noted this may later become a flag, or be constrained so counterattacks only happen when the two units are in each other’s valid attack range

The attack system is intended to support:

  • single-target attacks
  • multi-target attacks
  • AOE
  • LOS requirements
  • dynamic damage modifiers
  • linear-only restrictions
  • diagonal-only restrictions

Interesting note:

  • friendly units can be targeted by attacks
  • but friendly attacks require confirmation

So the system is flexible enough for friendly-fire, buff-like attack behaviors, or sacrificial mechanics.


18. Mutable game objects

The gameplay doc frames the rules around objects that can be modified temporarily or permanently.

PlayerState mutable examples

  • current SP
  • SP accumulation rate
  • can draw cards
  • can channel Spirit / Ruin / Terramorpha / etc.
  • can Ascend / Transition

TileState mutable examples

  • BaseAffinitySlot1
  • BaseAffinitySlot2
  • PushAffinity
  • PushFinalAffinity
  • occupancy-sensitive behavior

Zone operations

  • return to deck
  • shuffle
  • draw
  • mill
  • discard
  • reveal
  • place onto battlefield
  • move among hand/deck/discard/battlefield

The rules are already designed around reversible, duration-based mutation.


19. Duration model

Supported duration primitives currently documented:

  • Instant
  • UntilEndOfTurn
  • UntilStartOfOwnerTurn
  • UntilStartOfSourceOwnerTurn
  • ForNTurns
  • WhileCondition
  • PermanentInMatch

The big design idea is:

temporary changes need enough stored context to be undone correctly later.

That is a strong systems choice and matters a lot for ability implementation.


20. Sacrifice

Sacrifice is currently documented as:

  • a free action
  • only adjacent Spirits to your ArchSpirit may be sacrificed
  • sacrificed Spirit goes to discard

Sacrifice value

The base sacrifice value is:

SpiritSacValue = (CardSTCost * 3) + CardSPCost

ST return

The amount of ST returned depends on:

  • your current ST
  • the sacrificed Spirit’s computed value

The current function is tiered and intentionally diminishing:

  • low current ST + good sacrifice value = better ST return
  • high current ST = smaller or zero return

So sacrifice is a catch-up / conversion mechanic, not infinite scaling.


21. Win condition

Current documented win condition:

  • last ArchSpirit standing wins

Simple and direct.


22. What is still intentionally incomplete

The gameplay doc explicitly says several areas are not fully locked yet, including:

  • full timing windows
  • replacement/edge cases for affinity pushing
  • elimination timing in team modes
  • mulligans
  • simultaneous resolution rules
  • ranked/custom constants
  • full Di/Tri adjacency constraints

So the game model is already strong, but some details are still designated WIP.


23. Best mental model

If you want the shortest useful summary:

SOR is a terrain-shaping tactics card game where your ArchSpirit defines your summon geometry, your units spend MP to reposition and attack, card types can be freely interleaved during your turn, and the affinity state of the board is one of the main engines of strategy.

That is the heart of it.