Player animation catalog

AVAILABLE FROM UPDATE 0.1.2

The original 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.

Since 0.1.4 BUILD127: 118 animations, including 91 new work, rest, daily and pose entries confirmed working in-game. See the tables below and Update 0.1.4.

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.

Original aliases (since 0.1.2)

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.

Additional animations since 0.1.4 BUILD127

91 new animations; 118 total. Confirmed working in-game by the project owner. The original 27 IDs and aliases are unchanged. Use the updated client and server. These additions are part of Update 0.1.4, not the public 0.1.3 catalog.

New playback follows the selected introduction, loop and exit rather than unrelated alternate montage sections. The introduction duration below is elapsed time; loop start is a native montage position, not a Lua argument. With looped=false, a new hold animation follows its introduction, one loop and exit. With looped=true it repeats the selected loop until stopped or superseded.

Work and training (35)

Alias	Activity	Recommended mode	Introduction	Native loop start
alchemy	Work at an alchemy lab	hold	3.667 s	3.667 s
annotategoods	Write notes while checking goods	hold	6.667 s	6.667 s
buildhouse	Hammer during construction	hold	4.167 s	4.167 s
checkbody	Examine a body	hold	3.800 s	3.800 s
checkgoods	Inspect goods, variant 1	hold	0.030 s	0.030 s
checkgoods2	Inspect goods, variant 2	hold	0.050 s	0.050 s
cleanfloor	Scrub a floor, variant 1	hold	4.933 s	4.933 s
cleanfloor2	Scrub a floor, variant 2	hold	5.133 s	5.133 s
cookpan	Cook at a pan	hold	2.033 s	2.033 s
cookspit	Cook at a spit	hold	0.033 s	0.033 s
cookcauldron	Stir a cauldron	hold	0.833 s	0.833 s
countore	Count ore	hold	7.033 s	7.033 s
cutwood	Chop wood / a tree	hold	2.900 s	2.900 s
cutlog	Chop a log at a station	hold	5.467 s	32.733 s
pickrice	Harvest rice	hold	2.867 s	2.867 s
pickaxe	Work with a pickaxe	hold	2.833 s	2.833 s
digground	Dig with a pickaxe	hold	2.833 s	2.833 s
repair	Hammer a ground-level repair	hold	4.167 s	4.167 s
cleanrice	Clean rice at a station	hold	4.267 s	4.267 s
seedrice	Sow rice	hold	4.500 s	4.500 s
smashherbs	Mash herbs at a station	hold	4.667 s	4.667 s
smithanvil	Work at an anvil	hold	2.733 s	2.733 s
smithsharpen	Sharpen at a smithing station	hold	2.200 s	2.200 s
smithwater	Cool metal at a smithing water station	once	6.433 s	—
tanning	Work at a tanning station	hold	5.167 s	5.167 s
sweep	Sweep with a broom	hold	5.700 s	5.700 s
carve	Carve while sitting	hold	4.433 s	4.433 s
sitcountore	Count ore while sitting	hold	5.533 s	5.533 s
swordsharpen	Sharpen a sword while sitting	hold	6.171 s	6.171 s
teach	Teach / demonstrate training	hold	4.500 s	4.500 s
trainmagic	Practice magic gestures	hold	7.100 s	7.100 s
trainbow	Practice bow handling	hold	8.833 s	8.833 s
train	Practice one-handed sword movements	hold	1.667 s	1.667 s
train2h	Practice two-handed sword movements	hold	8.467 s	8.467 s
train1h	Practice one-handed melee movements	hold	5.067 s	5.067 s

Sitting, lying and sleep (19)

Alias	Activity	Recommended mode	Introduction	Native loop start
sit	Sit on a stool / chair	hold	1.367 s	5.300 s
sitthrone	Sit on a throne	hold	7.667 s	7.667 s
sitlisten	Listen while sitting, variant 1	hold	5.167 s	5.167 s
sitlisten2	Listen while sitting, variant 2	hold	7.000 s	7.000 s
sitsleep	Doze while sitting	hold	10.933 s	10.933 s
sleeptable	Sleep at a table	hold	9.233 s	9.233 s
sitbedlowleft	Sit on a low bed, left entry	hold	5.200 s	5.200 s
sitbedlowright	Sit on a low bed, right entry	hold	5.200 s	5.200 s
sitbedhighleft	Sit on a high bed, left entry	hold	5.200 s	5.200 s
sitbedhighright	Sit on a high bed, right entry	hold	5.200 s	5.200 s
sleepbedlowleft	Sleep on a low bed, left entry	hold	15.867 s	15.867 s
sleepbedlowright	Sleep on a low bed, right entry	hold	12.867 s	12.867 s
sleepbedhighleft	Sleep on a high bed, left entry	hold	15.867 s	15.867 s
sleepbedhighright	Sleep on a high bed, right entry	hold	12.867 s	12.867 s
lieground	Lie down / sleep on the ground	hold	10.100 s	34.133 s
sitground2	Sit on the ground, alternate route	hold	7.133 s	7.133 s
sleepstand2	Doze while standing, variant 2	hold	5.300 s	5.300 s
sleepstand3	Doze while standing, variant 3	hold	4.417 s	4.417 s
leanwall2	Lean against a wall, alternate variant	hold	4.000 s	4.000 s

