Vehicle

Official compatibility

Element	Reference
TypeWriter	Required. Use the official TypeWriter release supported by the extension release.
Related extensions	Install the related extensions listed on this page before using entries that depend on them.

Vehicle Extension

The Vehicle extension provides a comprehensive set of actions, events, facts, manifests, and artifacts for managing vehicles in your server.

Entry Types

Type	Count	Description
Action	9	Trigger vehicle-related actions
Event	7	Listen for vehicle-related events
Fact	4	Query vehicle-related data
Manifest	3	Define vehicle configurations
Artifact	1	Vehicle data persistence

Actions

Actions are entries that perform operations when triggered.

• vehicle_attack - Trigger a vehicle attack action
• vehicle_ability - Activate a vehicle ability
• vehicle_charge - Charge attack with vehicle
• repair_vehicle - Repair the current vehicle
• refill_vehicle_fuel - Refill vehicle fuel
• add_vehicle_xp - Add XP to current vehicle
• set_vehicle_skin - Change vehicle skin
• open_vehicle_garage - Open vehicle garage menu
• spawn_vehicle - Spawn a vehicle

Events

Events are entries that fire when something happens.

• on_vehicle_attack - Fired when a vehicle attacks
• on_vehicle_charge_hit - Fired when a charge attack hits
• on_vehicle_destroyed - Fired when a vehicle is destroyed
• on_vehicle_stamina_deplete - Fired when vehicle stamina is depleted
• on_vehicle_collision - Fired when vehicle collides
• on_vehicle_fuel_empty - Fired when vehicle runs out of fuel
• on_vehicle_level_up - Fired when vehicle levels up

Facts

Facts are entries that provide queryable data.

• vehicle_stamina_fact - Current vehicle stamina
• vehicle_charge_meter_fact - Current vehicle charge meter
• vehicle_limit - Vehicle ownership limit
• vehicle_owned_count - Count of owned vehicles

Manifests

Manifests are entries that define configurations.

• vehicle_definition - Vehicle definition
• vehicle_garage_menu - Vehicle garage menu
• vehicle_config - Global vehicle configuration

Artifacts

Artifacts are entries that handle data persistence.

• vehicle_storage - Vehicle storage artifact

User guide

1. Create vehicle_config and the vehicle_definition entries required by your vehicles.
2. Add vehicle_storage when ownership and progression data must persist.
3. Trigger spawn_vehicle or open_vehicle_garage from a command, interaction, or another Typewriter entry.
4. Use actions such as vehicle_attack, vehicle_ability, vehicle_charge, repair_vehicle, and refill_vehicle_fuel to build the gameplay.
5. Connect on_vehicle_attack, on_vehicle_destroyed, on_vehicle_collision, on_vehicle_fuel_empty, and on_vehicle_level_up to your scenario reactions.
6. Add vehicle_stamina_fact, vehicle_charge_meter_fact, vehicle_limit, and vehicle_owned_count for conditions and display.

Test one vehicle, its garage, and its persistence first. Add events and ownership limits afterwards.

Troubleshooting

The extension is not visible

Check that the installed release matches the supported TypeWriter release and that the related extensions listed in the compatibility section are present.

An entry is missing

In the Typewriter Web panel, use the Search bar or the + button to find or create the entry with its exact identifier. Entry IDs and field names are case-sensitive; do not translate them.

The entry saves but nothing happens

Check that the entry is connected to the trigger, command, objective, event, or menu interaction required by its type. Test with optional permissions and criteria removed, then add them back one at a time.

An integration does not work

Verify the dependency and version shown in the extension card, then check the server log for the first error. Do not replace a missing dependency with a similarly named plugin unless the extension source explicitly supports it.