x0152/star-heritage-engine

# 星际遗产 1：黑眼镜蛇 冒险游戏《星际遗产 1：黑眼镜蛇》（Step Creative Group / 1C，2005 年）的跨平台引擎。它是 1995 年 ZX Spectrum 游戏的重制版。 你将扮演一名坠毁在未知星球上的地球特工，必须在 与奴役人类的 Artangs 战斗的同时寻找回家的路。这是一款包含昼夜交替、 战斗以及 Elite 宇宙中非线性故事情节的第一人称 冒险游戏。   ## 这是什么 原版游戏是 2000 年代初的一个封闭的 Windows 引擎。它几乎无法 在现代系统上运行。本项目是一个完整的逆向工程成果。我们 从头重建了归档和模型格式、Lua 5.0 字节码处理、渲染、 输入、声音、视频和战斗逻辑。最终成果是一个全新的引擎 （C++、SDL3、Lua 5.0），它可以直接原样运行原有的脚本和资源。 - `engine/` - 引擎源码和 Lua runtime - `tools/` - BPK 解包、资源解码、安装和 HD 放大 由于版权原因，游戏资源**不**包含在此 repo 中。你需要自己 拥有该游戏的副本（推荐使用 1.24 补丁）。 ## 开始使用 macOS 上的依赖项： ``` brew install cmake sdl3 assimp sevenzip innoextract ffmpeg ``` 只需一条命令，即可从 [archive.org](https://archive.org/details/starheritage1) 下载光盘和补丁，解包资源， 并构建引擎（约 1 GB；会跳过已下载的文件）： ``` python3 tools/setup.py ./run.sh ``` 你也可以将本地光盘镜像、安装程序或已安装的游戏 文件夹作为参数传入。请参阅 `tools/setup.py`。 ## HD 纹理（可选，速度较慢） 在正常构建之后，你可以将所有图像（背景、UI、图标、 光标、模型纹理）放大到 `resources/hd/` 目录中。引擎会 自动识别它们。这需要很长时间（在 GPU 上需要数小时），并且需要 [Real-ESRGAN ncnn-vulkan](https://github.com/xinntao/Real-ESRGAN/releases)： ``` ./tools/upscale_hd.sh ``` 你可以随时停止并在以后继续。已经处理完成的文件会被跳过。 ## 工具 - `tools/setup.py` - 从 archive.org / 光盘 / 安装中获取资源，然后进行构建 - `tools/upscale_hd.sh` - 将所有纹理放大到 `resources/hd/` 目录中 - `tools/bpk.py` - 列出并提取 BPK 归档 - `tools/decode_tree.py` - 原地解码资源树 - `tools/unzip_x.py` - 解包 MSZIP 压缩的 DirectX `.x` 模型

标签：Bash脚本, C++, 云资产清单, 冒险游戏, 数据擦除, 游戏引擎, 逆向工具, 逆向工程