Player animation catalog

AVAILABLE FROM UPDATE 0.1.2

The 27-entry player-animation catalog and the synchronized startAnim and stopAnim behavior are available from G1R:MP 0.1.2.

The player animation catalog lists the stable, server-validated aliases accepted by startAnim. Aliases are case-insensitive. Lua passes an alias from this table; raw Unreal asset paths are neither accepted nor exposed as API inputs.

Request modes

The authored mode documents the safe, recommended presentation for each animation. It does not change the compatible Lua signature:

• Omitting looped from startAnim always means false, including for entries whose authored mode is hold.
• With looped = false, the animation plays once from its beginning and ends naturally. Use this for every once entry.
• With looped = true, a hold entry plays its introduction, then repeats from the catalogued loop-start time until stopAnim or a newer scripted animation supersedes it. Higher-priority gameplay presentation temporarily takes precedence; the same active scripted revision may resume afterward.
• The optional blend duration controls the owning player's native montage transition when the request replaces an existing scripted animation, then remains the stop blend for the new animation. Remote proxy handoff is immediate and does not guarantee an interpolated blend.
• A loop-start value is native catalog metadata. It is not an additional Lua argument.

Available aliases

Key	Description	Authored mode	Loop start	Notes
crossarms	Stand with arms crossed.	hold	3.47 s
pray	Pray while standing.	hold	6.83 s
meditate	Perform a standing meditation pose.	hold	11.5 s
warmhands	Warm the hands in a cold or rainy standing pose.	hold	0.93 s	Uses the stable Rain Pose 04 replacement; the unsafe original Warm Hands montage is not exposed.
exhausted	Show an exhausted standing pose.	hold	9.47 s
dance	Perform a standing dance.	hold	1.97 s
smalltalk	Gesture while speaking to an audience.	hold	4.5 s	Uses the visible Speaks Audience replacement; the original non-rendering Small Talk montage is not exposed.
guard	Hold a watchful guard pose with crossed arms.	hold	3.47 s
sitground	Sit on the ground.	hold	5.03 s
sleepground	Lie down and sleep on the ground.	once	—
sleepstand	Doze while standing.	hold	4.17 s
leanwall	Lean against a wall.	hold	3 s
listen	Adopt a listening pose.	hold	2.57 s
waterpipe	Use a water pipe.	hold	8.67 s
smoke	Perform the standing smoking pose.	hold	1.47 s
campfire	Warm up in front of a campfire.	hold	4.73 s
puke	Perform the vomiting animation.	once	—
angrydrunk	Act like an angry drunk.	hold	3.67 s
airguitar	Perform the concert air-guitar pose.	hold	0.03 s
headbang	Perform the concert headbang pose.	hold	0.03 s
fistpump	Perform the concert fist-pump pose.	hold	0.03 s
pogo	Perform the concert pogo pose.	hold	0.03 s
stomp	Perform the concert stomp pose.	hold	0.03 s
sway	Perform the concert sway pose.	hold	0.03 s
work	Perform a smithing work animation.	hold	50.7667 s	Compatibility alias used by the bundled GothicRP activities; the authored montage presents visible smithing and its prop.
mine	Perform the pickaxe mining animation.	hold	1.97333 s	Compatibility alias used by the bundled GothicRP mining activities.
pickup	Pick up an item from the ground with the left hand.	once	—	Compatibility alias used by the bundled GothicRP gathering activities; authored as a one-shot.

Usage

-- Hold a prayer pose using its catalogued loop point.
startAnim(playerId, "pray", true, 0.2)

-- Play a one-shot animation from the beginning.
startAnim(playerId, "puke", false, 0.15)

-- Stop only the tracked scripted animation.
stopAnim(playerId)

Return-value contract

For both startAnim and stopAnim, true means the server accepted the request, updated or retransmitted authoritative state, and attempted reliable delivery. It is not a synchronous client-playback or transport acknowledgement. Requests rejected during server validation return false. Client loading and presentation retries are bounded; terminal misses are written to the animation diagnostic log instead of retrying forever.

Related functions

• startAnim
• stopAnim