Aspasia1337/Aspasia

# Aspasia - Counter-Strike 2 逆向工程框架

**Aspasia** 是一个 C++ 研究框架，用于研究和原型化 *Counter-Strike 2 (CS2)* 中的游戏操作技术。它是作为马德里卡洛斯三世大学硕士论文的一部分开发的。 该项目与随附的论文文档密切相关，该文档探讨了实现细节、设计理由以及游戏作弊和逆向工程的更广泛背景。虽然 Aspasia 并非旨在用于公共比赛中的不公平竞争，但它作为一个工具，可以帮助理解游戏和反作弊系统在底层是如何工作的。 ## 免责声明 本仓库仅用于研究和教育目的。它是作为个人学习历程以及对游戏安全和逆向工程进行学术探索的一部分而开发的。 不支持也不鼓励使用此软件在网络游戏中获得不公平优势。话虽如此，具备足够技术知识和进行自定义修改的个人可能会将其调整用于此类用途。这样做需要绕过 Valve 反作弊系统 (VAC) 实施的各种验证机制，包括在 `steamservice.dll` 等模块中发现的完整性检查。虽然有些过时，但 [danielkrupinski 的 vac-hooks 仓库](https://github.com/danielkrupinski/vac-hooks) 为这些技术提供了有用的见解。 最终，您需对使用此代码库可能产生的任何使用或后果承担全部责任。 ## 1. 游戏内预览：功能演示

UI demonstration of the in-game menu system, featuring tab navigation and real-time configuration.

Aimbot with smoothing (interpolation) and chams enabled for both visible and hidden targets.

Animated preview of anti-aim behavior and overlay visuals in action.

Flashbang effect disabled during gameplay, enabling uninterrupted visual clarity.

Smoke rendering bypassed to maintain full visibility in obstructed areas.

Live gameplay preview showing multiple features working together in a real match context.

Chams and skeletal overlays for target visualization and debugging.

Real-time bone overlays showing all entities in view for runtime inspection.

UI menu with chams tab open, used for configuring material and visibility settings.

Close-up of USP-S and player arms using custom chams.

Close-up of M4A1 and player arms using custom chams.

## 2. 主要功能概览 - **自瞄系统** - Hitbox 选择和 FOV 限制 - 使用插值因子进行平滑瞄准 - **Chams 渲染** - 自定义材质和实体可见性覆盖 - 支持隐藏和可见状态 - **反自瞄 / 假身** - 下身偏航 (LBY) 操作 - **实体分析** - 通过 OnAddEntity / OnRemoveEntity 进行运行时跟踪 - 内存结构监控 - **移动研究** - 自动连跳 - **视觉清晰度调整** - 禁用闪光弹和烟雾渲染以获得无遮挡视野 - **光照和天空调制** - 调整游戏内环境光照和天空盒颜色值，以增强可见性或自定义美学效果 - **玩家覆盖层增强** - 为可见玩家显示生命条、骨骼骨架和装备武器指示器 ## 3. 项目结构 | 目录 | 描述 | |---|---| | `Features/` | 单独的功能模块（自瞄、视觉效果、反自瞄、移动、杂项） | | `HooksManager/` | 通过 MinHook 进行 Hook 设置和生命周期管理 | | `EntityManager/` | 通过 `OnAddEntity` / `OnRemoveEntity` 回调进行实体跟踪 | | `Interfaces/` | CS2 运行时接口解析 | | `Classes/` | 游戏类定义和内存布局结构体 | | `helper/` | PE 工具和杂项辅助函数 | | `math/` | 向量数学 | | `includes/` | 第三方库（ImGui, Kiero, MinHook, offsets） | | `thesis/` | 学术论文、幻灯片、截图和 GIF | ## 4. 编译与设置 ### 4.1 系统要求 - Windows 10/11 (x64) - Visual Studio 2019 或更高版本 - DirectX SDK (2010 年 6 月) - ImGui 和 MinHook（已包含） - C++17 支持 (`/std:c++17`) - 仅 `x64` 配置得到积极维护和测试 ### 4.2 构建说明 1. 下载该仓库为 ZIP 或使用 Git for Windows： git clone https://github.com/Aspasia1337/Aspasia.git 2. 在 Visual Studio 中打开 `Aspasia Solution.sln`。 3. 将构建配置设置为 `Release x64`。 4. 构建解决方案 —— `Aspasia.dll` 将在输出目录中生成。 ## 5. 注入指南与运行时行为 本项目不包含注入器。由于 Valve 反作弊系统 (VAC) 的性质，`LoadLibrary` 等标准注入方法是可检测的且不安全。 为了在受控环境中安全使用，加载器应支持： - 手动映射 - 内核辅助注入 - 内存隐藏或混淆技术 如果注入成功，将出现一个显示日志的游戏内控制台。这确认了正确的加载和 Hook 初始化。

