# Quests

## Quest data (measured 2026-10-17 / 2026-10-25)

- Quest table `g_quests` (vector begin/end `0xaa9e98` / `0xaa9e9c`), 0x124
  bytes per quest: id +0, internal name +4 (ANSI), scripts +0x10c (run on
  trigger), +0x114 (one-time, cleared after it ran), +0x118 success end,
  +0x11c failure end (only quests with one can fail), flags +0x120:
  1 triggered, 2 done, 4 in progress, 8 busy (while the trigger runs its
  scripts). `game/engine/quests.h`.
- Quest manager: static object `0xaaaf00` (script interpreter). Quest book
  vector +0x424..+0x428, plain 0x174-byte entries (serialized field by field):
  state +4 (2 active, 100 solved, 101 failed), quest id +8, map position
  +0x14..+0x20; per player (16) a selected entry index at +0x3a8 + player * 8.
- Script opcodes (keyword table `0x452540`): LoseQuest `0x36` and ExitQuest
  `0x0f` -> `0x48f110` -> `Quest_End` `0x46ced0` (thiscall (index, ?,
  success), ret 0xc; LoseQuest success 0, ExitQuest 1). QuestDone `0x0a` tests
  flag 2, QuestInProgress `0x0c` flag 4.
- `Quest_Trigger` `0x46de10` (cdecl (index, ?, ?, ?), plain ret): does
  nothing if flag 1 is set; else sets 1 | 8, runs +0x114 (then cleared) and
  +0x10c, clears 8. Talking to a giver triggered a quest (flags 0 -> 1, no
  book entry yet); accepting it set flag 4 and added a book entry, state 2.
- `Quest_End`: if the quest is in progress and not done, runs the end script
  (success / failure) and sets done (flags 3); the book entry's state becomes
  100 / 101. Quests with ids 2600..3599 (the generic "Bringe NPC zu ...",
  "Eskortiere ...", ...) are copied to the end of the table under a new id
  (largest + 1, at least 10000): the game repeats those itself.
- Compiled quest scripts: `bin\sgf.bin` (labels such as `LoseQuest_10255`,
  texts `res:...`; random side quests use `DQ_` names, time limits
  `DQ_ZEITFENSTER_TAGE`).
- Example (Gladiator, Silber, 2026-10-25): failed Hetzjagd 1502, Pony Express
  5005, Rette Jungfrau 2504, Eskortiere Händler zu geheimen Treffen 1403, all
  flags 3, book state 101.

## Failed quests restartable (request 2026-10-17)

A failed quest is not final: talking to the quest giver again offers it
again. `mods/questfail.cpp`: after `Quest_End` with success 0 (its failure
script has run) the quest's flags 1/2/4/8 are cleared and its book entries
removed, as if never triggered; quests failed before the mod are reset once
after loading. Confirmed in the log (the four quests above reset, 2026-10-25);
the giver offering them again is still to be tested in the game.

## Quest book (measured 2026-10-25)

- Book entries (quest manager +0x424, 0x174 bytes): kind +0 (3 main quest,
  4 side quest: ids 1..99 are main quests, 0x46c450), state +4, quest id +8,
  title / text ids +0x24 / +0x28, progress log text ids +0x2c.., map position
  +0x18 / +0x1c (0x497830), chapter +0x16c (u16). A new entry (0x46c450,
  thiscall (quest index, ?), ret 8, called by the script interpreter
  0x48f602) copies its chapter from the player's current main quest entry
  (+0x3a4 + slot * 8; selected entry +0x3a8 + slot * 8, read by 0x49dd40).
- cUI_Book (one per book mode, 0x7a8[mode] of the book window; quest mode
  +0x166 = 0): list builder 0x6b04c0 (thiscall, from the rebuild 0x6b1670),
  page-full check 0x6b1a70 (thiscall (tab, page), ret 8), render 0x6b27f0
  (thiscall (renderer, bookmarks only), ret 8: the left page's rows, then the
  selected row's detail record on the right, 0x6b1cd0 thiscall (renderer,
  record, sub-page), ret 0xc), events 0x6b3620 (thiscall (event), ret 4).
  Current tab +0x15e, page +0x162; per tab pages +0x97c + tab * 0xc (0x1c
  bytes: title text +0, selected row +4, rows +0x10) and detail records
  +0x9d0 + tab * 0xc (0x40 bytes). Row (0x14 bytes): u16 flags (4 spacer,
  0x40 done, 0x80 entry flag 1), title +4, detail record +8, book entry +0xc,
  icon +0x10. Act tabs: chapter text table 0x9de7e4 (9000 "Pfade des
  Schicksals", 9001 "Unter blutigen Bannern", 9002 "Die rastlosen Toten",
  9003 "Zeitenwende"); bookmarks: 7 controls at +0x168, 0xbc apart.
- The book's list and the quest scripts run on the same thread (logged).
- Quest table (Gladiator, Silber): 28 main quests, 87 side quests in id
  blocks of 100 (1xx .. 25xx, 2 to 7 each; their accepted quests lie together
  on the map), about 120 other side quests (5xxx, 6xxx, 9xxx, 102xx, 15xxx),
  352 generic ones (2600..3599) and bookkeeping entries (0, 99 "MP-Start",
  5081..5089 "Region 1 befreit").

## Quest book as one list (request 2026-10-25)

"Show all quests, unknown ones as ???, so a player knows how many quests an
area holds"; then: "get rid of the tabs ... a section for story, and then a
section per region", the game's page turning kept. `mods/questbook.cpp`: the
game's builder runs on a reordered copy of the book (story, then a section
"<region> (known/all)" with "???" rows, other side quests joined to the
nearest area, "Unentdeckt" counts), all in the first tab; rows are mapped
back to the real entries afterwards (ours to none, which clicks ignore). The
bookmarks are hidden, pages titled "Quests", each page selects its first
quest, a click on a heading keeps the selection. Counted: side quests whose
name is unique in the table.

Area names (measured 2026-10-25): an area is an id block (1xx .. 25xx); its
name is the game's name of the region most of its known quests lie in, as the
megamap names the hero's region: book cell +0x18/+0x1c (x 53.66563 = world
units) -> `World_SectorAt` 0x634970 -> `Sector_Region` 0x622e30 ->
`Region_NameKey` 0x425370 -> text (`game/engine/regions.h`). Several blocks
lie in one named region (regions 1, 2, 3 are all `UI_REGION_SOUTHKERN`), so
blocks with the same name make one section; blocks without a known position
are "Gebiet N".

"Erledigte anzeigen" (request 2026-10-25: "some kind of 'Show completed'
checkmark. If unchecked, completed quests are not in the list (as well as
completed regions)"): the list's first row, an own entry whose state draws the
solved mark (100) when on and no icon (0) when off; its row carries the marker
entry 0xfffffffe. A click toggles it (`sacredK.ini` `[questbook]
ShowCompleted`, default 1) and calls `cUI_Book::Rebuild` 0x6b1670 (thiscall,
no arguments; keeps tab and page if the page still exists, else ours clamps
it). Off leaves out solved entries (main and side) and areas whose quests are
all known and solved; failed quests stay (restartable).