Sonic Adventure Toolset

SA Tools is a toolkit for modifying and extracting data from the Sonic Adventure series of games. Before using these tools, we recommend having an understanding of basic 3d theory. If you're unfamiliar with the topic, read this overview here.

Download SA Tools

Download SA Tools - x64 version (recommended)

Download SA Tools - x86 version

.NET Desktop Runtime 7.0 - install the Desktop runtime matching the version of SA Tools (x86 or x64).

Development build (x64, manual updates only):

Quick Links

The following links will direct you to pages on the wiki to help get you started with modding.

• Making Mods or Ripping Assets
• Contributing or working with the SA Tools source code

Contacting us with issues:

You are encouraged to first check the wiki to see if it can assist in your problem. If this is inadequate, please check the issues here on Github. If your issue has not previously been posted, we encourage you to post the issue here. Your issue should include the following:

• A clear, concise description of the problem
• Steps to reproduce the problem. If you cannot get the problem to happen on-command, we can't fix it
• Media such as screenshots or video that help illustrate the issue.

Real-time assistance & discussion

The toolkit developers (and other community members familiar with it) are frequently available at:

• The official x-hax Discord server
• The official x-hax IRC server: irc://irc.badnik.zone/x-hax

Building SA Tools from source

After cloning the repository, build in either Debug or Release mode for x86 or x64. After the build has completed, run the program buildSATools.exe in the solution's root folder. The files will be located in the output folder. You could specify a different location as a command line argument for buildSATools.exe, e.g. buildSATools D:\SATools.

Alternatively, you could open individual tools from Visual Studio by starting a new Debug instance. Only Debug builds are supported in this mode.

External Resources

Below are two wikis that were created to help in both mod creation and documenting assets in the PC titles.

• SADX Modding Guide
• SA2PC Modding Guide