Gamebook Tracker
User Guide
Contents

Overview

A browser-based tool for mapping the branching structure of gamebooks (Fighting Fantasy, Choose Your Own Adventure, etc.) across multiple playthroughs. Supports multiple users and multiple books per account.

Landing page panels

The login and books screens share a three-panel layout:

Left — Book covers: A grid of randomly selected book covers from any book that has a cover uploaded. Hover over a cover to see the book title. Click a cover to open an activity dialog showing public runs and profiles linked to that book. The selection changes on each page load. The panel is hidden if no covers have been uploaded yet. A Search field in the panel header searches across all books by name in real time — results are sorted alphabetically and include books without covers (shown as a labelled placeholder). Clearing the field restores the random cover selection.

Centre — Activity feed: Displays recent activity from all users over the last 30 days, grouped by day (Today, Yesterday, or a full date). No login is required to see the feed. Users who have enabled Hide from activity feed in their profile do not appear here — except for runs they have explicitly marked as public, which still show regardless of that setting.

The following event types appear in the feed:

EventWhat it means
username added book bookA new book was added
username began run N of bookA new playthrough was started
username won / lost / died in book run NA playthrough ended — "won" for victory, "died" for battle death, "lost" for a regular death ending. Battle death runs only appear if the run is marked public.
username discovered every section of bookAll sections in a book have been mapped or referenced
username visited every section of bookAll sections in a book were visited across runs
username reached level NTitleThe user levelled up
(announcement title)An admin announcement — displayed as a bordered card with the title embedded in the border

If the admin has pinned an announcement, it always appears at the very top of the feed in its own amber-bordered card marked Pinned, regardless of when it was published. At most one announcement can be pinned at a time.

The feed refreshes automatically whenever you navigate to the login or books screen.

Right — Login / Books: The login form or your books list.

Each side panel has a small collapse button ( / ) on its inner edge. Click it to slide the panel away and give the activity feed more room. Click again to restore it. The collapsed state of each panel is remembered across page refreshes.

Demo mode

Not ready to create an account? Click Demo (next to the User Guide button on the landing page) to launch a fully functional demo session.

Accounts

On first launch you will see the Login screen.

Your session is remembered in the browser. Click Log out on the books screen to sign out.

Your books

After logging in you land on the Books screen. All your books are listed here. Each card shows a subtle progress bar indicating how many sections you have visited across all your runs. The bar turns green when you have visited every section.

New accounts start with a demo book — Demo Book — already set up with a fully mapped 50-section graph, 2 completed runs (one loss, one win), an in-progress run, notes, and priority markings on several sections, so you can explore all the features right away. There is exactly one loss outcome and one win outcome, both reached via the final section of the book. You can delete the demo book at any time.

ButtonWhat it does
OpenOpens the book and enters the tracker
Edit the book's metadata (name, sections, identifiers, cover). Inactive with a tooltip for books you did not create.
Permanently deletes the book and all your progress for it (with confirmation). Does not affect other users tracking the same book.

If a book was shared with you, the edit button is visible but inactive — hovering shows a tooltip explaining that only the original creator can edit metadata. You can still track, play, and delete your copy independently.

To add a new book, fill in the New Book form at the bottom: enter a name, the total number of sections, optional identifiers, and an optional cover image, then click Create. Use the dropdown to select the publication type:

Leave identifier fields blank if unknown. After creation the form clears and the new book appears in your list — click Open to enter it.

The tracker interface

The screen is split into two areas:

The sidebar can be collapsed using the button on its right edge, giving the graph the full screen width. Click to expand it again.

A current run path strip is pinned above the graph, showing the sequence of sections visited so far. Click the button on the right of the header to collapse or expand it.

A Legend panel sits in the top-right corner of the graph area. Click its header (or the button) to collapse or expand it.

The collapsed state of all panels is remembered across sessions and across devices.

At the bottom of the sidebar, a section input next to a Find Node button lets you jump to any node — type the section ID (numeric or alphanumeric, e.g. 101 or 101-A) and press Enter or click Find Node. The graph selects and animates to that node. The input flashes red if the section doesn't exist in the current graph.

Click ← Home at the bottom of the sidebar to return to your books list.

Recording a playthrough

Starting a run

Click + New in the Runs panel to begin a new playthrough. Runs start at section 1 by default. If your book starts at a different section, open the book before starting any runs, right-click anywhere on the graph and choose ✎ Edit start node to set the starting section. This setting is saved with the book and used for all future runs.

Recording choices

When you reach a section that has not been mapped yet, a text input appears. Enter the section IDs the book offers as choices, comma-separated. Both numeric and alphanumeric IDs are supported:

