This section explains the AGMaker-exclusive node ChangeAngleSettings.
Overview
ChangeAngleSettings (Mouse/Stick Angle Tracking Settings) allows an object to automatically rotate based on:
- The angle of a game controller’s stick, or
- The angle between the game object and the mouse position.
This is especially useful for genres like stick shooters or mouse-based shooters.
Configuration Options
- Use Left/Right Stick Input: Select which stick (left or right) to use for directional input.
- Use Mouse Position: Enable this to rotate based on the mouse’s position.
- Target Node: The specified node will rotate automatically.
- Is Add Node Rotation: If ON, the calculated angle will be added to the node’s current rotation.
- Base Angle: Offset angle for adjustment. Right = 0°, Up = 270°, etc.
- Upward/Downward Rotation Limit: Set the rotation limits for up/down directions. Setting both to 180° enables full 360° rotation.
Important Notes
Rotation won’t work correctly with flipping enabled
If Auto Y Flip Animation is enabled, flipping will disrupt the angle calculation.
This happens because flipping the entire game object affects the stick/mouse coordinate system, causing rotation to misbehave.
Do not rotate nodes already controlled by AnimationPlayer
If the node’s Rotation property is keyframed in AnimationPlayer, it will overwrite the angle control from ChangeAngleSettings, resulting in conflicts.
This is especially important when using bone-based animations.
For example, in the sample player, rotating the B_Joint_L bone works properly with this system.