luispolis124/OpenTS3-DS
GitHub: luispolis124/OpenTS3-DS
一个将《模拟人生3》NDS版反编译并重构为现代跨平台PC引擎的开源逆向工程项目。
Stars: 1 | Forks: 0
# OpenTS3DS，也称为 Open The Sims 3 DS
一个针对**《模拟人生 3》（Nintendo DS）**的开源逆向工程与原生 PC 移植项目。
## 关于本项目
**Open The Sims 3 DS** 的目标是对原始的 Nintendo DS 游戏代码进行反编译，并将其重构为一个现代的、可跨平台移植的游戏引擎。本项目旨在保留原始的游戏逻辑，同时使其能够在 PC 上原生运行，并支持更高的分辨率、现代的输入方式以及更好的性能。
## ⚠️ 重要提示：ROM 与区域限制要求
**本项目不包含原始游戏 ROM。** 要使用 OpenTS3DS，您必须提供自己合法获取的《模拟人生 3》（Nintendo DS）副本。
**注意：** 目前，本项目仅支持该游戏的**北美（USA）**版本。使用其他区域的 ROM 将会导致数据不匹配，且引擎将无法正常运行。
## 项目状态
* [x] 数据结构映射 (entity.h)
* [x] 引擎架构与构建流水线 (CMake)
* [ ] 实体系统的实现
* [ ] 渲染器的实现
* [ ] PC 端可移植性 (Windows/Linux)
## 仓库结构
* src/: 引擎源代码。
* include/: 包含内存定义和结构的头文件。
* asm/: 来自原始代码的汇编参考，用于对比。
* build/: 编译输出目录。
## 如何构建
要构建本项目，您将需要 **CMake** 和一个 C 编译器（GCC、Clang 或 MSVC）。
1. 克隆仓库：
git clone https://github.com/luispolis124/OpenTS3-DS.git
2. 创建构建目录：
mkdir build && cd build
3. 配置并构建：
cmake ..
cmake --build .
## 文档与法律
* **LICENSE:** 项目的许可条款 (GPLv3)。
* **CONTRIBUTING:** 代码贡献指南。
## 技术与鸣谢
本项目使用了以下开源库：
* **SDL2:** 窗口管理和输入处理 (zlib 许可证)。
* **SDL_mixer:** 多声道音频混合 (zlib 许可证)。
* **OpenGL:** 硬件加速的 3D 渲染。
## AI 辅助开发
本项目的代码结构、文档以及转换协助是在人工智能工具的支持下生成或完善的。所有由 AI 生成的输出内容均已由项目维护者进行验证和整合，以确保准确性和符合项目标准。
## 致谢
* 灵感来源于 OpenRCT2 和 OpenMW 等项目的社区努力。
* 特别感谢所有参与 Nintendo DS 软件保护工作的人员。
## 许可证
本项目是一项用于教育的逆向工程成果。请确保您拥有原始游戏的合法副本。
标签：Bash脚本, C/C++, CMake, SDL2, 事务性I/O, 云资产清单, 客户端加密, 游戏, 游戏引擎, 逆向工程