{ "added_at": "2026-10-18", "additional_evidence_urls": [ "https://github.com/chasem-dev/sms-pc-port/blob/a2ff4eef099b22b2af487d1b5e3ac09ffe667d31/BUILD.md", "https://github.com/chasem-dev/sms-pc-port/blob/a2ff4eef099b22b2af487d1b5e3ac09ffe667d31/docs/DEVELOPMENT.md", "https://github.com/chasem-dev/sms-pc-port/blob/a2ff4eef099b22b2af487d1b5e3ac09ffe667d31/LICENSE", "https://github.com/chasem-dev/sms-pc-port/blob/a2ff4eef099b22b2af487d1b5e3ac09ffe667d31/.gitmodules", "https://github.com/chasem-dev/sms-pc-port/blob/a2ff4eef099b22b2af487d1b5e3ac09ffe667d31/assets/progress.svg", "https://github.com/chasem-dev/sms-english/blob/967436b8c623834d38a57d34923775f45eca8861/README.md", "https://github.com/chasem-dev/sms-english/blob/967436b8c623834d38a57d34923775f45eca8861/PROGRESS.md", "https://github.com/chasem-dev/sms-english/blob/967436b8c623834d38a57d34923775f45eca8861/config/GMSE01/README.md", "https://github.com/chasem-dev/sms-english/blob/967436b8c623834d38a57d34923775f45eca8861/AGENTS.md", "https://github.com/chasem-dev/sms-english/blob/967436b8c623834d38a57d34923775f45eca8861/LICENSE" ], "category": "reconstruction-cases", "description_en": "Builds a native PC port of Super Mario Sunshine’s North American release from a pinned matching-decompilation fork, adding a host platform layer for graphics, disc, audio, input and OS services. The fork’s README says AI was used extensively to reconstruct and match its code; the port documents scripted regression hashes and lockstep comparisons with retail captures. Functions that do not yet match can still behave differently from retail, and the game must come from the user’s own disc image.", "description_zh": "以固定版本的一致性反编译分支为基础，构建 Super Mario Sunshine 北美版的原生 PC 移植，并为图形、光盘、音频、输入和系统服务提供宿主平台层。该分支的 README 称，其代码的重建与匹配大量借助 AI；移植项目记录了脚本化回归哈希，以及与原版捕获数据的逐步对照。尚未匹配的函数仍可能与原版行为不同，游戏数据须来自使用者自己的光盘镜像。", "entry_url": "https://awesomerea.org/resources/sms-pc-port-case/", "entry_url_zh": "https://awesomerea.org/zh/resources/sms-pc-port-case/", "evidence_url": "https://github.com/chasem-dev/sms-pc-port/blob/a2ff4eef099b22b2af487d1b5e3ac09ffe667d31/README.md", "group": "cases", "id": "sms-pc-port-case", "json_url": "https://awesomerea.org/resources/sms-pc-port-case/record.json", "kind": "case-study", "markdown_url": "https://awesomerea.org/resources/sms-pc-port-case/index.md", "markdown_url_zh": "https://awesomerea.org/zh/resources/sms-pc-port-case/index.md", "name": "Super Mario Sunshine: a native PC port from an AI-assisted decompilation", "name_zh": "Super Mario Sunshine：基于 AI 辅助反编译的原生 PC 移植", "reconstruction_method": "port", "record_type": "resource", "relationship": "independent-reconstruction", "requirement_facets": [ "scope", "prerequisites", "prerequisites", "testing", "license" ], "requirements": [ "Targets only the North American GMSE01 Rev 0 release. README reports the 32-bit Linux and macOS builds as playable, 64-bit Linux as playable but still being tested stage by stage, and 64-bit Windows as booting under Wine with native runtime checks. macOS builds x86_64, run under Rosetta 2 on Apple Silicon, because native arm64 cannot map game memory below 4 GiB.", "Requires the user’s own GMSE01 Rev 0 disc image as .iso, .gcm or Dolphin .ciso; the port reads models, textures, levels, music and movies from it at run time and ships no game data. Given the image, the build also makes a standalone executable containing the game’s files, which README says must not be shared. Optional language, texture and HD-cutscene packs are separate.", "build.sh and run.sh drive CMake, Python 3, patch, SDL2 and a host compiler: Ubuntu/Debian multilib GCC for the default 32-bit Linux build, Homebrew LLVM clang targeting x86_64 on macOS, or MSYS2 MINGW64 GCC on Windows. The decomp submodule is pinned to sms-english 967436b; PC-only changes are patches applied to copies of its sources, and the separate decomp build to a matching mario.dol uses its own GameCube toolchain.", "At that pin, the fork’s PROGRESS.md reports, as of 2026-09-27, 99.57% fuzzy, 72.94% byte-perfect and 33.18% source-linked code, with 12,002 of 12,904 functions matching and a byte-identical rebuilt DOL that still links extracted objects for unfinished code; its README gives slightly higher 2026-09-29 figures. The port compiles the decomp’s 588 game, JSystem and THPPlayer units, so non-matching functions can still diverge from retail. It reports scripted headless runs hashed against a baseline and compared between 32- and 64-bit builds, lockstep tracing against retail Dolphin captures and qemu-ppc checks of math routines.", "The port is MIT-licensed (SoftwareAura LLC) and the decomp fork is CC0-1.0; the game and the user’s disc contents keep separate rights. AI involvement is stated by the fork’s README and agent guides, which describe Claude and Codex orchestrators." ], "requirements_zh": [ "仅针对北美版 GMSE01 Rev 0。README 报告 32 位 Linux 与 macOS 版本可游玩，64 位 Linux 可游玩但仍在逐关测试，64 位 Windows 可在 Wine 下启动并附有原生运行检查。macOS 构建 x86_64 程序，在 Apple Silicon 上经 Rosetta 2 运行，因为原生 arm64 无法将游戏内存映射到 4 GiB 以下。", "需要使用者自己的 GMSE01 Rev 0 光盘镜像，格式为 .iso、.gcm 或 Dolphin .ciso；移植在运行时从中读取模型、纹理、关卡、音乐和影片，本身不附带游戏数据。提供镜像时，构建还会生成内含游戏文件的独立可执行文件，README 说明不得分享。可选的语言包、纹理包和高清过场包需另行获取。", "build.sh 与 run.sh 调用 CMake、Python 3、patch、SDL2 和宿主编译器：默认的 32 位 Linux 构建使用 Ubuntu／Debian 多架构 GCC，macOS 使用面向 x86_64 的 Homebrew LLVM clang，Windows 使用 MSYS2 MINGW64 GCC。反编译子模块固定在 sms-english 967436b；仅限 PC 的改动以补丁形式应用于其源码副本，另行构建一致 mario.dol 的反编译工程使用自己的 GameCube 工具链。", "在该固定版本中，分支的 PROGRESS.md 报告截至 2026-09-27：模糊相似度 99.57%、逐字节一致代码 72.94%、由源码链接的代码 33.18%，12,904 个函数中有 12,002 个匹配；重建的 DOL 与原版逐字节一致，但未完成部分仍链接提取出的目标文件。其 README 给出 2026-09-29 略高的数字。移植编译反编译中的 588 个游戏、JSystem 和 THPPlayer 单元，因此未匹配的函数仍可能与原版不同。项目报告了按基线哈希核对、并在 32 位与 64 位构建间比较的脚本化无界面运行，与原版 Dolphin 捕获数据的逐步追踪对照，以及在 qemu-ppc 下检查数学例程。", "移植项目采用 MIT 许可（SoftwareAura LLC），反编译分支采用 CC0-1.0；游戏本身及使用者光盘内容的权利另行保留。AI 参与情况来自分支 README 和智能体指南（其中描述 Claude 与 Codex 编排流程）。" ], "targets": [ "game" ], "url": "https://github.com/chasem-dev/sms-pc-port", "verification": "source-reviewed", "verified_at": "2026-10-18" }