Help

Troubleshooting

Most failed jobs come from the clip itself. Most problems in game come from a missed full restart.

The job failed

When an AI Animations job fails, you are not charged, and a free first animation stays available. The result page shows an error code and a message; the next two sections cover the common ones. Most are fixed with a different clip.

Clip rejected: length, format, no person

Error	Fix
`Video too short`	The clip has to be at least 2 seconds long.
`Unsupported video codec`	Only H.264 and HEVC work. Export or record the clip as MP4 with H.264; screen recorders and some web downloads use other codecs such as VP9.
`ANIMATION_WHAM_NO_PERSON`	No person was found. Make sure one person is clearly visible, head to toe, and not too small in the frame.
`Clip too long`	Shown in the dialog before upload. Cut the clip to 20 seconds, or 60 with Premium.

Video too short
The clip has to be at least 2 seconds long.
Unsupported video codec
Only H.264 and HEVC work. Export or record the clip as MP4 with H.264; screen recorders and some web downloads use other codecs such as VP9.
ANIMATION_WHAM_NO_PERSON
No person was found. Make sure one person is clearly visible, head to toe, and not too small in the frame.
Clip too long
Shown in the dialog before upload. Cut the clip to 20 seconds, or 60 with Premium.

If the job fails in the motion step with a general error, try Premium quality or a cleaner clip. See Recording a good clip.

No hands could be detected

With finger tracking on, the job stops with No hands could be detected in this video when the hands are not clearly visible. You are not charged. Run it again without finger tracking, or with a clip where the hands face the camera.

The animation does not play in game

Full restart. Restart the whole server after installing, then reconnect. The chat shows an error if the dictionary could not be loaded.
server.cfg. The ensure line must name the folder you created, and that folder must contain fxmanifest.lua directly, not inside another folder.
Command name. Check the exact command on the result page. After a rename it changes.

The animation looks wrong

What you see	Usual cause and fix
Lying, tilted or rotated body	A moving or tilted camera, or a move done on the floor. Run it again with Premium, or with a clip filmed level from a fixed spot.
Floating, sliding or jittery legs	Feet out of frame or a shaky camera. Keep the whole body in frame; choose Premium for handheld clips.
The wrong person animated	Several people in the clip. Crop or trim so only one person is visible.
Different from the preview	You installed the walking version or another clip. The preview shows the clip selected in Original, Loop or Ping-pong.

Lying, tilted or rotated body
A moving or tilted camera, or a move done on the floor. Run it again with Premium, or with a clip filmed level from a fixed spot.
Floating, sliding or jittery legs
Feet out of frame or a shaky camera. Keep the whole body in frame; choose Premium for handheld clips.
The wrong person animated
Several people in the clip. Crop or trim so only one person is visible.
Different from the preview
You installed the walking version or another clip. The preview shows the clip selected in Original, Loop or Ping-pong.

Small problems at the start or end, or jitter, can often be fixed in the animation editor with Edit animation on the result page.

Not enough credits

When your balance is below the price, Generate stays off and the dialog shows Not enough credits for this animation with the missing amount and buttons to top up or upgrade. The cheapest run is Basic without add-ons, 750 credits.

Still stuck

Use Report a problem at the bottom right of the animation page, so we see the job you mean, or ask in the SwisserAI Discord. Mention the animation name and what you see in game.