ifPlayer

A test runner for Inform 7 games. Drives glulxe over stdin/stdout, captures every turn, and renders the run as a single-page HTML report you can drill into.

Demo reports

• Cloak of Darkness

  5 turns · WALKTHROUGH · score 2/2 · 9/9 ✓

• Zork I — full walkthrough

  437 turns · WALKTHROUGH · score 350/350 · 24/24 ✓

• Zork I — full test suite

  36 tests · 1 walkthrough · 35 scenarios · 601 turns · 180/180 ✓

What's in a report

• Setup sectionShared .before files run before the test body and surface as a collapsed bar showing where setup landed the player ("ends in Cellar · T:27 · score 24"). Click to expand the full setup transcript.
• Per-turn rowsOne compact row per command — turn, input, current room, score, score delta, outcome marker, assertion summary. Click any row to reveal the game's response.
• Match highlightsEach ? assertion has a "show" toggle that highlights the satisfying span(s) directly inside the response above. Radio-style: one assertion's matches at a time per turn.
• Word-level drift diffRecorded snapshot vs observed output, compared by words (whitespace-only differences ignored). Real changes render red/green inline like a code diff.
• Room identitySame physical room visited many times keeps the same fingerprint, even when its description embeds dynamic state (open trap door, treasure case contents). Hover any room name to see the fingerprint hash.
• Win classificationTests are auto-classified as walkthrough (reaches max score / win banner) or scenario (any other completion).

Test format

A .test file interlaces input commands with assertions:

test: cloak-walkthrough
game: ../cloak-inform7.ulx
seed: 42
---

> west
? Cloakroom
? hooks

> hang cloak on hook
? velvet cloak
? /score has (just )?gone up/

> read message
? *** The End ***

For longer tests, share setup via .before files:

test: zork1-troll-fight
game: ../../i7/zork1/zork1.ulx
seed: 26
before: zork1-cellar-nav.before
---

> n
? Troll Room
> kill troll with sword
...

CLI

ifplayer play <game.ulx>                  REPL against the game
ifplayer run <test.test>                  run one test
ifplayer test <tests..> --html-report R   run many, write report
ifplayer new <name> --game G              stub a new test
ifplayer update <test>                    rewrite test with captured output