doyaGu/Ballanced
GitHub: doyaGu/Ballanced
Ballanced 是经典游戏 Ballance 的逆向工程项目，对游戏运行时各组件进行了源码级重实现，构建出与原版兼容的完整运行时布局。
Stars: 43 | Forks: 3
# Ballanced
本仓库是游戏 **Ballance** 的逆向工程项目。
它包含了游戏运行时组件（玩家、引擎库、构建模块、插件等）的源码级重新实现，并将其构建为兼容 Ballance 的运行时目录布局。
## 状态
本项目从源码构建了完整的运行时布局。你仍然需要原版 Ballance 游戏资源才能运行该游戏。
## 环境要求
- Windows
- Visual Studio 2022 (MSVC) 或 MinGW-w64
- CMake 3.16+
支持的 Windows 架构：
- `Win32` (x86)
- `x64`
- `ARM64`
## 快速开始（构建）
### 配置
PowerShell 示例 (Visual Studio 2022)：
```
# Win32 (x86)
cmake -S . -B build -G "Visual Studio 17 2022" -A Win32
# x64
cmake -S . -B build-x64 -G "Visual Studio 17 2022" -A x64
# ARM64
cmake -S . -B build-arm64 -G "Visual Studio 17 2022" -A ARM64
```
PowerShell 示例 (MinGW-w64)：
```
cmake -S . -B build-mingw -G "MinGW Makefiles"
```
### 构建
```
# 多配置 generators (Visual Studio)
cmake --build build --config Release
# 单配置 generators (MinGW Makefiles)
cmake --build build-mingw
```
构建树的输出放置在：
- `build/Ballance/`
### 暂存（安装）可运行布局
```
# 多配置 generators (Visual Studio)
cmake --build build --config Release --target stage
# 单配置 generators (MinGW Makefiles)
cmake --build build-mingw --target stage
```
暂存输出放置在：
- `build/stage/`
### 运行
暂存完成后，主入口点是：
- `build/stage/Bin/Player.exe`
## 测试
本仓库包含了用于验证暂存运行时布局的 CTest 检查：
```
# 多配置 generators (Visual Studio)
ctest --test-dir build -C Release
# 单配置 generators (MinGW Makefiles)
ctest --test-dir build-mingw
```
## 游戏资源（原版 Ballance）
**Ballanced** 需要原版 Ballance 安装目录中的游戏资源才能运行。
重要提示：
- 本仓库**不**附带 Ballance 游戏资源。
- 请合法获取原版游戏，并使用您自己拥有的游戏文件。
### 资源暂存（可选）
如果您在 CMake 中指定一个现有的 Ballance 安装目录，`stage` 目标可以将资源复制到暂存的布局中：
```
cmake -S . -B build -G "Visual Studio 17 2022" -A x64 `
-DBALLANCE_ASSETS_ROOT=C:/path/to/your/Ballance
cmake --build build --config Release --target stage
cmake -S . -B build-mingw -G "MinGW Makefiles" `
-DBALLANCE_ASSETS_ROOT=C:/path/to/your/Ballance
cmake --build build-mingw --target stage
```
## 发布版本
预构建的二进制文件发布在 GitHub releases 上：
- https://github.com/doyaGu/Ballanced/releases
## 致谢
如果没有以下各方的支持，这个项目是不可能完成的：
- 原版 **Ballance** 开发者，感谢他们制作了这款令人难以置信的游戏。
- 开源社区，感谢其为本项目提供的工具和资源。
- 所有在代码、测试和调试方面提供帮助的贡献者。
## 联系方式
如果您有任何问题，请随时在 GitHub 上开启一个 issue。
标签：ARM64, Ballance, Bash脚本, C++, CMake, MinGW, UML, Visual Studio, x64, x86, 云资产清单, 安全意识培训, 平衡球, 开源游戏, 数据擦除, 游戏, 游戏 runtime, 游戏引擎, 源码级重制, 跨平台编译, 软件重构, 逆向工程