34, 67, 112
101-A, 101-B, 202

Special values:

Press Record & Choose (or Enter). The choices are saved, and buttons appear for each destination. Press the one you actually took. If a section has a very large number of choices the button area scrolls so all options remain reachable.

If a section has only one choice, the tracker auto-advances without asking.

Alphanumeric sections: If you enter an alphanumeric ID (e.g. 101-A) for the first time on a book, the tracker will ask you to confirm that the book uses alphanumeric sections. Once confirmed, the book is permanently switched to alphanumeric mode and all future IDs pass through freely. In alphanumeric mode the tracker enforces the total section count as a hard ceiling — once you've reached it, navigating to a new undiscovered section is blocked until you increase the total in the book settings or edit existing nodes.

Revisiting mapped sections

When you return to a section that was already mapped in a previous run, the choice buttons appear immediately — no re-entry needed.

Undoing a step

An Undo button appears below the current section during an active run. Each press removes the last step and returns you to the previous decision point — if several sections in a row had no branch (only one possible destination), they are all skipped in a single undo.

Each run has a limited number of undos based on your level:

Level rangeBase undos per run
1 – 303
31 – 404
41 – 505
51 – 606
61 – 707
71 – 808
81 – 909
91 – 10010

Extra Undo purchases from the Gold Coins Shop stack on top of the base amount.

The button shows how many undos remain and disables when none are left.

Ending a run

Three buttons sit above the Battle Death button in the play sidebar. Each requires a themed confirmation before the run is finalised.

Managing runs

The Runs list in the sidebar shows every playthrough, ordered newest first:

ButtonWhat it does
Private / Public (completed runs only)Toggles the run's visibility. Shows Private when hidden and Public when visible to others. Only public runs can be linked from the activity feed — making your profile public does not expose private runs.
Load (in-progress)Resumes that run as the active one
Load (completed)Shows that run's path in the trail and highlights its nodes in the graph
Permanently deletes the run (with confirmation)

You can have multiple in-progress runs at once. Only one is active at a time.

The graph

Every section number you have ever encountered appears as a node. Edges show which sections lead to which.

Edge colours

ColourThicknessMeaning
RedThick if traversed this run, normal otherwiseThis edge leads inevitably to a loss
GreenThick if traversed this run, normal otherwiseThis edge leads inevitably to victory
Orange (thick)ThickTraversed in the active or viewed run, no inevitable outcome
GreyNormalNot traversed this run, no inevitable outcome

"Inevitable" means the destination node (and any chain of single-choice nodes after it) leads only to a loss or only to victory with no branching. If a node has more than one choice, the chain stops and the edge colour falls back to orange (if on the run path) or grey. Run-path edges are always thicker regardless of colour. Loss/victory colour always takes priority over orange.

Node colours

ColourMeaning
Orange (solid)Where you are right now
Blue (solid)Visited in the active or viewed run
Red (solid)The section where a lost run ended
Burnt orange (solid)The section where a battle death run ended
Green (solid)The section where a victory run ended
Dark with red outlineThis section can lead to a loss
Dark with green outlineThis section has a victory choice
Dark orangeThis section is flagged as a battle location
Purple (solid)Mapped — choices recorded, no terminal choices
Grey (solid)Discovered — referenced but not yet mapped
Yellow (solid)The start section of the book (section 1 by default; can be changed via ✎ Edit start node)

Nodes with loss/victory choices or a battle flag have a thicker border. Battle-flagged nodes additionally show a small orange ✕ badge at the bottom-right of the node.

Moving nodes

Drag any node to reposition it. Positions are saved automatically and persist across sessions.

Zoom and pan

Your zoom level and pan position are saved automatically and restored the next time you open the same book.

Right-click menu

High and Low markings are stored with the graph data and persist across sessions. They can be set on any section, including ones not yet mapped.

Section notes

Any section can have a text note attached (e.g. "need the brass key to reach this"). Right-click the node and choose Edit note. Nodes with a note display a small green book icon. Hover over the node to see the note text in the tooltip.

Dice roller

A collapsible dice panel sits in the bottom-left corner of the graph area while you are in the tracker. Click the Dice header (or the arrow button) to collapse or expand it — the collapsed/expanded state is remembered across sessions.

The dice are standard six-sided (d6), as used in most gamebook systems.

The dice count and last throw are saved per run. When you switch between runs or return to a run later, the panel restores exactly what you had. Viewing a completed run shows its saved dice state.

Stats (sidebar)

