Skip to content

ACF extraction and building tool.

License

Notifications You must be signed in to change notification settings

SombrAbsol/acftool

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

acftool

Linux Nightly Windows Nightly License: MIT (Expat)

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 reconstructed ACF archives, but reconstructed archives 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 archives

  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 archives are located in the data directory

Running acftool

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.

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: 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 acftool 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.