acftool

ACF archive utility for Pokémon Ranger: Guardian Signs. Based on a fork of acfdump, an ACF extraction tool originally created by Barubary in Java and ported here to C.

ACF archives are used in Pokémon Ranger: Guardian Signs data. This tool allows you to extract the files contained in ACF archives, automatically handling decompression when needed, and to rebuild these archives. You can download the latest nightly or build the program from source.

For more information on the ACF format, see the documentation.

Please note that the ACF building process is currently insufficient. File extraction works fine on original and rebuilt ACF archives, while rebuilt archives work in-game but do not match their originals.

Download

	Linux	Windows
Release
Nightly	Download	Download

Usage

Dumping the ROM

You can dump your own Pokémon Ranger: Guardian Signs ROM from:

• a console from the Nintendo DS or Nintendo 3DS family (Game Card release)
• a Wii U (Virtual Console release)

Getting the ACF archives

To get the ACF archives, Windows users can run TinkeDSi, but NDSFactory can also be run on macOS and Linux:

1. Download the latest NDSFactory release, then extract the archive and run the executable
2. Open the program, load your ROM, then scroll down until you see the FAT Files Address field. Take note or copy its value
3. Press the Extract Everything button and choose where to save your files
4. Once the process is complete, go to the Fat Tools tab, and fill in the first three fields with the requested files you just extracted (fat_data.bin, fnt.bin and fat.bin) and the fourth with the value from the previous FAT Files Address field
5. Press the Extract FAT Data! button and choose where to save your files
6. Go to your output directory. ACF archives are located in the data directory

Running acftool

ACF Extraction

• To extract files from an ACF archive, run acftool e <file.acf>
• To extract files from every ACF archives in a directory, run acftool e <directory>

The output files will be located in a directory with the same name as the input ACF archive.

ACF Building

To build an ACF archive, run acftool b <directory>. Please note that the target directory must contain a filelist.txt file listing the files to be compressed and a Boolean compression value (0: do not compress; 1: compress), for example:

0000.RTCA 0
0001.NCLR 1
0002.NCGR 1
0003.NCER 1
0004.CANR 1

Building

Dependencies: clang or gcc, make (optional, preferred)

1. Clone this repository by running git clone https://github.com/SombrAbsol/acftool, or download the ZIP archive and extract it
2. Go to the repository directory and build the project. You can run make if you have it installed, or one of the following commands depending on the compiler you have installed:

clang -O3 -Wall -Wextra -Werror -o acftool acftool.c

gcc -O3 -Wall -Wextra -Werror -o acftool acftool.c

TODO

• Fix LZ10 compression
• Add ACZ support
• Add containers (FPKD, NPCD…) support(?)

Credits

• acftool by SombrAbsol
• acfdump and ACF documentation by Barubary (the original acfdump is available on his website)

License

acftool is free software. You can redistribute it and/or modify it under the terms of the Expat License as published by the Massachusetts Institute of Technology.