Awesome
Sausage64
<img src=".github/Catherine.gif" width="179" height="281"/>Sausage64 is a plugin for Blender 2.7 onwards, which allows you to export (as well as import) "sausage link" style character models with animations.
The plugin exports the data as an easily parsable text file. This file should be simple to convert to other formats, more suitable for your target platform.
The plugin's code is documented, and contains a ton of helper classes that store the information before exporting. This should allow you to modify the script to instead output the data in a format you want, as opposed to an intermediary format like s64.
This repository contains five folders:
Plugin
- The Blender plugin itself. Installation instructions provided in a further section of this README.Sample Model
- An example character model with animations, with the source files available alongside the .s64 file exported by the plugin.Catherine.blend
is for 2.7, withCatherine 2.8.blend
for Blender versions 2.8 onwards.Sample Parser
- An example Sausage64 to N64 display list converter, written in C. More info about the program in the folder's README.Sample Previewer
- An example Sausage64 model previewer, written in C++ and OpenGL. More info about the program in the folder's README.Sample Library
- An example library for the N64, designed for the output fromSample Parser
. More info about the library in the folder's README.Sample ROM
- An example N64 ROM (written in Libultra and Libdragon) displaying the character and the animations in action, with the help of theSample Library
. The .s64 file and the materials were converted to display lists and other parsable data with theSample Parser
program. More information available in the folder's README.
What do you mean by Sausage Links?
Sausage link characters are made out of different unconnected segments. This is also known as "hierarchical modeling".
<img src=".github/mario.png" width="274" height="415"/> <sup>Photo taken from: https://bradh2002.wordpress.com/a2-task-3-video-game-history/</sup> </br></br>This method of character design was highly popular in the N64 and PS1 era, where animating vertex skinned characters was considered a very heavy operation. Instead, these models leverage the fact that each segment can easily be transformed via a matrix.
Installation
- Grab the python files that are inside the
Plugin
folder. - Open Blender, and go to your user preferences.
- Go to the addons tab, and select
Install...
orInstall from File
button (the name depends on your version of Blender). - Find the python script in the file browser and open it.
- The script
Sausage64 Character Export
should appear. Tick the checkbox to enable it. - The script
Sausage64 Character Import
should also be there. Tick the checkbox to enable it if you want it. - If you are on Blender 2.8 onwards, you're all set! If you are on an earlier version of Blender, you will get a warning that the script is for a newer version of Blender. You can safely ignore this warning. Don't forget to press the
Save User Preferences
button.
S64 file format, Usage Instructions, FAQ, and More
For more information, please check the wiki. Please note that the Wiki is only updated every release, therefore the information might not match what is in the current repository.
Suggestions and bugs
Please submit suggestions or bugs to the issues page.