> ## Documentation Index
> Fetch the complete documentation index at: https://coolcars.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# PlaceholderAPI

> Integration with PlaceholderAPI to display car data in other plugins.

CoolCars provides a wide range of placeholders that can be used in tab lists, scoreboards, holograms, or chat.

**Plugin Identifier:** `coolcars`

**Format:** `%coolcars_<placeholder>%`

## Global Placeholders

These placeholders work regardless of whether the player is in a car.

| Placeholder               | Description                                         |
| :------------------------ | :-------------------------------------------------- |
| `%coolcars_active_count%` | Total number of active cars on the server.          |
| `%coolcars_has_car%`      | Returns `true` if the player owns at least one car. |

***

## Current Car Placeholders

These placeholders work when the player is inside a car or is its owner.

### Model Information

* `%coolcars_car_uuid%` — Unique ID of the car.
* `%coolcars_car_model_key%` — Technical model ID (e.g., `volga`).
* `%coolcars_car_model_name%` — Localized model name.
* `%coolcars_owner_name%` — Name of the car owner.
* `%coolcars_driver_name%` — Name of the current driver.

### Status and Movement

* `%coolcars_speed_kmh%` — Current speed in km/h.
* `%coolcars_speed_mps%` — Current speed in m/s.
* `%coolcars_engine%` — Engine status (On/Off).
* `%coolcars_lights%` — Lights status (On/Off).
* `%coolcars_passengers%` — Current number of passengers.
* `%coolcars_passengers_max%` — Maximum number of seats.

### Fuel and Health

* `%coolcars_fuel%` — Current liters of fuel.
* `%coolcars_fuel_max%` — Fuel tank capacity.
* `%coolcars_fuel_percent%` — Fuel tank percentage.
* `%coolcars_health%` — Current car HP.
* `%coolcars_health_max%` — Maximum HP.
* `%coolcars_health_percent%` — Durability percentage.

***

## Advanced Damage

If the per-part damage system is enabled, you can display the status of each zone.

| Placeholder                   | Description                      |
| :---------------------------- | :------------------------------- |
| `%coolcars_front_percent%`    | Front part condition (%).        |
| `%coolcars_rear_percent%`     | Rear part condition (%).         |
| `%coolcars_wheel_fl_percent%` | Front-left wheel condition (%).  |
| `%coolcars_wheel_fr_percent%` | Front-right wheel condition (%). |
| `%coolcars_wheel_rl_percent%` | Rear-left wheel condition (%).   |
| `%coolcars_wheel_rr_percent%` | Rear-right wheel condition (%).  |

***

## Coordinates and Position

* `%coolcars_world%` — Name of the world where the car is located.
* `%coolcars_x%`, `%coolcars_y%`, `%coolcars_z%` — Car coordinates.
* `%coolcars_yaw%` — Car direction (rotation angle).