Files
rea/website/public/showcase/index.html
T
YsopwnableandGitHub f8d84da127 docs(website): add TH04 bullet-ring case study
Adds a TH04 case study showing how its original 16-bit PC-98 DOS code spaces a bullet ring and aims it at the player. Fresh REA instructions are paired with a five-step C++ comparison and a ring diagram; homepage and showcase-index entries link to the new page and the requested reconstruction repository.

The page credits TH04's maintained source and recorded compiler checks separately from the new REA inspection. Public provenance pins the target, source checkpoint and evidence. No original game assets, executables, private paths or raw result bundles are included. Pages remains manually dispatched.

Validation:
- Website verifier: 12 HTML pages, 185 local references, SVG XML and downloadable ZIP.
- Browser: root and `/rea/`, 32 copy checks, five comparison steps, eight viewport widths, keyboard, reduced motion and no-JavaScript content.
- Fresh real Ghidra verification through published REA 4.1.0: DOS load image verified, all 84 checks match; shown instructions match the function dossier. No Hopper verification was needed or run.
- Independent claims/privacy reviews passed; seven immutable public source links match the local TH04 checkpoint.
- `npm run check:fast`.

The two clean compiler replays and 2,139 matching bytes are recorded TH04 checks, reviewed against their retained receipt and source hashes; the website update does not rerun the compiler or game.
2026-10-07 22:09:16 +08:00

121 lines
5.1 KiB
HTML

<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Case studies — REA</title>
<meta
name="description"
content="Follow REA investigations through code and figures: DX-Ball's sound pan, Notion's Electron clipboard and TH04's aimed bullet rings."
/>
<meta name="theme-color" content="#ffffff" />
<link rel="icon" href="../assets/favicon.svg" type="image/svg+xml" />
<link rel="stylesheet" href="../assets/styles.css" />
<script src="../assets/main.js" defer></script>
</head>
<body>
<a class="skip-link" href="#main">Skip to content</a>
<header class="site-header">
<div class="container header-inner">
<a class="brand" href="../" aria-label="REA home"
><span class="brand-name">REA</span
><span class="brand-caption">Reverse Engineer Anything</span></a
>
<nav class="navigation" aria-label="Main navigation">
<a href="./" aria-current="page">Showcases</a>
<a class="nav-start" href="../get-started/">Get started</a>
<a href="../guides/">Guides</a>
<a href="https://github.com/morluto/rea">GitHub</a>
</nav>
</div>
</header>
<main id="main" class="container">
<div class="page-heading">
<p class="breadcrumb"><a href="../">Home</a> / Showcases</p>
<h1>Follow the<br />investigation.</h1>
<p class="lede">
Start with a question about a real application. See what REA finds,
follow the code, and understand how the pieces fit together.
</p>
</div>
<div class="guide-index">
<section class="guide-entry">
<p class="eyebrow">Native · Reconstruction</p>
<div>
<h2>Rebuilding DX-Ball</h2>
<p>
Recover a sound-pan calculation from a 1996 Windows game. REA's
instructions, caller references and numeric constants lead to a
small C function, checked against the original behavior and all 63
compiled bytes.
</p>
<div class="guide-route">
<span>Executable</span> <b aria-hidden="true">→</b>
<span>REA findings</span> <b aria-hidden="true">→</b>
<span>Recovered C</span> <b aria-hidden="true">→</b>
<span>Validation</span>
</div>
<a class="text-link" href="dx-ball/">Read the DX-Ball case study</a>
</div>
</section>
<section class="guide-entry">
<p class="eyebrow">Electron · Feature tracing</p>
<div>
<h2>Following a copy through Notion</h2>
<p>
Trace a page-facing API through Notion's packaged JavaScript.
Follow its IPC wrappers to the system clipboard, then see how a
small HTML marker keeps rich block data connected to a copy.
</p>
<div class="guide-route">
<span>Packaged app</span> <b aria-hidden="true">→</b>
<span>Exposed API</span> <b aria-hidden="true">→</b>
<span>IPC wrappers</span> <b aria-hidden="true">→</b>
<span>Clipboard</span>
</div>
<a class="text-link" href="notion/">Read the Notion case study</a>
</div>
</section>
<section class="guide-entry">
<p class="eyebrow">PC-98 DOS · Reconstruction</p>
<div>
<h2>Understanding TH04's bullet patterns</h2>
<p>
Inspect the original 16-bit angle helper with REA. Match its
multiply, divide and coordinate operations to readable C++, then
see how they produce a ring aimed at the player.
</p>
<div class="guide-route">
<span>Original DOS code</span> <b aria-hidden="true">→</b>
<span>REA instructions</span> <b aria-hidden="true">→</b>
<span>Angle calculation</span> <b aria-hidden="true">→</b>
<span>Bullet ring</span>
</div>
<a class="text-link" href="th04/">Read the TH04 case study</a>
</div>
</section>
</div>
<section class="article-section">
<h2>Try a smaller example first.</h2>
<p>
The guides walk through a native calculation, an Electron export and a
browser request. Each starts with a prompt and a concrete target.
</p>
<a class="text-link" href="../guides/">Explore the worked guides</a>
</section>
</main>
<footer class="site-footer">
<div class="container footer-inner">
<p>REA · Reverse Engineer Anything</p>
<div class="footer-links">
<a href="https://github.com/morluto/rea">Source</a
><a href="https://github.com/morluto/rea/blob/main/LICENSE"
>MIT license</a
><a href="https://discord.gg/GkcryMnJDM">Community</a>
</div>
</div>
</footer>
<p class="sr-only" id="copy-status" role="status" aria-live="polite"></p>
</body>
</html>