CTFAK2.0 - Clickteam Fusion军刀的更新版本

项目说明

> [!CAUTION]
> CTFAK 2.0 is no longer being worked on and thus has been archived.

Welcome to CTFAK 2.0!

By Kostya and Yunivers

Discord
| Table of Contents | Description |
|--|--|
| What was CTFAK 2.0? | A short description of what CTFAK 2.0 was and what it was used for. |
| Installation | How to install a precompiled of CTFAK 2.0. |
| Compilation | How to compile CTFAK 2.0 manually. |
| Usage | How to use CTFAK 2.0. |
| Parameters | All CTFAK 2.0 parameters. |
| Command Arguments | All CTFAK 2.0 command arguments. |
| Full Credits | E who helped make CTFAK 2.0 a reality. |

What was CTFAK 2.0?

CTFAK 2.0 (Standing for ClickTeam Fusion Army Knife 2.0) was a tool de by Kostya with help from Yunivers which can be used to either decompile or dump assets of games made with the Clickteam Fusion 2.5 game engine.

With CTFAK 2.0's plugin system, it was easy for anyone to make a plugin compatible with CTFAK 2.0 which allows you to do anything with the data read by CTFAK 2.0 including, but not limited to, con the data to other game engines, programming your own dumping method to suit however you want to organize your data, or messing with the outputted data by modifying the FTDecompile plugin.

CTFAK 2.0 was split between 2 branches; the master branch and the 2.3 branch.<br/>
CTFAK 2.3 is more unstable than CTFAK 2.2, thus this README will only be referring to the 'master' branch, also known as CTFAK 2.2, which is the recommended .

Installation

> [!NOTE]
> Due to unforseen circumstances, Actions are no longer being offered. See Compilation

Compilation

Dependencies

CTFAK 2.0 required .NET 6.0's Desktop Runtime.

After running the x64 installer, you may proceed with the compilation.

Cloning the repo with Studio 2022

Make sure you have Studio 2022 installed and open.

On the GitHub branch, click Code and copy the HTTPS URL.

In Studio 2022, under Get started, click Clone a repository, then paste the HTTPS URL from earlier. Input your desired path and press Clone.

Compiling CTFAK 2.0

Right click the solution on the right and press Build Solution or do it through the key bind Control + Shift + B, then right click the solution once again and press Open Folder in File Explorer.

In the File Explorer go to Interface\CTFAK.Cli\bin\Debug\net6.0-windows and create a folder called Plugins, then go back to the solution folder and browse into Plugins and in both CTFAK.Decompiler and Dumper, browse to bin\Debug\net6.0-windows, and copy CTFAK.Decompiler.dll, CTFAK.Decompiler.pdb, Dumper.dll, and Dumper.pdb then paste them into the Plugins folder you created earlier.

Finally, download ctfakrequirements.zip and extract the contents into the same folder you created Plugins in. To know you' it properly, template.mfa should be found in the same folder as CTFAK.Cli.exe.

Now, you should be able to run CTFAK.Cli.exe without problems!

Usage

CTFAK 2.0 was very easy to use and required little input from the user.

To get started, open CTFAK.Cli.exe and drag in your Clickteam Fusion 2.5 exe, apk, ccn, dat, bin, or mfa file and press enter.

In parameters, you could input anything listed in Parameters, but make sure to put a - before each one. If you don't want to input any parameters (which you normally shouldn't need to do) then you can leave it blank. After you' out your parameters, press enter.

If you're using a .ccn, .dat, or .bin file it would bring up a prompt asking you to select a file reader. In any case, select CCN.

If all goes according to plan, you should see a screen saying Reading finished in _ seconds along with some information about the game. From here you may run any plugins you ha. Normal installations should have Export as MFA, Dump E, Image Dumper, Sound Dumper, Packed Data Dumper, and Sorted Image Dumper.

> [!WARNING]
> Please do not report any issues. CTFAK 2.0 is no longer being worked on. Please do not bother us about it.

Finally, you may close CTFAK 2.0 and find any outputs your plugins gave, in the Dumps folder.

Parameters

All parameters should start with -.
| Parameter | Description |
|--|--|
| onlyimages | Prevents CTFAK 2.0 from reading any data unrelated to images. |
| noimg | Prevents CTFAK 2.0 from reading any images. |
| noevnt | Prevents CTFAK 2.0 from reading any events. |
| nosounds | Prevents CTFAK 2.0 from reading any sounds. |
| noalpha | Prevents CTFAK 2.0 from reading any alpha on images. |
| sorteddumpstrings | Has CTFAK 2.0 dump strings to text files alongside images in the Sorted Image Dumper. |
| srcexp | Forces CTFAK 2.0 to read a Source Explorer output. The unsorted output should be in a newly made ImageBank folder within your CTFAK 2.0 folder. |
| notrans | Prevents CTFAK 2.0 from applying Alpha, Color, or Shaders to objects. |
| noicons | Prevents CTFAK 2.0 from writing any object icons. |
| trace_chunks | Forces CTFAK 2.0 to write all chunks to CHUNK_TRACE. |
| dumpnewchunks | Forces CTFAK 2.0 to write chunks without a reader to UnkChunks. You must create this folder yourself. |
| f1.5 | Forces CTFAK 2.0 to read the input as MMF 1.5. |
| f3 | Forces CTFAK 2.0 to read the input as CTF 3.0. |
| android | Forces CTFAK 2.0 to read the input as android. |
| excludeframe([id]) | Forces CTFAK 2.0 to ignore the specified frame. ID indexes at 0. |
| log | Causes CTFAK 2.0 to log thread information about the Sorted Image Dumper. |
| badblend | Forces CTFAK 2.0 to revert to the old blend coeff fix. |
| chunk_info | Has CTFAK 2.0 log the size and offset of chunks. Also logs effects. |

Command Arguments

These are command arguments for batch files or running CTFAK through cmd.
All arguments should start with - and should be followed up by data wrapped in quotations if data is required for said argument.
| Argument | Description |
|--|--|
| path | Automatically starts reading the inputted file path. |
| ____ | Leaving the arguments blank allows you to do the same thing as '-path'. |
| parameters | Allows you to input parameters that CTFAK 2.0 will read. |
| forcetype | Forces the kind of file type the file will be read as. Options: 'exe', 'apk', 'ccn', 'mfa' |
| tool | Uses the name of a plugin (such as 'Decompiler') to run said tool as soon as it's done reading. |
| closeonfinish | Closes CTFAK 2.0 after it finishes reading, or if you are using '-tool', after it finishes running the plugin. |

Full Credits

|Name| Credit for... |
|--|--|
| Mathias Kaerlev | De of Anaconda Mode 3. |
| Kostya | De of CTFAK and CTFAK 2.0. |
| Yunivers | De of CTFAK 2.0. |
| Slxdy | Assistant de of CTFAK 2.0. |
| RED_EYE | De of the decryption library. |
| LAK132 | Coding help for the Image Bank rewrite. |
| Liz | Coding help for Child Events, Sub-App port. |

CTFAK 2.0 is licensed under AGPL-3.0.

Readme Last Updated No 6th, 2024.

项目信息

开发语言：C#

Star 数：158

技术要点

该项目属于CTF思路方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕Updated version of the Clickteam Fusion Army Knife Decompiler展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。