Salt & Steel: Animation System

Document type: Production — Animation
Status: Canonical
Last updated: 2026-04
See also: Art Direction | VFX System | Sound Design | Combat Systems | Naval Systems

Overview

Animation is the system that makes the world believe itself. Every other production department can deliver its best work — the most beautiful environment art, the most spectacular VFX, the most carefully composed music — and if the characters move wrong, the player will feel the wrongness without being able to name it. Animation is the part of the game that works on the player's body, not their mind. It bypasses analysis and operates on physical intuition.

Salt & Steel's animation philosophy flows directly from the game's visual identity and tone. The Kirby principle — exaggerated, purposeful, full of energy and personality — applies to animation as much as to character design. The world is larger than life; the characters move as if they know it. Combat has weight and impact because the body knows what those things feel like and recognizes when they are faithfully rendered. The sea is alive because the ship on it moves as real ships move.

The organizing principle for all animation decisions: purpose before prettiness. Every animation should do something: communicate information, establish personality, deliver emotional content, or confirm game-mechanical feedback. Animation that exists for its own visual complexity, without communicating something specific, is waste.

Core Animation Philosophy

Weight and Impact

The most important single quality in Salt & Steel's combat animation is weight. Combat in this world is physical, consequential, and dangerous. The animation must communicate that physically — through the mechanics of how bodies move when they are doing violent things.

The physics of weight in animation:

Attacks build through a kinematic chain. A cutlass swing does not originate at the wrist. It originates in the feet, transfers through the legs, rotates through the hips, travels up the torso, extends through the shoulder, runs down the arm, and finally reaches the blade. An attack animation that begins at the arm is a floaty attack animation. An attack animation that begins at the feet is a weighted one.
Follow-through and recovery. Real attacks do not stop at the point of contact. They continue through — the body carries momentum past the target, then decelerates, then returns to a stable state. The attack animation is the approach and commitment; the recovery animation is the deceleration and return. Both phases must be present and honestly timed.
Foot planting. Weighted animation requires the feet to be planted or moving in ways that make physical sense. Footwork in combat is a tactical and physical necessity, not an aesthetic choice. The feet tell you where the weight is.

The anti-floaty rule: An attack animation in which the character's feet leave the ground, the torso rotates without hip involvement, or the recovery time is shorter than the buildup time is a floaty animation. Floaty animations feel wrong to players even if they cannot articulate why. Any animation that fails the weight test fails review.

Impact sell: When an attack connects with a target, the target's animation sells the impact as much as the attacker's. A light hit moves the target backward slightly and staggers their recovery. A heavy hit physically displaces the target — they stumble, they lose their footing, they have to fight to regain their stance. A critical hit produces an exaggerated sell that briefly suspends the normal physical constraints — a brief slow in the target's response time, a larger stumble — before returning to real physics. The impact is sold by the receiving body.

Active Defense Animation

Salt & Steel's GURPS-derived active defense system (Dodge, Parry, Block) means the player is frequently choosing a defense type in response to incoming attacks. These defenses must be visually distinct from each other at combat distance — a player watching their own character or an enemy should be able to identify which defense was used without any UI annotation.

Dodge:

Full-body commitment in a direction — the character physically moves their body away from the incoming attack's line
For melee dodge: a step or dive that takes the body off the attack's path entirely
For projectile dodge: a lower movement — ducking, weaving — with the head leading
Recovery: the character returns to a combat stance from the dodge position, with a moment of rebalancing
The dodge must travel a visible distance — it is not an in-place animation. A dodge that does not visually move the character is not a dodge.

Parry:

