> For the complete documentation index, see [llms.txt](https://zloma-scripts.gitbook.io/zloma-scripts/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://zloma-scripts.gitbook.io/zloma-scripts/zloma_antibump-free/vehicle-setup.md).

# Vehicle Setup Guide

zloma\_antibump depends on the vehicle having a valid `handling.meta` structure.

If the car's `handling.meta` template is wrong, or the `SubHandlingData` structure is broken, the advanced flag may not apply correctly at all.

If the car's `handling.meta` or `vehicles.meta` is poorly configured, the runtime flag alone will not fully fix curb boosting, bump boosting, or other speed inconsistencies caused by the road surface.

This resource is used when a vehicle is mostly tuned correctly but still gains too much speed from curbs, map seams, small road dips, or imperfect highway geometry.

***

## 1. Remove Bad Downforce Entries

If the vehicle uses `fDownForceModifier`, remove that line before testing antibump behavior.

Many unstable addon vehicles still include it even when the rest of the setup is not prepared for it.

***

## 2. Check `SubHandlingData`

The first `SubHandlingData` entry should be `CCarHandlingData`.

Example structure:

```xml
<SubHandlingData>
  <Item type="CCarHandlingData">
  </Item>
  <Item type="NULL" />
  <Item type="NULL" />
</SubHandlingData>
```

If the car uses rear pop-up impulse values, keep them inside that same `CCarHandlingData` item.

Example:

```xml
<SubHandlingData>
  <Item type="CCarHandlingData">
    <fBackEndPopUpCarImpulseMult value="0.000000" />
    <fBackEndPopUpBuildingImpulseMult value="0.000000" />
    <fBackEndPopUpMaxDeltaSpeed value="0.000000" />
  </Item>
  <Item type="NULL" />
  <Item type="NULL" />
</SubHandlingData>
```

***

## 3. Review `vehicles.meta` Flags

If you see `FLAG_DROP_SUSPENSION_WHEN_STOPPED`, remove it.

That flag can make a vehicle settle in a way that reintroduces unwanted bounce or odd suspension movement.

Example of what to remove:

```xml
<flags>FLAG_DROP_SUSPENSION_WHEN_STOPPED</flags>
```

***

## 4. Understand the Scope

zloma\_antibump applies one advanced handling flag during gameplay.

It does not:

* rebuild broken handling files
* normalize weight, suspension, center of mass, or traction values
* fix low-quality addon vehicles automatically

What it does do is reduce the chance that a vehicle gets free acceleration from curbs, bumps, braking compression, and uneven road surfaces.

If a vehicle still behaves badly after these checks, fix the vehicle files first and only then retest the resource.

The first thing to verify is not just the handling values themselves, but whether the `handling.meta` file is structured correctly so the advanced flag can actually be applied.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://zloma-scripts.gitbook.io/zloma-scripts/zloma_antibump-free/vehicle-setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.