cc-reverse

KO | EN

gitlite — search

#javascript #ai #go #rust #deep-learning #linux #nodejs #macos #java #windows #kubernetes #security #ios #mcp

(★ 277)

Cocos Creator逆向工具

cc-reverse 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# cc-reverse

Cocos Creator 逆向工程工具，用于从编译后的 Cocos Creator 游戏中提取和重建源代码与资源。

> 💡 **想用自然语言驱动？** 试试配套的 Claude Code 插件 [cocos-reverse-engineering-skill](https://github.com/Crain99/cocos-reverse-engineering-skill) —— 一句 `/reverse-cocos path/to/build` 完成依赖检查 / 版本识别 / JSC 解密 / 反向 / 资源编目全流程。

## 项目热度

如果您觉得这个项目对您有帮助，请给我们一个 Star ⭐️，这是对我们最大的鼓励！

[![GitHub Stars](https://img.shields.io/github/stars/Crain99/cc-reverse?style=for-the-badge&logo=github&label=Stars)](https://github.com/Crain99/cc-reverse/stargazers)

## 功能特性

- 解析和重建 Cocos Creator 项目结构（2.3.x / 2.4.x / **3.x**）
- 提取并转换游戏脚本和资源文件
- 处理 UUID 和元数据信息
- 支持场景、预制体、动画等资源的提取
- **支持 Spine 骨骼动画资源提取**（骨骼数据 + Atlas 图集 + 纹理）
- **支持 DragonBones 骨骼动画资源提取**（骨骼数据 + 图集 + 纹理）
- 生成符合 Cocos Creator 格式要求的项目文件
- **支持 JSC 加密文件自动解密**（XXTEA + gzip，自动提取密钥，覆盖 2.x `main.js` 与 3.x `application.js` / `src/settings.json`；按 magic 校验解密结果，错误密钥不再误报成功）
- **支持 Cocos Creator 2.3.x / 2.4.x / 3.x 版本自动检测**
- **3.x bundle 感知**：自动发现 `assets/main`、`assets/internal`、`assets/resources` 及自定义 bundle；按 `config.json` 还原每个资源的原始项目路径
- **CCON 二进制解码**（`.cconb` / `.ccon` v1 与 v2）：解析 magic、版本头与对齐 chunk；v2 的 notepack(MessagePack) body 也能解码还原
- **脚本恢复**：2.x 把打包后的 `project.js` 拆分为每文件 `.ts`（browserify 切片 + AST 兜底，保留 `cc._RF` UUID 挂载）；3.x 复制 `src/chunks/*.js`（SystemJS 模块）
- **2.x packed 资源还原**：按 `settings.packedAssets` 拆分场景 / 预制体 / SpriteFrame / 音频，并拷贝 `raw-assets`
- **恢复报告**：输出目录生成 `RECOVERY_REPORT.md`（脚本格式、资源统计、3.x bundle 表）

## 版本支持

### Cocos Creator 2.3.x 及以下
- 文件结构：`src/settings.js`, `src/project.js`, `res/` 目录
- 自动检测并使用相应的解析逻辑

### Cocos Creator 2.4.x
- 文件结构：支持多种构建输出格式
- 资源路径：`assets/` 或 `res/` 目录
- 配置文件：`main.js`, `settings.js`, `project.js` 等
- 使用 `--version-hint 2.4.x` 强制指定版本

### Cocos Creator 3.x
- 文件结构：`application.js` + `src/settings.json` + `assets/<bundle>/config.json` + `src/chunks/*.js` + `cocos-js/`
- 按 bundle 独立解析 `config.json`（`paths` + `uuids` + `types` + `versions` + `extensionMap`）
- 资源按原始项目路径（`assets/main/scenes/Main.scene` 等）还原，并生成匹配的 `.meta`
- 支持 **CCON v1**（JSON 内嵌 + 8 字节对齐 chunks）与 **CCON v2**（notepack/MessagePack body 解码为 JSON 文档；无法解码时回退保留 `.ccon-v2.rawjson`）
- 加密：仅 bundle 级 `index.jsc`，可通过 `--key` 传入或从 `application.js` / `src/settings.json` 自动抽取
- 使用 `--version-hint 3.x` 强制指定版本；`--bundle <name>` 只处理指定 bundle（可重复）

## 安装

### 全局安装

```bash
# 全局安装
npm install -g cc-reverse

# 使用
cc-reverse --path <源项目路径>
```

### 项目安装

```bash
# 克隆仓库
git clone https://github.com/Crain99/cc-reverse.git
cd cc-reverse

# 安装依赖
npm install

# 使用
npm start -- --path <源项目路径>
```

## 使用方法

### 命令行参数

```
选项:
  -V, --version            显示版本号
  -p, --path <path>        源项目路径
  -o, --output <path>      输出路径 (默认: "./output")
  -v, --verbose            显示详细日志
  -s, --silent             静默模式，不显示进度
  -k, --key <key>          JSC 文件的 XXTEA 加密密钥
  --version-hint <version> 提示Cocos Creator版本 (2.3.x|2.4.x|3.x)
  --bundle <name>          仅处理指定 bundle (3.x，可重复)
  --assets-only            跳过脚本阶段
  --scripts-only           跳过资源阶段
  --script-format <format> 强制脚本包格式 (browserify|webpack|cocos-rf|unknown)
  --no-ast-fallback        脚本切片失败时不回退全量 AST
  -h, --help               显示帮助信息
```

输出目录会生成 `RECOVERY_REPORT.md`（脚本格式/提取器、资源统计、3.x bundle 表等）。

### 示例

```bash
# 基本用法
cc-reverse --path ./games/sample-game

# 指定输出目录
cc-reverse --path ./games/sample-game --output ./extracted-game

# 显示详细日志
cc-reverse --path ./games/sample-game --verbose

# 强制 browserify 切片，失败不走 AST
cc-reverse --path ./games/sample-game --script-format browserify --no-ast-fallback

# 静默模式
cc-reverse --path ./games/sample-game --silent

# 指定Cocos Creator版本(当自动检测失败时)
cc-reverse --path ./games/sample-game --version-hint 2.4.x

# 处理2.4.x版本项目
cc-reverse --path ./games/cocos24x-game --version-hint 2.4.x --verbose

# 解密 JSC 加密项目（手动指定密钥）
cc-reverse --path ./games/encrypted-game --key "your-xxtea-key"

# 解密 JSC 加密项目（自动提取密钥）
cc-reverse --path ./games/encrypted-game

# 处理 Cocos Creator 3.x 项目（自动检测 bundle 结构）
cc-reverse --path ./games/cocos3-game --verbose

# 3.x：仅处理 main 与 resources bundle
cc-reverse --path ./games/cocos3-game --bundle main --bundle resources

# 3.x：跳过脚本，仅导出资源
cc-reverse --path ./games/cocos3-game --assets-only

# 强制以 3.x 解析（自动检测失败时）
cc-reverse --path ./games/cocos3-game --version-hint 3.x
```

### 配置文件

您可以在项目根目录创建 `cc-reverse.config.js` 配置文件来自定义工具行为：

```js
module.exports = {
  // 输出配置
  output: {
    createMeta: true,
    prettify: true,
    includeComments: true
  },
  
  // 代码生成配置
  codeGen: {
    language: "typescript", // "typescript" 或 "javascript"
    moduleType: "commonjs", // "commonjs", "esmodule", 或 "amd"
    indentSize: 2,
    indent: "space" // "space" 或 "tab"
  },
  
  // 解密配置
  decrypt: {
    key: null // XXTEA 加密密钥，也可通过 --key 参数指定
  },

// 资源处理配置
  assets: {
    extractTextures: true,
    extractAudio: true,
    extractAnimations: true,
    optimizeSprites: false,
    spriteOutputMode: "single" // "single"（逐张导出）或 "atlas"（图集模式）
  }
}
```

## 支持的资源类型

| 资源类型 | 说明 | 输出格式 |
|---------|------|---------|
| 场景 (cc.SceneAsset) | 游戏场景文件 | `.fire` |
| 精灵帧 (cc.SpriteFrame) | 精灵图集帧数据 | PLIST + PNG |
| 音频 (cc.AudioClip) | 音频资源 | 原始格式 |
| 动画 (cc.AnimationClip) | 动画剪辑 | `.anim` |
| 文本 (cc.TextAsset) | JSON 文本资源 | `.json` |
| Spine 骨骼 (sp.SkeletonData) | Spine 骨骼动画 **新增** | `.json` + `.atlas` + `.png` |
| DragonBones 骨骼 (dragonBones.DragonBonesAsset) | 龙骨骨骼数据 **新增** | `_ske.json` |
| DragonBones 图集 (dragonBones.DragonBonesAtlasAsset) | 龙骨图集数据 **新增** | `_tex.json` + `_tex.png` |
| **3.x 资源** | | |
| 3.x 场景 (cc.SceneAsset) | 3.x 场景文件 | `.scene` + `.meta`（按 config.json 原始路径） |
| 3.x 预制体 (cc.Prefab) | IFileData 格式保留，可重新导入编辑器 | `.prefab` + `.meta` |
| 3.x ImageAsset / Texture2D / SpriteFrame | 根据 extensionMap 复制 `.png/.jpg/.webp/.pvr/.pkm/.astc` | native 原格式 + meta |
| 3.x Mesh / AnimationClip / Terrain | CCON v1 解码后输出 JSON 文档；chunks 保留为 `.chunkN.bin` | `.json` + `.chunkN.bin` |
| 3.x EffectAsset / Material | Shader 源/IR 保留为 JSON | `.effect` / `.mtl` + meta |
| 3.x BufferAsset / TextAsset / JsonAsset | 原 native 副本 | `.bin` / `.txt` / `.json` + meta |

## 注意事项

- 此工具主要用于学习和研究目的
- 支持 XXTEA 加密的 JSC 文件解密，需通过 `--key` 参数提供密钥或由工具自动从项目文件中提取
- 建议先在简单的开源项目上测试（例如"合成大西瓜"）
- 请遵守相关法律法规和软件许可协议

## 项目结构

```
cc-reverse/
├── src/                     # 源代码目录
│   ├── core/                # 核心功能模块
│   │   ├── codeAnalyzer.js  # 代码分析器
│   │   ├── converters.js    # 格式转换器
│   │   ├── jscDecryptor.js  # JSC XXTEA 解密
│   │   ├── projectGenerator.js # 项目生成器
│   │   ├── resourceProcessor.js # 资源处理器
│   │   ├── reverseEngine.js # 逆向工程引擎（版本检测 + 分发）
│   │   ├── typeDefinitions.js # 2.x 内置类型属性表
│   │   └── cocos3x/         # Cocos Creator 3.x 专用模块
│   │       ├── bundleConfig.js    # config.json 解析 + URL 还原
│   │       ├── ccon.js            # CCON 二进制解码
│   │       ├── deserializer.js    # IFileData 轻量内省
│   │       └── engine3x.js        # 3.x 项目重建总调度
│   ├── utils/              # 工具函数
│   │   ├── fileManager.js  # 文件管理工具
│   │   ├── logger.js       # 日志工具
│   │   └── uuidUtils.js    # UUID 工具
│   ├── config/             # 配置文件
│   │   └── configLoader.js # 配置加载器
│   └── index.js           # 主入口文件
├── bin/                    # 命令行工具
│   └── cc-reverse.js       # 命令行入口
├── cc-reverse.config.js    # 示例配置文件
├── package.json            # 项目依赖配置
└── README.md               # 项目说明文档
```

## 依赖项

- @babel/* - JavaScript 解析和生成工具
- commander - 命令行解析
- chalk - 终端颜色支持
- ora - 终端加载动画
- progress - 进度条
- xxtea-node - XXTEA 加解密
- pako - gzip 解压
- 其他工具库 (async, uuid, string-random 等)

## 开发

```bash
# 开发模式运行
npm run dev

# 代码检查
npm run lint

# 运行测试
npm run test

# 构建
npm run build
```

## 支持项目

如果您觉得这个项目对您有所帮助，请考虑给我们一个 Star ⭐️！您的支持是我们持续改进的动力。

## 鸣谢

- [luckyaibin/cocoscreatorjscdecrypt](https://github.com/luckyaibin/cocoscreatorjscdecrypt) — JSC 文件 XXTEA 加解密参考

## 许可证

MIT

## 贡献

欢迎提交问题报告和改进建议！

cc-reverse

cc-reverse 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

cc-reverse

cc-reverse 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README