StatMeaning
MappedSections where choices have been recorded, with percentage of total sections
DiscoveredAll sections seen so far (mapped + referenced but unmapped), with percentage of total sections
MissingOnly shown when Mapped equals Discovered (all found sections are fully mapped). Shows how many sections within the book's total count have never been encountered. Hover over the count to see the individual section numbers.
PlaythroughsTotal number of runs (active and completed), with a breakdown of completed runs shown in brackets — losses in red, wins in green

Character sheet

Click Character Sheet (bottom-right corner of the tracker screen) to open the character sheet dialog. This lets you track any stats, items, or attributes for the current run.

The sheet is per run — each run has its own independent sheet. The button is only active when a run is in progress. When viewing a completed run the overlay shows that run's saved values but the sheet cannot be edited. When no run is loaded the button and overlay are hidden.

Reordering fields

Drag the handle on the left of any field row to reorder it. The new order is applied when you press Save or Save as Template.

Adding fields

Click + Add field to create a new field. Each field has:

SettingDescription
Visibility toggleWhether the field appears in the compact overlay on the graph screen. The pill switch is blue when visible, grey when hidden.
NameLabel shown in the overlay and the dialog
TypeOne of: Number, Boolean, Text, List, Enum
ValueCurrent value — edit inline in the dialog

Field types

TypeUse forValue format
NumberSKILL, STAMINA, Gold, etc.Integer or decimal — use the − / + buttons or type directly
BooleanHas item / ability yes/noCheckbox (Yes / No)
TextFreeform notesAny text
ListInventoryComma-separated items
EnumCharacter class, faction, stancePick one from a defined option set

For Enum fields, type the available options (comma-separated) in the small grey box above the select — the dropdown updates immediately.

Saving

ButtonWhat it does
SaveWrites the current dialog state to the active run's sheet
Save as templateSaves the current dialog state as the book's template — new runs will start from this
CancelDiscards all unsaved changes

There is one template per book. Pressing Save as template overwrites the previous one.

The compact overlay

Visible fields are shown as plain text at the bottom-right of the graph screen, above the Character Sheet button. Only fields with a non-empty name and the visibility toggle enabled are shown. The overlay updates when you press Save. It has no background and does not block interaction with the graph.

Character sheet data is saved with the rest of the book state.

Notebook

Click Notebook (bottom-centre of the tracker graph area, next to User Guide) to open a freeform text notebook for the current book. Notes are per book — all runs share the same notebook.

Use it to track anything that doesn't fit in section notes or the character sheet: meta-strategies, unsolved puzzles, things to try next session, or lore observations.

ButtonWhat it does
SaveWrites the current text to the server and closes the modal
CloseCloses the modal without saving

You can also close with the ✕ button, by clicking outside the modal, or by pressing Escape. Unsaved changes are discarded if the modal is closed any of those ways.

User guide (in-app)

Click User Guide (bottom-centre of the tracker graph area) to open this guide in a modal overlay without leaving the tracker. Close it with the ✕ button, by clicking outside the modal, or by pressing Escape.

Your profile

Click the avatar circle next to your username on the Books screen to open your profile.

Your profile also shows your current level, title, and progress toward the next level. These update automatically as you use the tracker.

Click Save to apply changes. The dialog closes immediately on success. Password and username changes take effect immediately.

Levels

As you track your playthroughs, map sections, and engage with your books, you earn experience and level up. Your current level and title are shown in your profile.

Levels are gained by doing things naturally — playing through books, recording choices, completing runs, filling out your profile, and sharing your books publicly. There is no need to do anything special; progress happens on its own as you use the tracker.

Each level you gain also grants a permanent +1% XP boost, stacking with any boosts purchased from the shop. The bonus applies automatically to all future XP awards.

Your level and title are also visible on your public profile, if you choose to make it public.

Gold Coins & Shop

As you earn XP, you also accumulate Gold Coins (GC): 1 GC for every 1,000 XP. Your current balance is shown in the GC button in the books screen header. Clicking it opens the shop.

Gold Coins are spent permanently — there is no way to refund a purchase.

ItemCostEffect
XP Boost1 GC+1% to all future XP awards, permanently. Stacks — buy multiple times to increase the bonus further.
Extra Undo3 GC+1 undo per run, permanently. Adds on top of your level-based limit.
Fast Travel5 GC+1 fast travel per run, permanently. Adds on top of your level-based limit.

XP Boost only applies to XP earned after purchase — it does not retroactively increase your existing XP.

Editing book details

Books can be edited from two places:

The Identifiers section uses a dropdown to switch between Book (ISBN + ASIN) and Magazine (ISSN) mode. Any set identifiers are shown in the books list next to the section count, prefixed with their type (e.g. ISBN 9781234567890 · ASIN B00EXAMPLE). Books sharing the same ISBN or ISSN are treated as the same title across users — useful for linking different-language editions.

