Donut Team is a labor of love, built and maintained by a small group of passionate developers. We invest our own time and resources to offer our tools, mods, and web services completely free of charge.

We don't run ads, and we will never sell your data - period.

If you've enjoyed anything we've created, please consider supporting our work with a one-time or monthly donation via our Ko-fi page . Every contribution helps us continue building great experiences for the community.

Dismiss
  • Modding Tools
  • Lucas' Simpsons Hit & Run Mod Launcher
  • Hacks
  • Mod Requirable Hacks
  • Additional Script Functionality
  • Console Commands
  • MFK Commands
  • Mission Initialisation
  • Stages
  • Stage Vehicles

SetStageVehicleCharacterAnimation

Available since Version 1.19.

Set the animation that a vehicle character will use.

Scope

This command should be called between calls to AddStage and CloseStage in a mission's initialisation script.

Additionally, this should only be called on characters previously added to the car with AddStageVehicleCharacter.

Syntax

MFK
Lua
SetStageVehicleCharacterAnimation( car, character, animation, [bobbing] );
Game.SetStageVehicleCharacterAnimation( car, character, animation, [bobbing] )
  • car: The name of the car the character is on.
    • current: The player's current car.
  • character: The name of character in the car.
  • animation: The animation to make the character use.
    • The default animation is "in_car_idle".
  • bobbing: Whether or not to make the character bob up and down.
    • Defaults to false (if this function is called).
    • This will also make the character lean side-to-side when appropriate if the Steering Animations fix in the Bug Fixes hack is enabled.

Examples

MFK
Lua
AddStage();
	AddStageVehicle("cVan", "m1_cVan", "NULL", "cVan.con");
	
	// Bart uses the smoke location in this example.
	AddStageVehicleCharacter("cVan", "bart", "sl", 0);

	// Make Bart surf on the hood(ish)
	// Note that "surf_cycle" is not in the NPD animation set by default.
	SetStageVehicleCharacterAnimation("cVan", "bart", "surf_cycle");

	AddObjective("dummy");
	CloseObjective();
CloseStage();
Game.AddStage() 
	Game.AddStageVehicle("cVan", "m1_cVan", "NULL")
	
	-- Bart uses the smoke location in this example.
	Game.AddStageVehicleCharacter("cVan", "bart", "sl", 0)

	-- Make Bart surf on the hood(ish)
	-- Note that "surf_cycle" is not in the NPD animation set by default.
	Game.SetStageVehicleCharacterAnimation("cVan", "bart", "surf_cycle")

	Game.AddObjective("dummy")
	Game.CloseObjective()
Game.CloseStage()