Gravity Force

Overview

• Node Name: Gravity Force
• Category: repeat_p_duration
• File: extensions/flowgraph/nodes/vehicle/gForce.lua

Gets the g-force (gravity force) values of a vehicle, split into lateral (X), longitudinal (Y), and vertical (Z) components, plus total magnitude.

Pin Schema

Input Pins

Output Pins

Internals

Key Methods

Cached Values

The node reads these from core_vehicleBridge.getCachedVehicleData:

How It Works

1. Each frame, work() fetches the vehicle's smoothed acceleration values from the vehicle bridge cache.
2. If a value isn't cached yet, it calls core_vehicleBridge.registerValueChangeNotification(veh, key) to start tracking it.
3. The current gravity is fetched via core_environment.getGravity() (clamped to min 0.01 to avoid division by zero).
4. G-force components are computed:
   • gx = accXSmooth / gravity (lateral)
   • gy = accYSmooth / gravity (longitudinal)
   • gz = (accZSmooth - gravity) / gravity (vertical, compensated for resting gravity)
5. Total g-force: sqrt(gx² + gy² + gz²), and gForceZ0 ignores the Z component.

Usage Example

-- In a flowgraph:
-- [Gravity Force] → gForce → [Compare > 2.0] → [Trigger Blackout Effect]
--                 → gx     → [Display Lateral G]

-- Programmatic equivalent:
local accX = core_vehicleBridge.getCachedVehicleData(vehId, 'accXSmooth') or 0
local gravity = math.abs(core_environment.getGravity())
local gx = accX / gravity

Key Dependencies

• core_vehicleBridge.getCachedVehicleData() - reads cached vehicle telemetry
• core_vehicleBridge.registerValueChangeNotification() - subscribes to vehicle data updates
• core_environment.getGravity() - returns current world gravity value

See Also

• Align for Coupling (Flowgraph Node) - Related reference
• Apply Velocity to Vehicle (Flowgraph Node) - Related reference
• Boost Vehicle (Flowgraph Node) - Related reference
• FlowGraph Guide - Guide