Getting Started

Step-by-step guide to your first game analysis

Launch App →

1. Launch

Open the app at shadowboxing.xyz. A landing modal appears with setup options for terrain, deployment, and army lists.

2. Choose Terrain & Deployment

Select a terrain layout and deployment pattern from the dropdowns. These come from the WTC and Chapter Approved formats. The board will update immediately.

3. Import Army Lists (optional)

Paste Listforge army exports into the Attacker and Defender text areas. You can also paste a Listforge URL directly. Two sample lists are available in the Army Library — use the "Load from Library" dropdown to try them out.

The sample lists included are:

Chaos Daemons — "all gas no breaks" (1995 pts)
all gas no breaks - Chaos Daemons - Daemonic Incursion (1995 Points)


Epic Hero:
Rotigus (250 pts)
  • Gnarlrod
  • Streams of brackish filth

Skarbrand (305 pts)
  • Slaughter and Carnage
  • Bellow of endless fury


Character:
Bloodmaster (65 pts)
  • Blade of blood

Bloodmaster (65 pts)
  • Blade of blood

Great Unclean One (295 pts)
  • Putrid vomit
  • Bileblade
  • Bilesword
  • E: The Endless Gift
  • Warlord

Rendmaster on Blood Throne (165 pts)
  • Attendant's hellblades
  • Blade of blood

Rendmaster on Blood Throne (165 pts)
  • Attendant's hellblades
  • Blade of blood


Battleline:
Bloodletters (110 pts)
  • Bloodreaper
    • Hellblade
  • Instrument of Chaos
  • Daemonic Icon
  • 9x Bloodletter
    • 9x Hellblade

Bloodletters (110 pts)
  • Bloodreaper
    • Hellblade
  • Instrument of Chaos
  • Daemonic Icon
  • 9x Bloodletter
    • 9x Hellblade

Plaguebearers (110 pts)
  • Plagueridden
    • Plaguesword
  • Daemonic Icon
  • Instrument of Chaos
  • 9x Plaguebearer
    • 9x Plaguesword


Beast:
Beasts of Nurgle (65 pts)
  • Beast of Nurgle
    • Putrid appendages

Beasts of Nurgle (65 pts)
  • Beast of Nurgle
    • Putrid appendages

Flesh Hounds (75 pts)
  • Gore Hound
    • Burning maw
    • Collar of Khorne
    • Gore-drenched fangs
  • 4x Flesh Hound
    • 4x Collar of Khorne
    • 4x Gore-drenched fangs

Flesh Hounds (75 pts)
  • Gore Hound
    • Burning maw
    • Collar of Khorne
    • Gore-drenched fangs
  • 4x Flesh Hound
    • 4x Collar of Khorne
    • 4x Gore-drenched fangs

Flesh Hounds (75 pts)
  • Gore Hound
    • Burning maw
    • Collar of Khorne
    • Gore-drenched fangs
  • 4x Flesh Hound
    • 4x Collar of Khorne
    • 4x Gore-drenched fangs
World Eaters — "Ding dong the Pin ball wizards home" (1995 pts)
Ding dong  the Pin ball wizards home (1995 Points)

World Eaters
Berzerker Warband
Strike Force (2,000 Points)

CHARACTERS

Khârn the Betrayer (100 Points)
  • Warlord
  • 1x Gorechild
  • 1x Plasma pistol

Master of Executions (95 Points)
  • 1x Axe of dismemberment
  • 1x Bolt pistol
  • Enhancements: Berzerker Glaive

BATTLELINE

Khorne Berzerkers (180 Points)
  • 1x Khorne Berzerker Champion
     ◦ 1x Chainblade
     ◦ 1x Icon of Khorne
     ◦ 1x Plasma pistol
  • 9x Khorne Berzerker
     ◦ 8x Bolt pistol
     ◦ 7x Chainblade
     ◦ 2x Khornate eviscerator
     ◦ 1x Plasma pistol

Khorne Berzerkers (180 Points)
  • 1x Khorne Berzerker Champion
     ◦ 1x Chainblade
     ◦ 1x Icon of Khorne
     ◦ 1x Plasma pistol
  • 9x Khorne Berzerker
     ◦ 8x Bolt pistol
     ◦ 7x Chainblade
     ◦ 2x Khornate eviscerator
     ◦ 1x Plasma pistol

DEDICATED TRANSPORTS

Chaos Rhino (85 Points)
  • 1x Armoured tracks
  • 1x Combi-bolter