进入游戏后，可以使用 `INSERT` 键打开主菜单。 ## 6. 研究意图与范围 Aspasia 不是传统的作弊工具——它是一个研究工具。 它的设计目的是： - 演示逆向工程和游戏操作技术 - 建立典型的反作弊检测面 - 作为内存检查和实时实验的平台 它特别适用于沙盒或离线环境中的教育演示。 ### 技术说明（截至 2026 年 4 月） - 反作弊模块流式传输目前处于**禁用**状态 —— 此时 VAC 模块未推送到客户端。 - 最重要的检测逻辑位于 **`client.dll`** 中，这是大部分完整性和行为检查实现的地方。 ## 7. 学术背景 本项目是作为马德里卡洛斯三世大学硕士论文的一部分开发的。一份完整的书面论文随附于该仓库，详细说明了实现、背景以及对游戏安全的思考。 | 资源 | 描述 | 链接 | |---|---|---| | 论文 (PDF) | Aspasia 项目的完整学术撰写 | [阅读论文](https://github.com/Aspasia1337/Aspasia/blob/main-ui/thesis/memoria.pdf) | | 幻灯片 (PDF) | 带有功能视觉效果的 Beamer 演示文稿 | [查看幻灯片](https://github.com/Aspasia1337/Aspasia/blob/main-ui/slides/slides.pdf) | 特别感谢 **Alexey Zabashta** 提供的 [ITMO Beamer Theme](https://www.overleaf.com/latex/templates/itmo-beamer-theme/fpttrgnmqwsb)，它作为演示幻灯片的基础。 ### 致谢 本项目是从学习角度出发，作为我学术旅程的一部分而开发的。许多代码是在时间紧迫的情况下为准备论文演示而编写的。我希望分享这项工作能对其他人有用，就像 UnknownCheats、GuidedHacking 和许多其他社区对我所做的那样。 ## 8. 潜在改进 本项目作为论文提交已完成，不再积极开发。以下被确定为未来的工作领域： - **代码重构**：改进 C++ 代码库的模块化、命名和清晰度 - **加密字符串**：使用编译时混淆宏（例如 `XORSTR`） - **动态 Schema 管理器**：自动解析 netvars 和 offsets - **更智能的目标选择**：使用预测和优先级逻辑改进自瞄选择逻辑 - **皮肤更改器**：带有自定义皮肤的库存模拟 ## 9. 许可与使用条款 本项目在 **GNU General Public License v3.0** 下获得许可。 您可以： - 将代码用于学术、个人或教育目的 - 在相同许可下修改和重新分发它 - 研究和调整它，前提是衍生作品必须在 GPL-3.0 下保持开源 有关完整条款，请参阅 [`LICENSE`](./LICENSE) 文件。 **Aspasia** — 通过攻防分析探索 Counter-Strike 2 的内部工作原理。

标签：C++17, Counter-Strike 2, CS2, HTTP头分析, JARM, UI界面, VAC, Valve Anti-Cheat, Windows x64, 云资产清单, 内存分析, 反作弊, 外挂原型, 学术研究, 操作系统, 游戏作弊, 游戏安全, 硕士论文, 软件开发, 逆向工程