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 - 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):
The following links will direct you to pages on the wiki to help get you started with modding.
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.
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
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.
Below are two wikis that were created to help in both mod creation and documenting assets in the PC titles.