Booster

Simple trigger-based booster that applies an upward impulse to vehicles entering a trigger zone.

Overview

util_booster provides a single trigger callback that, when a vehicle enters a trigger zone, queues a Lua command on the vehicle to activate a boost via the vehicle-side core_booster extension.

Extension path: lua/ge/extensions/util/booster.lua

Exports (M)

Internals

Trigger Callback

When trigger(data) is called with event type 'enter':

1. Resolves the vehicle via getObjectByID(data.subjectID).
2. Queues a Lua command on the vehicle: extensions.core_booster.boost(vec3(0,0,1), 0.01).

The boost direction is straight up (0,0,1) with a duration of 0.01 seconds.

Note: The code references a global event variable rather than data.event, which may be a legacy pattern.

How It Works

1. Place a trigger zone in the level editor.
2. Assign util_booster as the trigger handler.
3. When a vehicle enters the zone, trigger() fires and sends a boost command to the vehicle's Lua VM.

Lua Examples

-- Manually trigger a boost on vehicle entering a zone
extensions.util_booster.trigger({subjectID = vehicleId})

-- The vehicle-side command that gets queued:
-- extensions.core_booster.boost(vec3(0,0,1), 0.01)

Additional Exports

• M.trigger - (undocumented)