Daily activities (19)

Alias	Activity	Recommended mode	Introduction	Native loop start
readbook	Read a book while standing	hold	3.833 s	3.833 s
sitreadbook	Read a book while sitting	hold	3.600 s	3.600 s
readlectern	Read at a lectern	hold	3.167 s	3.167 s
readscroll	Read a scroll	hold	2.167 s	2.167 s
readpaper	Read a sheet of paper	hold	2.167 s	2.167 s
drink	Drink while standing	hold	4.267 s	4.267 s
sitdrink	Drink while sitting	hold	3.667 s	3.667 s
grounddrink	Drink while sitting on the ground	hold	4.800 s	4.800 s
eatbowl	Eat from a bowl while standing	hold	3.433 s	3.433 s
eatmeat	Eat meat while standing	hold	7.667 s	7.667 s
siteatbowl	Eat from a bowl while sitting	hold	4.500 s	4.500 s
siteatmeat	Eat meat while sitting	hold	5.500 s	5.500 s
groundeat	Eat while sitting on the ground	hold	5.500 s	5.500 s
sitsmoke	Smoke while sitting	hold	4.500 s	4.500 s
playlute	Play a lute while standing	hold	4.100 s	4.100 s
sitplaylute	Play a lute while sitting	hold	6.767 s	6.767 s
wash	Wash oneself	hold	4.067 s	4.067 s
washtrough	Wash at a trough, variant 1	once	13.667 s	—
washtrough2	Wash at a trough, variant 2	once	9.333 s	—

Poses and gestures (18)

Alias	Activity	Recommended mode	Introduction	Native loop start
handsonhips	Stand with hands on hips	hold	3.364 s	3.364 s
crossarmsthorus	Thorus-style crossed arms	hold	3.467 s	3.467 s
pray2	Pray, alternate variant	hold	5.333 s	5.333 s
meditate2	Meditate, alternate variant	hold	10.667 s	10.667 s
listen2	Listen, alternate variant	hold	2.833 s	2.833 s
exhausted2	Show exhaustion, alternate variant	hold	6.967 s	6.967 s
rain1	React to rain, variant 1	hold	1.167 s	1.167 s
rain2	React to rain, variant 2	hold	1.333 s	1.333 s
inspectfront	Inspect something ahead	once	10.000 s	—
inspectdown	Inspect something below	once	10.633 s	—
danceclap	Dance and clap	hold	2.533 s	2.533 s
sitdance	Dance while sitting	hold	1.267 s	1.267 s
airguitar2	Concert air guitar, alternate variant	hold	0.033 s	0.033 s
airkick	Concert air kick	hold	0.033 s	0.033 s
headbang2	Intense headbanging	hold	0.033 s	0.033 s
hairwhip	Concert hair whip	hold	0.033 s	0.033 s
raisefist	Raise a fist at a concert	hold	0.033 s	0.033 s
raisehands	Rapidly raise hands at a concert	hold	0.033 s	0.033 s

Practical notes

• Query getPlayerAnimationNames and getPlayerAnimationInfo to build a Lua menu from the running server's catalog. Pass info.looped explicitly when using the recommended mode.
• New props are cosmetic, separately owned components. Stopping or replacing their animation cleans up those components, not the player's inventory/equipment or unrelated world props.
• These are visual activities: no crafting rewards, food consumption, skill changes or scripted story actions. Native voice lines, particles and crafting effects are not replayed by the new visual-only presentation.
• Chairs, beds, anvils, troughs and other stations are not spawned or aligned automatically. Position the character at a suitable object; some station-owned rigs or scenery are separate from the character animation.
• First use may load animation/model assets. Existing request validation, bounded retries and failure diagnostics remain enabled.

Catalog-driven example

local info = getPlayerAnimationInfo("smithanvil")
if info then
    startAnim(playerId, info.name, info.looped, 0.15)
end
-- End the activity when appropriate:
-- stopAnim(playerId)

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
• getPlayerAnimationNames (since 0.1.4)
• getPlayerAnimationInfo (since 0.1.4)