Commonwealth-Online/Commonwealth-Online-Public
3
0
Fork 0
Code Pull Requests Activity

Add automatic quest start for Out of Time (MQ102) on COVault109 exit

Browse Source 
When the player leaves COVault109 for the first time, the plugin now automatically
starts the Out of Time quest (MQ102, FormID 0x0001CC2A) and sets it to stage 10,
skipping the vault entry sequence for a smoother multiplayer transition.

The implementation uses TESDataHandler::LookupForm to safely resolve the quest,
includes defensive null checks, and only triggers once by checking the quest
currentStage field. Appropriate logging is added for debugging.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
andrew
2026-06-30 22:33:21 +12:00
co-authored by Cursor
parent d328bfb647
commit 771f855f89
3 changed files with 62 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/dev-log.md
+28
View File
@@ -7,6 +7,34 @@ failed experiments, successful tests, and next steps.
---
## 2026-06-30 - COVault109 Exit Quest Auto-Start
### Summary
Added automatic quest start for "Out of Time" (MQ102, FormID: 0x0001CC2A) when the player first leaves COVault109. The quest is started and immediately set to stage 10, skipping the vault entry sequence. This provides a smoother transition into the multiplayer world after character creation.
### Files Changed
- `plugin/src/main.cpp`
- `changelog.md`
### Details
- Added `TryStartOutOfTimeQuest()` helper function that uses `TESDataHandler::LookupForm` to safely resolve the MQ102 quest from Fallout4.esm.
- Function includes safety checks: verifies data handler availability, confirms quest form resolution, and skips if the quest is already started.
- Called during the solo cell exit detection in `PollLocalPlayerTransform()` when `soloCellTransformSuppressed` transitions from true to false.
- Logs informational messages on quest start and warnings for any resolution failures.
### Testing
- Compile test: no linter errors.
- Recommended manual check: create a new character, complete Vault 111, exit into the Commonwealth world, and verify that MQ102 is started and set to stage 10 (check quest menu or `getquestcompletedstage 0001CC2A` console command).
- Verify the quest does not start if the player re-enters and exits COVault109 (safety check works).
### Known Issues
- None currently known.
### Next Steps
- Manual in-game testing to confirm quest stage progression works correctly after auto-start.
---
---
## 2026-06-30 - Complexion Texture Sync (Appearance v3, Phase 2.1)