Index of the research notes in this folder. Each note is read-only analysis of the two source games, their ports, or the shared host. Nothing here was built or run unless a note says so. Each note labels its own inference and fact-check status. Start with GLOSSARY if a term is unfamiliar.
- c1-battle-monsters.md: Damage runs through
CMonstorUnit::CheckDmg, which the port does not override, and player hits share a 96-slot collision pool that overflows undefined. - c1-build-link.md: The port is three OBJECT libraries linked into one executable, and a shared-library target would need the static-init, exit and singleton audit first.
- c1-characters.md: The party is six fixed IDs reloaded through one
LoadChara2path, so substituting data under an existing ID is the least invasive route to a new character. - c1-data-loading.md: All reads go through the PORT_OVERRIDE layer in
dataread.cppand one hash index, so a second data root needs a second index consulted on a miss. - c1-debug-testing.md: The
--headless --jump ... --frames N --screenshotpath can boot a town or dungeon directly, though nothing in the note was run. - c1-dungeons.md: Dungeons are entered at
MapJump(200+D), and a direct floor jump is possible but has save side effects. - c1-items-weapons.md: The item ID space, owner-routed weapon chains and chest tables are catalogued, and legacy weapon IDs 21 to 80 conflict between two mappings.
- c1-mainloop-control.md:
RunGameis terminal and holds all mode state in globals, so a host needs a split init and per-frame step API before it can drive the game. - c1-memory-globals.md: PS2 quadword arenas are re-hosted as Kazarov arena blocks, and
ArenaClearAllwould wipe a second game's live memory unless it gets a domain. - c1-platform-io.md: Window, audio, clock, config and path singletons are process-wide, so two games in one process need per-game namespacing for each of them.
- c1-port-docs.md: The port's own documentation digest, with the main drift being a stale 50 Hz plan against the 60-tick code.
- c1-render-present.md: One SDL window, one Kazarov renderer and one swapchain serve the game, and the fixed 640x480 logical size blocks sharing a renderer with Dark Chronicle.
- c1-scripts-events.md: The event bytecode VM has a 1500-slot table, and the port's
CRunScript::extpath is the cleanest hook for new opcodes. - c1-towns-georama.md: Towns are MapNo 0 to 4 with Georama progress stored in
CSaveData, and villager rosters are reshuffled withrand()on each entry and not saved. - c1-worldmap-modes.md: The mode machine is driven by
NextMapNoranges inGameFollowMapJump, and the world map is a battle-menu travel page rather than a separate map.
- c2-battle-monsters.md: Combat is entirely retail
ps2/srccode, with a 115-row named damage table, so a crossover attack must match a row name or it silently does nothing. - c2-build-link.md: The port builds OBJECT libraries linked into each executable, and about 30 process-exit sites would need redirecting before a shared-library build is safe.
- c2-characters.md: Max and Monica are the only human bodies, and a third human needs a new roster ID, save layout change and several switch branches.
- c2-data-loading.md: DC2 loads from
DATA.HD4/DATA.DATthrough a directory-walk index, andIndexKeystrips any prefix before a colon, so a game prefix must be intercepted earlier. - c2-debug-testing.md: The cheapest headless boot is
--jump town:<map>with--headless --offscreen, but every boot needs a Vulkan device and real-data gates skip without a data root. - c2-dungeons.md: The seven dungeons, their floor graphs, geostone and medal flags, and the
--jump dungeon:<n>[:<floor>]path are catalogued, with derived counts labelled. - c2-mainloop-control.md:
MainLoopis a single blocking function on the main thread, so a host can suspend only at the post-mgEndFrameor mode-switch boundaries or by hoisting the loop state. - c2-memory-globals.md: Save data and the main arena are single file-scope managers reclaimed on every loop entry, so cross-world data copied late is silently corrupted.
- c2-platform-io.md: ChronicleTwo's host layer shares its env prefix, path config, window identity, mixer and clock slots with Chronicle, and 35 PORT_OVERRIDE symbols collide.
- c2-port-docs.md: The port documentation digest, which names the test-hook jump parser and the mode dispatch as the main seams for a cross-world visit.
- c2-render-present.md: The window, Vulkan device, swapchain and renderer are process singletons, and the logical size is fixed at init, so one host must own the renderer.
- c2-save.md: The save is a raw
CSaveDataplusCUserDataManagerimage with 1/64-sampled check digits, andSaveSlotRead/SaveSlotWritecan take a bundle path without touching the catalog. - c2-scripts-events.md: The
CRunScriptVM has 696 scene-event commands, and free IDs 1275 to 1499 let Ixion register native commands, though no SB2 compiler exists in the repo. - c2-subgames.md: Side games sit behind one dispatcher, and the PC port's fish-race stub means Finny Frenzy cannot be completed on PC.
- c2-time-travel.md: Time travel is a map-table and world-map system where future maps are types 5 and 6, and the Ixion train is a scripted map pair switched on for chapters 6 and 7.
- c2-towns-georama.md: Five Georama towns are positional map indices 0 to 4 with five save slots, so inserting a map shifts every later number and an append-only table is needed.
- kz-build-data.md: The two Kazarov pins differ in layout, and a single superbuild is blocked by
CMAKE_SOURCE_DIRuse, duplicate target names and shared cache variables. - kz-runtime.md: Kazarov has no host-wide context, so two games in one process need resets or a refactor across the renderer, clock, paths, mixer and scheduler.
- engine-lineage-mglib.md: Both engines share the mg vocabulary and the MDT/MDS/IMG container layouts, but name flags, lights and shading diverge, and DC1 content into the DC2 engine looks like the more feasible direction.
- engine-lineage-models.md: The
.chr,.mds,.mot,.wgtand.bbpformats are one family, and the main conversion costs are the info.cfg dialect and DC2's four-influence skin limit. - engine-lineage-maps.md: Model containers are partly readable across both games, but collision attributes, scripts and floor generators differ, so one engine per world is the realistic path for dungeons.
- formats-dcextractor.md: The DCExtractor specifications are a useful format reference, though several of its claims (TIM2 guard, HD3 names, MOT default branch) were not confirmed by running it.
- data-catalog-dc1.md: Maps the DC1 PAL data tree to the six cast members, five towns, seven dungeons and their bosses, with some NPC names still unresolved.
- data-catalog-dc2.md: Maps the DC2 PAL data tree (about 10,600 files) to the cast, the 189-record map registry, the dungeons and the Ixion shell assets, with four registered maps lacking files.
- crosswalk-characters.md: Compares the six DC1 characters with Max and Monica, covering weapon owners, start HP and defence, and thirst against the DRY bit, and proposes a per-character roster record.
- crosswalk-items-world.md: Proposes a world-prefixed item crosswalk and a draft station catalogue, noting that name matches across weapon classes are unreliable.
- community-refs.md: Surveys the community references and their licences, and warns that most community memory addresses are NTSC-U while the workspace discs are PAL.
- lore-time-travel.md: Atlamillia are the time keys, Starglass is the route to the past, and Ixion is a locomotive built at Luna Labs, though the fandom wiki pages were unreachable and the premise is marked as inference.
- symbol-collisions.md: A single merged link would hard-fail on 664 duplicate names and silently change behaviour for four more, so
--allow-multiple-definitionmust not be carried into an Ixion link.
- multi-game-host-design.md: Recommends one host executable with two hidden-symbol game modules, each with a private Kazarov copy, parked at frame-end checkpoints.
- replays-headless.md: ChronicleTwo has a full gate suite and replay corpus, while Chronicle has only basic flags, and
run_from_save.pystill checks formanifest.txt.
- v1-board-window.md: Proposes a host-drawn station window on SDL_Renderer, and shows that Hop v0's three DLLs must bind one shared SDL3 build.
- v1-c1-passenger-state.md: Lists where DC1 keeps the passenger state (party, HP, gilda, water, weapon) and proposes export and import bodies at the frame-boundary hook.
- v1-c2-passenger-state.md: Lists where DC2 keeps the same passenger state (including DRY and the Ridepod) and which caches a write must refresh.
- v1-c1-runtime-warp.md: Shows which DC1 loop states can safely take a map jump from the frame-end checkpoint and proposes a
C1TravelRequestform. - v1-c2-runtime-warp.md: Shows how DC2 leaves its current loop for
LOOP_EDITorLOOP_DUNGEONat a frame end and proposesC2TravelRequestand an apply-at-checkpoint function. - v1-character-crossover.md: Ranks four options for playing a character from the other game, from loading its model directly to a portrait-only passenger, with the native-logic cost of each.
- v1-map-crossover.md: Separates native travel, which needs no format work, from cross-world rendering of a town or floor, which does.
- v1-time-gates.md: Finds the existing code paths in each game that move the player between eras or worlds, and where the port could call the reserved
request_travel.