The weapon meets the incoming attack — the character's blade intercepts the attacker's blade
The parry has two phases: commitment (the weapon moving into the intercept line) and absorption (the character's arm and body absorbing the redirected force)
A successful high-skill parry shows minimal force absorption — the blade is redirected efficiently. A barely-successful parry shows significant force absorption — the character's arm is pushed wide, requiring a recovery moment to bring the weapon back on line.
The parry has a specific contact point that the VFX system marks (documented in vfx-system.md)

Block (shield):

The shield is brought to interpose between the incoming attack and the character's body
The shield has physical mass — it does not just appear in the right position; the character's arm and shoulder drive it there
On contact, the shield visibly absorbs force — the arm compresses back slightly, the body leans into the block. A large impact shows the character planting their rear foot and leaning their whole body weight into the shield.
After the block, the shield returns to ready position — a deliberate, controlled movement that communicates the shield's weight

Combat Stance Transitions

The character's combat stance — which weapon is drawn, which guard position is held — changes based on context. These transitions must be visible, not instantaneous:

Weapon draw:

The hand goes to the weapon's resting position at the hip or back
The grip is established — fingers wrapping, a brief check that the grip is correct
The weapon is drawn with appropriate clearance geometry — a cutlass drawn from a scabbard at the left hip has a specific draw arc
The free hand comes to a guard position simultaneously
The character settles into their weapon-specific combat stance

Weapon sheathe:

The reverse of the above, with the specific challenge of putting a weapon away without looking at the sheath
Experienced characters do this with casual confidence. Low-skill characters may have a brief fumble — not enough to be embarrassing, but enough to be honest.

Stance switching mid-combat (when cycling between weapon options):

No instant swap. The weapon being holstered must be secured before the next weapon is drawn.
This takes time — enough time to be a real tactical consideration. Swapping weapons in Salt & Steel is not a free action; it has a window of vulnerability that the animation communicates clearly.

Idle combat stance variation:

Characters in combat stance do not stand perfectly still. They shift their weight, make small footwork adjustments, present and withdraw weapon presence in short feints. This microfidget animation is procedurally derived from the character's weapon skill level:
High-skill characters move with economical confidence — small, purposeful adjustments
Low-skill characters move with more energy, less economy — they're working harder to maintain the same readiness
The motion tells you something about who the character is before a single attack is thrown

On-Foot Combat Animations

Attack Combinations

Salt & Steel's GURPS-derived combat allows multiple attacks per round with diminishing reliability. The animation system must communicate the character's commitment across a multi-attack sequence:

First attack in sequence: Full commitment and buildup. The kinematic chain from feet to blade, proper follow-through, full recovery time.

Second attack in sequence: Launched from whatever recovery position the first attack ended in. Slightly reduced buildup (the body is already in motion) but still honest in its physics. Slightly shorter recovery — not a penalty, just efficiency.

Third attack and beyond: Each additional attack in a sequence shows increasing urgency — the body is not returning to neutral between attacks, it is chaining from one commit to the next. By the third attack, the character is visibly working — the economical precision of the first strike has given way to a more aggressive, less technically perfect fury. This is accurate to GURPS's diminishing returns on multiple attacks.

Exhausted attack sequence: When a character's Fatigue Points are depleted, their attack animations change quality — slightly slower buildup, more pronounced recovery need, a physical honesty about the cost of extended combat.

Magic Casting Animations

Magic in Salt & Steel is physical — it costs Fatigue Points (GURPS energy), and the body shows the cost of casting.

Tide magic: The caster's hands and arms take the lead, with specific gesture vocabulary that suggests water direction — open palms pressing forward for a wave surge, gathering motion for a pull, a rotating gesture for a whirlpool. The gestures are not random; they are the physical enactment of directing a large quantity of water. After significant casting, the caster's arm briefly drops — the weight of having sustained that motion.

Flame arts: The casting gesture involves the whole upper body — the flame begins in the hands but the chest and core are engaged for larger effects. A small flame effect is hands-only. A full Burning Sea requires the caster to plant both feet, lower their center of gravity, and physically push the effect outward from their core. The effort is visible.

Shadow work: Counter-intuitively, Shadow Work should have the most restrained casting animations. The magic operates on the unseen. Small gestures — a pointing finger, a slow turn of the wrist — produce disproportionate effects. This restraint is more unsettling than large gestures would be. The Finger ability is literally a pointed finger. The horror is in the proportion.

Bone singing: Involves the voice — the caster's mouth opens, and the animation sells the act of singing. The body posture of a bone singer casting is the specific posture of a person who is genuinely singing: the diaphragm engaged, the chest open, the chin at the angle that allows full voice production. The ghosts respond to a singer, not a gesticulator.

Naval Combat Animations

Cannon Crew Operations

Naval combat requires crew animations for cannon operation that are technically accurate and physically honest. A cannon does not fire itself — there are specific human operations required, and each one has its own animation:

Loading sequence (the full reload cycle):

Worming: A crew member uses a worming staff to clear the bore of any debris from the previous shot — a rotating motion with the staff, pulling backward
Sponging: A wet sponge on a staff is rammed down the bore to extinguish any embers — a push-hold-pull motion, with the crew member braced against the cannon's recoil support
Cartridge loading: The powder cartridge (a cloth bag of powder) is carried from the ready ammunition storage and placed at the muzzle, then rammed home
Shot loading: The cannonball is placed at the muzzle and rammed home behind the cartridge
Priming: The touch hole is picked clear; the primer is inserted
Running out: The cannon is pushed forward on its carriage to the firing position — a crew effort animation showing multiple hands on the cannon carriage's tackle ropes
Aiming: The gun captain leans to sight along the cannon, directing crew members to adjust elevation with the quoin (an elevation wedge)
Fire command: The gun captain signals, steps clear of the recoil path, and the designated crew member touches fire to the primer

This full sequence should be visible and legible for the player's own ship's cannon operations, with the animation time matching the game's reload mechanic cooldown. The crew's work is the explanation for why reloading takes time.

Cannon recoil animation: The cannon fires — and immediately rolls backward on its carriage by 1–2 meters, following the recoil path defined by the angled deck planking beneath it. This is a significant physical event: the cannon weighs hundreds of pounds, and its recoil is substantial. The animation sells this weight. The carriage wheels roll; the tackle ropes that control the recoil run taut; the cannon comes to a stop against the ropes' resistance.

Ship Hull Rolling with Waves

The ship's movement on the water is an animation system, not a static physics response. The hull should roll convincingly with wave conditions:

Calm seas: Gentle, long-period roll — the ship moving through its full side-to-side range very slowly (10–15 second period), with a slight corkscrewing (combined pitch and roll) from the diagonal approach of gentle swells.

Moderate seas: More pronounced roll (15–20 degrees), shorter period (5–8 seconds), irregular — wave groupings mean the ship has a complex motion that is not a simple pendulum.

Heavy seas: Large-amplitude roll (up to 30–35 degrees), short periods, with additional pitch motion (the bow rising and falling to swells) layered on the roll. Individual waves may produce sharp, short jerks rather than smooth oscillation.

Storm conditions: The ship's motion becomes violent enough that the on-deck crew animations must account for it — characters hold lines, grab rails, brace against masts, plant feet wide. A person standing normally on a deck that is rolling 30 degrees in 4 seconds would fall down; the animation system must communicate why they do not.

The ship as dynamic camera platform: The ship's roll affects every first-person and close-camera angle. The world tilts with the ship. This is not a camera bug to be corrected — it is the most visceral communication of being at sea.

Sail Physics

The sails are the ship's primary power system and one of its most visually dynamic elements:

Full sail in good wind: Canvas fills with wind — the sail billows forward, the seams tighten, the material has a taught, pressurized quality. The VFX team provides the billowing visual; the animation system ensures the sail's attachment points (boom, yard, sheets) move in physically consistent ways.

Luffing sail: When the wind angle is wrong, the sail begins to flap — the edge nearest the wind starts to flutter and collapse while the bulk of the sail still has pressure. This should look exactly like what it is: a sail that is losing its wind. The animation of a luffing sail communicates a navigation problem without any UI.

Reefed sail: Canvas gathered and secured to the boom — a compact, bundled visual against the yard. The act of reefing (pulling the canvas in and tying it) involves crew animation: sailors climbing the ratlines, moving out onto the yards, gathering canvas with both hands. These crew animations are some of the most visually distinctive in the game — people working at height on a moving ship.

Sail damage: A sail hit by cannonball or grapeshot shows the damage honestly: a hole with torn edges, or a vertical rip from top to bottom if the damage was severe. The damaged sail behaves differently from an intact one — the torn sections flutter free, reducing the sail's effective area and changing its visual silhouette.

Creature Animation Principles

Personality Through Movement

Every creature in Salt & Steel should move in a way that communicates who they are — not just what they are capable of mechanically. The Kirby principle of grotesque beauty requires that creatures have presence, and presence is primarily communicated through movement quality.

Movement quality differentiation:

Large sea creatures (sea serpents, giant squid): Slow and inevitable. They do not rush because they do not need to. Their movements are deliberate and large-scale — a serpent's head turning to fix you with its gaze is a whole-body motion. The slowness is more threatening than speed would be, because it communicates certainty. The creature knows it will reach you.

Medium combat creatures (shark-men, reef-lurkers, coral elementals): More reactive, more aggressive. These creatures move with the specific energy of something that hunts actively — they track targets with their eyes before their bodies commit, they feint and redirect, they have the predator's patience followed by sudden explosion of speed.

Small creatures (venomous marine creatures, cursed crabs, reef swarms): Fast, numerous, their movement unpredictable in aggregate. Individual small creatures may have specific animation personalities (a crab that raises its claws in threat display, a snake-fish that sways before striking) but the swarm behavior is emergent from many small-movement individuals.

Humanoid enemies (pirates, cultists, naval soldiers): Human movement range, but with the specific physical identity of their type. A brawler moves differently from a fencer. A soldier moves differently from a street fighter. The combat animation style communicates the character's fighting tradition before any mechanical context is provided.

Creature Idle Behavior

Creatures between active combat states have distinct idle behaviors that communicate their nature:

Territorial creatures: They establish their territory through movement — regular patrol routes that mark the edges of their range, turning movements that scan the area, postures of presence (raised crests, spread fins, elevated body positions).

Ambush creatures: The antithesis of territorial — minimal movement, maximally still, the animation being the absence of animation. An ambush predator that moves betrays itself. The stillness of a creature in ambush mode should be uncanny — this thing is alive but it is not moving.

Social creatures: School fish, pack hunters, and creatures with complex social behavior have animation sets that include social interactions — nipping, following behaviors, threat displays directed at each other as well as at the player.

Feeding behavior: A creature engaged in feeding is not in combat and should not move like it is in combat. A sea creature feeding has the focused, purposeful movement of something engaged in the specific physical task of eating. This is important for creating pre-encounter moments where the player sees a creature before engaging it.

Death and Kill Animations

Creature deaths are events. Not visual accidents — events with specific structures:

Small creature death: Brief. The creature's movement stops, the body posture collapses into death, the body settles. 1–2 seconds. The brevity serves the pace of combat.

Medium creature death: A death animation that includes a final physical expression of the creature's nature. A shark-man doesn't just fall — it falls the way something that fought hard falls. The animation may include a death-blow reaction (the specific movement in response to the final hit's direction and type) followed by a collapse with some physical honesty (a heavy creature falls with more momentum than a light one).

Boss deaths: Full staged event animations, unique to each boss. The boss death is a cinematic moment that can break normal gameplay physics rules — a brief slow, a camera adjustment, an extended animation sequence. These animations are story moments as much as gameplay moments. The creature's death should communicate something about what it was: a creature of the deep sea dies in the way its nature dictates, whether that is a slow sinking, an explosive release of its contained supernatural energy, or a simply magnificent physical collapse.

Environmental Animation

Wave System Animation

The ocean wave system is a continuous environmental animation that must look real at every scale:

Surface waves: The animation of the sea surface is a mathematical wave simulation layered with artistic control — the wave parameters produce physically plausible behavior (wave refraction around islands, wave interference patterns between opposing swells) while allowing artists to adjust the visual character of specific regions' waters.

Breaking waves: Where deep water transitions to shallow, waves begin to break — the physics of wave shoaling, the specific curl-and-crash of waves meeting a reef or beach, the white-water aftermath of a broken wave. These breaking animations are the most complex in the wave system and the most visually distinctive.

Ship bow wave: The water displaced by the ship's bow produces a specific V-shaped bow wave pattern that persists and spreads outward from the ship's heading. This animation is generated from the ship's speed and heading, not manually animated — it is a physics-informed procedural effect.

Rope and Rigging Physics

The ship's rigging is a complex system of ropes, spars, and pulleys that should move physically in response to wind and ship motion:

Procedural rope simulation: All ropes and lines on the ship should be physically simulated — hanging in catenary curves when slack, stretching taut when loaded, swinging and swaying with ship motion. The visual complexity of a tall ship's rigging in motion is one of the game's distinctive visual features, and it should be earned by real physics.

Flag and pennant animation: Flags and pennants should fly from their staffs and yards in response to wind direction — streaming taut in a strong wind, hanging limp in calm, snapping and cracking in the burst of a squall.

Lantern swing: Ship's lanterns hang from fixed points and swing with ship motion. In calm conditions: gentle, slow swing. In heavy weather: violent arcs that spray moving light across the deck in dramatic patterns. The lantern's motion is both visually beautiful and functionally honest.

Port and Environment

Building elements: Port buildings have cloth elements (awnings, laundry, market stall covers) that animate in wind. The animation parameter (cloth simulation settings) should be tuned so that the cloth elements communicate wind speed and direction visually — a useful navigational clue in port approach sequences as well as an animation system detail.

Vegetation: Jungle, coastal shrubs, and palm trees animate in wind following the same principles as the cloth — responding to wind speed with appropriate physical behavior. In calm: minimal movement. In storm: palms bent dramatically, coconut fronds streaming horizontal.

Water interaction with environment: Waves meeting dock pilings, cliff faces, and beach sand should produce accurate-to-setting spray and splash animations. The spray from waves against a cliff face is a visually spectacular moment that the animation system should handle consistently.

Transition Animations

Transition animations are the moments between gameplay modes — from ship to shore, from surface to underwater, from dock to the open city. These transitions must be seamless, immersive, and as brief as possible while remaining honest to their physical content.

Boarding an Enemy Ship

The most complex transition in the game — from naval combat into on-foot boarding action:

Phase 1: Approach
Ships are in contact range. Grapple hooks are deployed (crew animation, VFX documented in vfx-system.md). Rope lines pull the ships together — the animation of the ships drawing closer is driven by the grapple ropes tightening, with the ship hulls visibly approaching each other until they make contact (a collision shock through both ships' motion systems).

Phase 2: Boarding plank
A boarding plank is dropped between the two rails — a heavy physical event. The crew members who deploy it physically strain against its weight. It slams into the enemy rail and the character is running before it has fully settled.

Phase 3: The crossing
The boarding plank crossing is brief but present — the character runs across a narrow plank between two ships that are still moving relative to each other. The plank's animation reflects this: it moves, the character's balance animation reflects moving on an unstable surface.

Phase 4: Enemy deck
The transition into boarding combat should feel like stepping from one world into another — and it does, because it is. The naval battle's ambient sounds (cannon, waves, rope) continue in the background. The foreground changes to immediate personal combat.

Diving Underwater

The transition from surface to underwater:

Approach to dive point: The character reaches the edge — a ship's side, a cliff edge, a dock. A brief ready animation — looking down, possibly testing the depth with a hand or foot.

Entry: The dive itself — a clean entry for a prepared dive, an ungainly splash for an unplanned entry (falling overboard in combat, for example). The dive animation reflects the character's Maritime skill level: a high-skill navigator dives efficiently; a poor-swimmer character enters the water awkwardly.

Transition underwater: The audio and visual transition (documented in sound-design.md and art-direction.md) is accompanied by an animation of the character orienting to the underwater environment — the brief disorientation of the transition from air to water, then the shift to the specific movement system of underwater locomotion.

Underwater movement: The character moves differently underwater — slower horizontal movement, more vertical mobility, the specific resistance quality of moving through water (not the floating quality of zero-gravity, but the resisted quality of actual swimming). The animation must communicate water resistance throughout.

Climbing Rigging

When the character climbs the ship's rigging — up the ratlines to the crow's nest, out along a yard — the animation is physically honest to what climbing rigging actually involves:

Ratlines: The ropes that form the ladder portion of the rigging. The character climbs hand-over-hand, feet finding the horizontal rope rungs, body moving upward in the specific rhythm of rope ladder climbing. The ship's motion affects the ratline animation — in heavy weather, the ratlines swing as the ship rolls, and the character's animation adapts.

Out on a yard: Moving laterally along the horizontal spars requires a different animation — arms out on the yard itself for balance, feet on the footrope below the yard, the body balanced over the footrope in the specific posture of a sailor working aloft. This is a distinctive, visually striking animation that rewards close observation.

Emotional Animation

Crew Reactions

The crew are characters, and they have emotional responses to events. The animation system must support this:

Celebration (after a successful battle, treasure discovery, or narrative victory):
The crew's celebration animations should be specific and culturally appropriate — not generic raised-fists-and-whooping. A crew from the Norse-inspired regions celebrates differently from a crew from the Caribbean Confluence region. The animation library should have region-specific celebration vocabularies. Celebrations are spontaneous — they trigger after the event, at the crew's own initiative, which makes them feel real rather than programmed.

Mourning (after a crew member death):
Low-affect, still, physically withdrawn. Individual crew members may stand at the rail where a comrade went overboard. There may be brief moments of crew members gathered together in small groups, quiet. No animation performance of grief — the absence of the usual crew activity is the mourning.

Fear responses (during monster encounters, severe weather, or hull breach):
Crew members in dangerous situations show fear through specific physical responses: a tendency to look at the source of threat rather than their assigned task, clutching at the nearest fixed object, shorter and more hesitant movement steps than normal. The crew that is afraid is less efficient — they move more slowly, their task animations have more hesitation — which is both honest and a gameplay signal.

Pride and ceremony (formal occasions, legendary achievements, port welcomes):
Formal crew animations for situations with ceremony: standing at attention, saluting (in region-appropriate forms), the specific formality of a crew who knows they are being watched and have something to be proud of.

Captain Character Reactions

The player character has emotional animation states that respond to events without interrupting gameplay:

Looking — the character naturally looks at things of interest in the environment: a creature on the horizon, an explosion in the distance, a beautiful sunset. These look reactions are procedurally triggered by environmental events and serve to direct the player's attention as well as humanize the character.

Effort — physical effort during sustained activities (fighting through a storm, extended combat) shows on the character's body: increased breathing animation, looser posture, the physical signs of sustained exertion.

Response to environment — entering cold water, being drenched by a wave, emerging from an underwater sequence — these environmental events produce brief, honest physical responses: shivering for cold, sputtering for water, the specific relief of breaking the surface after a long dive.

Animation Quality Standards

The Test for Every Animation

Before any animation is approved, it must pass three tests:

The physical truth test: Does this motion follow the kinematic logic of a real body doing this thing? Would a person who has studied the relevant physical activity (combat, sailing, swimming) look at this and nod?
The communication test: Does this animation communicate its purpose clearly to a player at combat distance, without UI assistance? Can you tell what defense type was used? Can you tell whether the attack hit or missed? Can you tell the creature's intention?
The personality test: Does this animation tell you something about who is doing it? Can you distinguish a high-skill character's attack from a low-skill character's attack? Can you distinguish one crew member's personality from another's in their idle animations?

Animations that fail any of these tests return to the animator for revision.

The Anti-Float Standard

"Floaty" is the most important quality to eliminate from Salt & Steel's animation. It is defined as:

Movements that do not originate in the feet and hips
Attacks that have shorter recovery time than buildup time
Hits that do not move the target
Movements that do not respond to gravity
Transitions that occur too quickly to feel physical

Any animation flagged as floaty is reverted and rebuilt from the physical truth of what the motion should be.

See also:
Art Direction — the visual design language that animations must express
VFX System — the effects system that synchronizes with animation events
Sound Design — the audio that is triggered by animation events
Combat Systems — the mechanical context for combat animations
Naval Systems — the naval context for ship and crew animations