Skip to content

SombrAbsol/acftool

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

acftool

Linux Nightly Windows Nightly License: MIT (Expat)

ACF unpacking and building tool. Based on a fork of acfdump, an ACF unpacking tool originally created by Barubary in Java and ported here to C.

ACF files are used in Pokémon Ranger: Guardian Signs data. This tool allows you to extract and decompress the files they contain, as well as rebuild ACF files and create your own. 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 reconstructed ACF files, but reconstructed files 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:

Getting the ACF files

  1. Download, extract and launch NDSFactory
  2. Open the program, load your ROM, then press the Extract Everything button and choose where to save your files
  3. Once the process is complete, go to the Fat Tools tab, fill in the first three fields with the requested files you just extracted (fat_data.bin, fnt.bin and fat.bin), then press the Extract FAT Data! button and choose where to save your files
  4. Go to your output directory. ACF files are located in the data folder

Running acftool

File extraction

  • To extract a specific ACF file, run acftool -d <file>.acf
  • To extract every ACF files in a directory, run acftool -d <directory>

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

ACF building

To build an ACF file, run acftool -b <folder>. Please note that the target folder 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: gcc, make (optional)

  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 either run gcc -O3 -Wall -Wextra -Werror -o acfdump or make if you have it installed

Credits

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.