Help & FAQ

Everything you need to know to get started with Herald.

What is Herald?

Herald is a digital scoreboard and game tracker for OnePageRules tabletop games (Grimdark Future, Age of Fantasy, etc.). It keeps track of rounds, activations, victory points, wounds, spell tokens, and more so you can focus on playing instead of bookkeeping.

Herald is not a rules engine — it does not roll dice or enforce rules for you. It records your actions and provides quick-reference information like rules text, spells, and unit stats so you don't have to keep switching tabs to Army Forge.

Getting Started

Create or Join a Game

From the home page, choose Create Game (enter a game name, your player name, and pick a color) or Join Game (enter the game code shared by the host).

Import Your Army

Paste your Army Forge share link or list ID into the import field. Herald will pull in all your units, spells, faction rules, and special abilities.

Start the Game

Once both players have imported their armies, the host clicks Start Game. The board view appears and tracking begins at Round 1.

Importing Armies from Army Forge

Herald integrates directly with the Army Forge list builder.

  1. Open your list in Army Forge and click Share.
  2. Copy the share URL (looks like https://army-forge.onepagerules.com/share?id=XXXXX).
  3. In Herald, paste the URL into the Army Forge URL / List ID field and click Import Army.
What gets imported: units (with loadouts, rules, and notes), spells, faction special rules, faction name, and caster levels. You can re-import or import a second list to combine armies.
Combined / multi-army lists (e.g. The Ashen Pact): Herald uses a fallback when Army Forge's TTS export fails—it fetches the list via the share API and army books. If import fails, check that the list and any custom or Studio army books are set to public in Army Forge Studio.

Game Flow

Herald follows the standard OPR activation-based turn structure:

  1. Round starts. Spell tokens are automatically added to caster units.
  2. Players alternate activations. Select a unit, choose an action (Hold, Advance, Rush, Charge), then resolve attacks, spells, etc.
  3. Once both players have activated all units (or passed), click the End Round button to advance to the next round.
  4. Repeat until the game ends (typically after 4 rounds).

The End Round button is the large button at the bottom of the screen. It resets all unit activations and increments the round counter.

Unit Actions

Hold Unit stays still. Can shoot and cast spells. Required for Artillery and Shaken units.
Advance Move up to base movement. Can shoot (at -1 to hit) and cast spells. Required for Aircraft.
Rush Move up to double base movement. Cannot shoot or charge.
Charge Move into melee range (up to 12″). Fight in melee. Can cast spells before charging.

After choosing an action, you can record attacks, spell casts, wounds taken, etc. Herald tracks activation status so you know which units still need to go.

Spell Casting

Units with the Caster rule receive spell tokens at the start of each round (equal to their caster level). Tokens accumulate up to a maximum of 6.

  1. Select the caster unit and click Cast Spell.
  2. Choose a spell from the list. Each spell shows its token cost and casting roll needed (e.g., "1 token, 4+").
  3. Roll the dice yourself. Click Success or Failure to record the result.
Remember: Each unit can only cast one spell per activation. On failure, the tokens are still spent.

Spells are imported automatically from Army Forge. You can view all available spells in the collapsible Spells panel under each player's army.

Transports (Embark / Disembark)

If your army contains a unit with the Transport rule, Herald provides embark and disembark buttons on eligible unit cards.

  • Embark: appears on non-transport units when a transport is available. Select which transport to board.
  • Disembark: appears on embarked units. Click to exit the transport.
  • Transport destroyed: if a transport is destroyed while units are inside, those units are automatically disembarked, marked as Shaken, and you'll be reminded to take dangerous terrain tests.

Special Deployment (Scout / Ambush)

Herald detects units with Scout or Ambush rules and shows reminders:

  • Scout: at the start of Round 1, a banner reminds you to forward-deploy Scout units up to 12″ from the deployment zone edge.
  • Ambush: from Round 2 onwards, a banner reminds you that Ambush units may deploy anywhere over 9″ from enemies. Use the "Deploy from Ambush" button on the unit card to bring them in.

Morale & Shaken Units

Units that lose half or more of their models must take a morale test. Herald displays the morale threshold on each unit card (e.g., "Morale <3" for a 5-model unit).

Shaken units are restricted to the Hold action only and cannot shoot or charge (but can still cast spells in some cases). They recover at the end of the round if they pass a morale check. Herald tracks Shaken status automatically when you toggle it on the unit card.

Unit Management

Before the game starts (in the lobby), you can:

  • Rename units with custom names for easier identification.
  • Remove units you don't want to use.

During the game, each unit card shows:

  • Wounds / model count tracker
  • Activation status (unactivated, activated, action taken)
  • Spell token counter (for casters)
  • Rules with hover/tap tooltips for quick reference
  • Unit notes (if present from Army Forge)
  • Embark/Disembark and deployment controls

All sections on the board (units, spells, rules, import) are collapsible — click the + / icons to expand or collapse them.

Saving & Loading

Herald supports saving and loading game state so you can pause and resume later.

  • Save: downloads a JSON file with the full game state.
  • Load: upload a previously saved JSON file to restore the game.

The save file includes all unit states, spell tokens, round number, victory points, and army data.

Multiplayer & Solo Mode

Multiplayer:

  • The host creates a game and shares the game code with the opponent.
  • The opponent enters the code on the Join Game tab.
  • Both players see real-time updates via WebSocket — no need to refresh.

Solo Mode:

  • Check Solo Play Mode when creating a game.
  • You control both armies from a single browser window.
  • Great for learning the app or testing army lists.

Tips & Shortcuts

  • Hover over rule names on unit cards to see the full rules text in a tooltip. On mobile, tap and hold.
  • Collapse sections you don't need to reduce clutter during play.
  • Re-import a second Army Forge list on the same player to combine armies (e.g., allied detachments). Spells and rules are merged without duplicates.
  • Victory points can be adjusted at any time using the +/− buttons on each player's panel.
  • Activity log at the bottom of the board shows a history of all actions, spell casts, and status changes for the game.

FAQ

Where do I get my Army Forge share link?

Go to army-forge.onepagerules.com, open or create your list, then click the Share button. Copy the URL from your browser's address bar.

My spells aren't showing up after import. What's wrong?

Spells are fetched from the Army Forge army book API. Make sure the list and any custom or Studio army books are set to public in Army Forge Studio. If the problem persists, try re-importing the list. Spells appear in the collapsible Spells section under each player.

Does Herald roll dice or enforce rules?

No. Herald is a tracking and reference tool. You roll your own dice and make your own decisions — Herald records the outcomes and provides rule references to help you play faster.

Can I use Herald on my phone?

Yes. Herald is designed to work on mobile browsers. The layout adjusts for smaller screens, and all interactions work with touch.

How do I track wounds / remove models?

Each unit card has a wound counter. Use the +/− buttons to adjust wounds. When a unit reaches zero models, you can mark it as destroyed.

What happens if my transport is destroyed with units inside?

Herald automatically disembarks all passengers, marks them as Shaken, and prompts you to take dangerous terrain tests for each one.

Can I combine multiple Army Forge lists for one player?

Yes. Import a second list for the same player and Herald will merge the units, spells, and faction rules together without duplicates.

Is my game data stored on a server?

Game data is stored on the server for the duration of the session and for multiplayer sync. You can also save/load games as local JSON files for long-term storage.