Chaos Rhino (85 Points)
  • 1x Armoured tracks
  • 1x Combi-bolter
  • 1x Combi-bolter

OTHER DATASHEETS

Chaos Spawn (90 Points)
  • 2x Chaos Spawn
     ◦ 2x Hideous mutations

Chaos Spawn (90 Points)
  • 2x Chaos Spawn
     ◦ 2x Hideous mutations

Eightbound (135 Points)
  • 1x Eightbound Champion
     ◦ 1x Chainblades
  • 2x Eightbound
     ◦ 2x Chainblades

Eightbound (135 Points)
  • 1x Eightbound Champion
     ◦ 1x Chainblades
  • 2x Eightbound
     ◦ 2x Chainblades

Forgefiend (165 Points)
  • 1x EctoPlasma Cannon
  • 2x Ectoplasma Cannon

Forgefiend (165 points)
  • 1x EctoPlasma Cannon
  • 2x EctoPlasma Cannon

Helbrute (120 Points)
  • 1x Close combat weapon
  • 2x Heavy flamer
  • 1x Helbrute fist
  • 1x Helbrute fist

Helbrute (120 Points)
  • 1x Close combat weapon
  • 2x Heavy flamer
  • 1x Helbrute fist
  • 1x Helbrute fist

Helbrute (120 Points)
  • 1x Close combat weapon
  • 2x Heavy flamer
  • 1x Helbrute fist
  • 1x Helbrute fist

Jakhals (65 Points)
  • 1x Jakhal Pack Leader
     ◦ 1x Autopistol
     ◦ 1x Chainblades
  • 1x Dishonoured
     ◦ 1x Skullsmasher and mangler
  • 8x Jakhal
     ◦ 8x Autopistol
     ◦ 7x Chainblades
     ◦ 1x Icon of Khorne
     ◦ 1x Mauler chainblade

Jakhals (65 Points)
  • 1x Jakhal Pack Leader
     ◦ 1x Autopistol
     ◦ 1x Chainblades
  • 1x Dishonoured
     ◦ 1x Skullsmasher and mangler
  • 8x Jakhal
     ◦ 8x Autopistol
     ◦ 7x Chainblades
     ◦ 1x Icon of Khorne
     ◦ 1x Mauler chainblade

4. Begin Setup

Click Begin Setup to place terrain on the board. If you imported army lists, the Army tab becomes available in the left panel. Click Add to Board next to each unit to place it in the deployment zone.

5. Lock Deployment

When all units are placed, click Lock In Deployment in the right panel. This starts the game clock, enables the tool hotbar at the bottom, and enters the Pre-Game phase for scout moves and infiltrators.

6. Gameplay Loop

Phases progress: Command → Movement → Shooting → Charge → Fight → End Turn. Use the hotbar to select tools. Press F1F6 to jump directly to a phase.

The app records what happened — it never enforces rules. You can use any tool in any phase. Phase just sets the default tool and records the context for your timeline.

The header bar shows the current phase and a score summary. Click the score in the header (or press O) to open the score flyout, where you can edit primary VP, secondary cards, and objective control.

7. Key Tools

ToolHotkeyDescription
SelectSClick or box-select units. Shift+click to add/remove. Drag to reposition.
MoveMDrag units to record normal movement. Arrow shows path.
KillKClick a unit to mark it as killed. Click again to unkill.
MeasureDClick two points to measure distance in inches.
Range RingRShow range circles around a unit at a specified radius.
Line of SightLGeometric LOS analysis with terrain occlusion. Shows visibility polygons.
ShootHAnnotate shooting: pick shooter, weapon, and target. Draws targeting line.
ChargeGPick the charging unit, roll the 2d6 (enter your dice or roll in-app), then declare targets within reach and drag models into contact.

All tool hotkeys are rebindable in Settings.

8. Save & Load

Press Escape to open the pause menu with Save/Load options. Shortcuts: Ctrl+S to save, Ctrl+O to load. The game auto-saves every 2 seconds when changes are detected.

9. Settings

The Settings tab in the left panel provides:

  • Team colors — pick custom colors for attacker and defender
  • Keybindings — click a key to rebind, Backspace to clear, Escape to cancel
  • Streamer mode (F11) — hides all panels for a clean board view
  • Chromakey — green background for OBS overlay compositing
  • Opacity sliders — adjust grid, zone, and ring transparency
  • File locations (desktop only) — configure save and screenshot directories

10. Keyboard Shortcuts

See the full keybind reference on the main docs page.