Skip to main content

The "vngen_char_modify_pos" Function

Syntax#

vngen_char_modify_pos(name, x, y, z, scale, rot, duration, [ease]);
ArgumentTypeDescription
namestringThe ID of the character to modify (or keyword all for all characters)
xrealThe horizontal position to display the character, relative to the global offset
yrealThe vertical position to display the character, relative to the global offset
zrealThe drawing depth of the character, relative to other characters only
scalerealThe character scale multiplier, where 1 is default
rotrealThe character rotation, in degrees
durationrealSets the length of the modification transition, in seconds
[ease]integer/macroOptional: Sets the ease mode to perform the transition in
note

The scale multiplier here should not be confused with the scaling mode available in *_create_ext functions. The scale mode sets the entity's default scale, while the scale multiplier modifies the default scale.

Description#

Applies a new position, rotation, and scale to the input entity ID.

All modifications made with this script are permanent and will persist until another modification is performed. This script cannot be performed simultaneously with other modification actions operating on the same entity ID.

See Macros & Keywords for a list of available ease modes.

Example#

vngen_event() {
vngen_char_modify_pos("John Doe", 150, 150, -1, 1.5, 45, 2);
}