Skip to content
This repository has been archived by the owner on Dec 4, 2024. It is now read-only.
/ CTFAK-UnEx Public archive
forked from CTFAK/CTFAK2.0

An unfinished, experimental version of the Clickteam Fusion Army Knife Decompiler. Was meant for the original repository, but it's not stable enough in my opinion, but works far better for some games.

License

Notifications You must be signed in to change notification settings

AITYunivers/CTFAK-UnEx

 
 

Repository files navigation

Caution

CTFAK 2.0 is no longer being worked on and thus has been archived, thus the same goes for this repo.

Welcome to CTFAK 2.0 (UnEx)!

By Kostya and Yunivers

Discord

Table of Contents Description
What is CTFAK UnEx? A short description of what CTFAK UnEx is and why it exists.
Installation How to install a precompiled version of CTFAK UnEx.
Compilation How to compile CTFAK UnEx manually.
Usage How to use CTFAK UnEx.
Parameters All CTFAK UnEx parameters.
Command Arguments All CTFAK UnEx command arguments.
Full Credits Everyone who helped make CTFAK UnEx a reality.

What is CTFAK UnEx?

CTFAK UnEx (Standing for ClickTeam Fusion Army Knife Unfinished Experiment) was an experimental version of a tool developed 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.

CTFAK UnEx existed only to store a version of CTFAK 2.0 I never finished and never published on the real repo due to lack of stability.

Installation

Dependencies

Note

Due to unforseen circumstances, Actions are no longer being offered. See Compilation

Compilation

Dependencies

CTFAK UnEx required .NET 6.0's Desktop Runtime.

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

Cloning the repo with Visual Studio 2022

Make sure you have Visual Studio 2022 installed and open.

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

In Visual 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 UnEx

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.

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

Usage

CTFAK UnEx was very easy to use and requires 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 can 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've filled out your parameters, press enter.

If you're using a ccn, dat, or bin file it will 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 have installed. Normal installations should have Export as MFA, Dump Everything, Image Dumper, Sound Dumper, Packed Data Dumper, and Sorted Image Dumper.

Do not use the Restart CTFAK option as it is non-functional. Please remember that this is an unfinished version of CTFAK.

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 UnEx and find any outputs your plugins gave, in the Dumps folder.

Parameters

All parameters should start with -.

Parameter Description
onlyimages Prevents CTFAK UnEx from reading any data unrelated to images.
noimg Prevents CTFAK UnEx from reading any images.
noevnt Prevents CTFAK UnEx from reading any events.
nosounds Prevents CTFAK UnEx from reading any sounds.
noalpha Prevents CTFAK UnEx from reading any alpha on images.
sorteddumpstrings Has CTFAK UnEx dump strings to text files alongside images in the Sorted Image Dumper.
srcexp Forces CTFAK UnEx 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 UnEx from applying Alpha, Color, or Shaders to objects.
noicons Prevents CTFAK UnEx from writing any object icons.
trace_chunks Forces CTFAK UnEx to write all chunks to CHUNK_TRACE.
dumpnewchunks Forces CTFAK UnEx to write chunks without a reader to UnkChunks. You must create this folder yourself.
f1.5 Forces CTFAK UnEx to read the input as MMF 1.5.
f3 Forces CTFAK UnEx to read the input as CTF 3.0.
android Forces CTFAK UnEx to read the input as android.
excludeframe([id]) Forces CTFAK UnEx to ignore the specified frame. ID indexes at 0.
log Causes CTFAK UnEx to log thread information about the Sorted Image Dumper.
badblend Forces CTFAK UnEx to revert to the old blend coeff fix.
chunk_info Has CTFAK UnEx 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 UnEx 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 'Export as MFA') to run said tool as soon as it's done reading.
closeonfinish Closes CTFAK UnEx after it finishes reading, or if you are using '-tool', after it finishes running the plugin.

Full Credits

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

CTFAK 2.0 and CTFAK UnEx is licensed under AGPL-3.0.

Last Updated December 4th, 2024.

About

An unfinished, experimental version of the Clickteam Fusion Army Knife Decompiler. Was meant for the original repository, but it's not stable enough in my opinion, but works far better for some games.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

 

Packages

No packages published

Languages

  • C# 95.4%
  • C++ 2.7%
  • C 1.9%