Discoverable sections

When you have reached the exploration wall — every section you know about leads only to sections you have already visited, yet the discovered count is still below the book's total section count — the Edit Book dialog reveals an extra field: Discoverable Sections.

This lets you record the true number of reachable sections in the book. Setting it corrects the XP thresholds for "discover all" and "visit all" achievements, and adjusts the progress bar on the books list to reflect the real reachable total rather than the book's printed section count.

The value must be between the current discovered/visited count and the book's defined total sections. Leave it blank to leave the setting unchanged.

The value applies to all users tracking the same book. XP is retroactively awarded to every user whose progress already meets the new threshold.

Book cover (optional)

Both the New Book form and the edit book dialog include a cover upload section showing a 2:3 preview or a "No cover" placeholder. Click Upload Cover to select an image file — the preview updates immediately. Images are automatically scaled down and compressed to stay within 256 KB. For new books the cover is uploaded right after creation; for existing books it is uploaded when you press Save.

Once uploaded, the cover appears in the left panel of the landing page (visible to anyone, no public profile required).

Hovering over a book name (in either the sidebar or the books list) shows the full name in a tooltip if it is truncated.

Reset

Reset Book wipes all graph data, positions, and run history for the current book. The book entry itself is kept. This cannot be undone.

To fully delete a book, use the button on the Books screen.

Exporting your data

Both export options produce a .zip archive containing your data in two formats — a human-readable HTML file and a machine-readable JSON file.

Export Everything

Open your profile modal (click your avatar) and click ⬇ Export Everything (.zip) under the Export heading. The archive contains:

Export This Book

While viewing a book, click ⬇ Export Book in the sidebar (below Reset Book). Downloads a zip with the HTML and JSON for that book only.

Forum

The community forum is at /forum. No account is needed to read; log in to post.

The forum is organised into five sub-forums:

Sub-forumPurpose
General DiscussionAnything and everything gamebook-related
Book RecommendationsLooking for something to read? Ask here
Playthroughs & SpoilersDiscuss specific books, routes, and endings
Site FeedbackBugs, feature requests, and suggestions for the site
Off TopicAnything else

Click a sub-forum to see its threads. Inside a sub-forum, click + New Thread to start a new discussion. Threads can be pinned (stays at the top) or locked (no new replies) by admins. You can delete your own threads and replies — deleted replies show as [deleted] rather than being fully removed.

Feedback & Inbox

Sending feedback

The Feedback button appears in the top header when you are logged in. Clicking it opens a dialog with three fields:

Press Send to submit. The dialog closes on success.

Inbox

The Inbox button appears in the header when you are logged in. When there are unread admin messages it turns green and shows a count — e.g. Inbox (2). Clicking it opens your message threads.

The inbox has two views:

Thread list — shows all your conversation threads. Each entry shows the date, message count, and a preview of the last message. Threads with unread admin messages are highlighted with a purple border. Click any thread to open it.

Conversation view — shows the full back-and-forth conversation. Your messages appear on the right in blue; admin messages appear on the left in grey. A reply box at the bottom lets you send follow-up messages. Use ← Back to return to the thread list, Delete thread to remove the thread (your side only), or Close to dismiss the inbox.

Opening a thread marks it as read and clears the badge count.

Play Together

Play Together lets two or more users link their copies of a book so that all progress is shared in real time. While a party is active, any section mapped, run started, or choice recorded by one member instantly updates every other member's view.

Starting a party

Open a book and click the Play Together button at the bottom of the screen. Enter the username of the person you want to invite and click Invite. They will receive an invite card at the top of their books library.

As you type a username, a dropdown of matching users appears — click any entry to fill the field. You can invite multiple people one at a time.

If an invite is pending (sent but not yet accepted), the dialog shows Invite pending — waiting for others to accept and a Cancel Invite button.

Accepting an invite

When you have a pending invite, a green card appears above your books list. Click Accept to join. The book is added to your library with the inviter's current progress — all mapped sections, runs, notes, and priorities are copied over. Click Decline if you don't want to join.

You cannot accept an invite for a book you are already tracking independently.

While playing together

The Play Together button turns green and shows your party members' names. The book is fully synced: when anyone navigates a section, starts or completes a run, or maps new sections, everyone's graph updates automatically.

You can invite additional members at any time: click Play Together and use the Invite more form.

Activity feed

Shared runs appear as a single merged entry: john, jane began run 3 of Midnight Maze. Party entries are highlighted with a teal left border and a small party badge.

Stopping

Click Play Together while in a party and then Stop Playing Together. After confirming, each person keeps the current shared progress and continues independently. If only two members remain and one leaves, the party dissolves for both.