# Dungeon Crawler Carl Universe Dashboard

> Unofficial fan dashboard with character sheets and story state at a selected book and timeline section. Integrations can open a specific position and view with a URL.

Read the deep link integration guide before mapping reading or audiobook progress. Resolve all relative links below against the directory containing this `llms.txt` URL, preserving any deployment base path.

- Build links with `book`, `chapter`, and optional `view` query parameters. For example: `./?book=3&chapter=12&view=sheets`.
- Use exact supported IDs from `data/timeline.json`: `books` contains `{n, title}` records and `timeline` contains `{book, chapter, label}` records in reading order. `chapter` is an internal, 1-based section ID. It is not a printed chapter number or an Audible track number; prologues and interludes have their own IDs.
- A position requires `book`. Omitting `chapter` selects that book's first section. Allowed views are `sheets`, `dungeon`, `cast`, and `spaces`; a valid position defaults to `sheets`.
- State includes events through the end of the selected section. For a listener partway through a section, select the previously completed section, which may be in the previous book. There is no pre-story or start-of-section position.
- Map audiobook progress using the relevant book's timeline and the audiobook edition's actual structure. Do not invent a fixed track-to-section offset. Links cannot accept Audible timestamps or ASINs and cannot focus an individual skill. No Audible mapping is supplied.
- A URL cannot set, raise, or bypass the reader's spoiler cap. First-time visitors and links beyond the saved cap encounter the book picker. Invalid positions are ignored rather than rounded to a later section.
- The timeline lookup includes future section labels. Use it privately for mapping; do not display labels or story details beyond the reader's position.

## Integration documentation

- [Deep link integration guide](docs/deep-links.md): Parameter rules, spoiler boundaries, audiobook mapping guidance, and link-building examples.
- [Supported books and timeline sections](data/timeline.json): Exact IDs and labels for supported positions, including later-story section labels.

## Dashboard

- [Open the dashboard](./): Choose a spoiler limit and explore the available views.
- [Example character sheet link](./?book=3&chapter=12&view=sheets): Book 3, internal section 12, Sheets view, subject to the reader's spoiler cap.