Head Animation Tutorial

Head animations are one of the more finicky things to deal with in Freespace, and have taken a lot of effort for people to figure out. It's actually not as hard as it looks. In essence, a head animation is an animated PNG (or .ani, more on that later) that the engine plays every time that

Terran talking heads

1. Create a short MP4 video - 8 seconds long of a person talking. You can use any MP4 video for this. For my retro-style heads, I used Adobe Firefly's video generator with Google's Veo 3.1 model. You'll obviously have to tweak it to your liking. A sample prompt is:

a light-skinned woman with a braid wearing a futuristic, minimalistic, light-colored uniform in a starship hallway. the woman has a neutral expression and is wearing a headset. the woman is talking continuously into the camera. the video is in greyscale with scan lines. the video is from a 3D playstation 1 game from 1999.

2. Downsize the video to 160 x 120. Yes, that's very, very small, and it's what's required by the Freespace engine. [EZGif.com] has good online, easy-to-use video tools for this.

3. Divide the shrunken video into three 2.66 second files. [EZGif.com] also works for this. (Head animations must to be in sets of three.)

4. Convert the three files into APNG. Again, [EZGif.com] is great at this for beginners.

5. Drop the files into your mod's /data/hud folder.

6. Make sure your file names are appropriate for Freespace 2. In most cases, the Freespace engine requires you to use a mandatory file naming scheme of filenameA.png, filenameB.png and filenameC.png. The A and B files are used for normal chatter. The C file is unique: in pilot heads, it's used for the death animation. In other heads, it's used for normal chatter as well. Samples are included below.

7. Extra step for pilot death heads: I created my death animations by doubling the speed of original animation, and stitching a "transmission lost" video to the end. EZGif has tools for this.

Vasudan talking heads

For this, it requires three extra steps.

1. I took screenshots of the specific stance and camera angle that I wanted to use of Oddgrim's Vasudan Pilot model and Oddgrim's Vasudan model.

2. After that, I uploaded the screenshot to Firefly and asked Firefly to generate a background. Again, you'll have to play around with this.

the subject of the reference image is sitting in a futuristic cockpit. the lighting is high-contrast. there are scan lines. the image looks like a AAA video game. the result is a close-up of the subject.

3. Once you have a suitable reference image, then you can feed back into Firefly and use it as a first frame. Just be warned: Firefly does some really, really weird things with Vasudan head animations, and there will be a lot of trial and error. In the end, the only way that I got it to work was by prompting it with language that sounded like a nature documentary.

A close-up of a creature with a smooth, toothless mouth moving its head from side to side as it breathes. The creature does make eye contact with the camera, maintaining an unaware posture. The camera remains fixed. The video has a vintage, retro style with noticeable scan lines, adding a nostalgic and slightly distorted aesthetic.

4. Once you have a suitable video, follow the instructions for Terran anis.