Skip to content

Add the ROM-only Turok walkthrough to the AI N64 tutorial - #499

Merged
RetroGameDeveloper merged 3 commits into
masterfrom
codex/turok-rom-only-walkthrough
Oct 23, 2026
Merged

RetroGameDeveloper merged 3 commits into
masterfrom
codex/turok-rom-only-walkthrough

Conversation

@RetroGameDeveloper

@RetroGameDeveloper RetroGameDeveloper commented Oct 23, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • Add a practical ROM-only route through the RetroReversing decompdecomp fork, including macOS installation, private workspace guidance, compiler checks, and a bounded agent prompt.
  • Document the actual Turok Europe experiment from the supplied ROM, without consulting existing game source, decompilation projects, maps, or source-derived analyses.
  • Explain the compressed main-program obstacle, independent extraction checks, automatic import, IDO comparison, and a manual type/register-allocation fix.
  • Report 419 exact matches / 26,112 bytes with clear denominator limits and a verified original-cartridge rebuild containing all 419 C selections.
  • Link the required tool change: Support RNC-packed N64 code and verify original-cartridge exports decompdecomp#2. No ROM, extracted binary, disassembly, or recovered game C is committed.

Verification

  • Jekyll build succeeds.
  • Desktop and 390px embedded viewport checked; moved the long ROM hash out of the table for narrow layouts.
  • ROM measurements and matching counts checked against local logs/database.
  • The full decompilation remains unfinished. The page explicitly distinguishes unpacking, candidate discovery, exact C matches, expanded-image rebuilding, and original-cartridge verification.

The final standalone export selected 419 C functions with no fallback among those selections and reproduced the complete normalized cartridge byte for byte. The remaining functions are still assembly.

@github-actions

Copy link
Copy Markdown

📊 Markdown Content Validation Report

Metadata Completeness

Status: ✅ Metadata validation succeeded

Tag Validation

Status: ✅ All tags valid

Detailed Reports

📋 Metadata Analysis Report
Markdown Metadata Checker
========================
Checking for fields: editlink, tags, permalink, layout, title

Found 74 markdown files in categories/
Found 232 markdown files in pages/

Total markdown files found: 306

Processing files...

=== MARKDOWN METADATA ANALYSIS REPORT ===

Total files processed: 306
Fields checked: editlink, tags, permalink, layout, title


--- Missing "editlink" field ---
Files missing this field: 0
✅ All files have this field!

--- Missing "tags" field ---
Files missing this field: 0
✅ All files have this field!

--- Missing "permalink" field ---
Files missing this field: 0
✅ All files have this field!

--- Missing "layout" field ---
Files missing this field: 0
✅ All files have this field!

--- Missing "title" field ---
Files missing this field: 0
✅ All files have this field!

=== SUMMARY ===
editlink: 100.0% coverage (306/306)
tags: 100.0% coverage (306/306)
permalink: 100.0% coverage (306/306)
layout: 100.0% coverage (306/306)
title: 100.0% coverage (306/306)
🏷️ Tag Validation Report
Markdown Tags Validator
========================
✅ Loaded 108 valid tags from _data/valid-tags.json
📊 Based on analysis of 298 files from 2026-08-09T14:09:24.775Z

Found 74 markdown files in categories/
Found 232 markdown files in pages/

Total markdown files found: 306

Validating tags...

=== TAG VALIDATION REPORT ===

Total files processed: 306
Files with invalid tags: 0

🎉 SUCCESS: All tags are valid!
✅ No invalid tags found in any markdown files.

This report was automatically generated by the Markdown Content Validation workflow.

Result

  • ✅ All tags are valid

@RetroGameDeveloper
RetroGameDeveloper merged commit 947777e into master Oct 23, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant