Skip to main content

The "vngen_attach_modify_pos" Function

Syntax#

vngen_attach_modify_pos(name, id, x, y, z, scale, rot, duration, [ease]);
ArgumentTypeDescription
namestringThe ID of the attachment parent character
idreal/stringThe ID of the attachment to modify (or keyword all for all attachments)
xrealThe horizontal position to display the attachment, relative to the parent character
yrealThe vertical position to display the attachment, relative to the parent character
zrealThe drawing depth of the attachment, relative to other attachments only
scalerealThe attachment scale multiplier, where 1 is default
rotrealThe attachment 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_attach_modify_pos("John Doe", "attach", 150, 150, -1, 1.5, 45, 2);
}