> For the complete documentation index, see [llms.txt](https://docs.cuxial.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cuxial.com/scripts/es/vehiculos/cuxial-fuel.md).

# Cuxial Fuel

Sistema de combustible para FiveM con surtidores, tipos de combustible, cargadores eléctricos, bidones y una pantalla interactiva en el propio surtidor.

Cuxial Fuel da a cada vehículo un nivel de combustible, un depósito y un tipo de combustible, y convierte los surtidores del mapa en surtidores que funcionan. La compra se hace en una pantalla dibujada sobre el propio surtidor, y el combustible se sirve con una boquilla que el jugador lleva hasta el vehículo.

## Qué hace

* **Consumo de combustible** según las RPM del motor, la clase del vehículo y el tipo de combustible, con un depósito por clase o por modelo.
* **Cuatro combustibles**: regular, plus, premium y diésel. Cambiar de combustible vacía antes el depósito, y el combustible equivocado avería el motor.
* **Vehículos eléctricos** con sus propios cargadores, en modo rápido y normal.
* **Pantalla interactiva en el surtidor**: precios en reposo, y toda la compra (combustible, litros, pago) con el cursor del juego cuando un jugador lo usa. Los modelos sin pantalla abren un panel normal.
* **Boquilla con manguera**: pagas, coges la boquilla, la enchufas al depósito, paras cuando quieras y la devuelves al surtidor. Los litros no usados se reembolsan.
* **Derrames**: arranca el motor con la boquilla puesta y muévete, y la boquilla salta.
* **Bidones** que se venden en el surtidor y se usan desde el inventario.
* **Tótems de precios** en las gasolineras, con precios, stock y promociones.
* **Descuentos por trabajo** para jugadores de servicio.
* **Gráfica de consumo** para el conductor, con combustible, velocidad y litros por segundo.
* **Sonidos nativos** de la boquilla, el chorro y la caja, que también oyen los jugadores cercanos.
* **Surtidores y cargadores extra** colocados por coordenadas (azoteas, helipuertos, muelles, aeródromos).
* **Exports de combustible** en cliente y servidor, además del state bag `fuel` del vehículo.

## Cómo es un repostaje

1. El jugador se acerca a un surtidor y elige **Repostar** (o **Cargar** en un cargador).
2. La cámara encuadra la pantalla del surtidor. El jugador elige el combustible y los litros y paga con una de las cuentas permitidas.
3. La boquilla pasa a la mano del jugador. En el tapón del vehículo, **Repostar** abre el chorro y **Parar de repostar** lo pausa.
4. De vuelta en el surtidor, **Devolver la manguera** cierra la compra y reembolsa lo pagado y no servido.

Alejarse más de lo que da la manguera, o sentarse en un vehículo con la boquilla en la mano, también cierra la compra con su reembolso.

## Requisitos

| Recurso              | Obligatorio | Para qué se usa                                                                          |
| -------------------- | ----------- | ---------------------------------------------------------------------------------------- |
| OneSync              | Sí          | Estado de los vehículos y comprobaciones en el servidor                                  |
| `ox_lib`             | Sí          | Callbacks, notificaciones, idiomas                                                       |
| `oxmysql`            | Sí          | Tipo de combustible de cada vehículo                                                     |
| `cuxial_bridge`      | Sí          | Conecta con tu framework (QBox, QBCore o ESX): dinero, trabajos, inventario              |
| `sleepless_interact` | Sí          | Interacciones en surtidores, cargadores y el tapón                                       |
| `ox_inventory`       | Sí          | Bidón                                                                                    |
| `cuxial_gas_assets`  | Sí          | Modelos, pantallas, tótems y sonidos. Se entrega con el script                           |
| `cuxial_gasstations` | No          | Gasolineras de jugadores: precios, stock, caja, promociones y charcos de derrame propios |

{% hint style="warning" %}
Cuxial Fuel tiene que ser el único recurso de combustible del servidor. Para cualquier otro script de combustible antes de arrancarlo.
{% endhint %}

## Páginas

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Instalación</strong></td><td>Dependencias, otros scripts de combustible, convars y orden de arranque.</td><td><a href="/scripts/es/vehiculos/cuxial-fuel/installation.md">Instalación</a></td></tr><tr><td><strong>Configuración</strong></td><td>Cada bloque de <code>shared/config.lua</code> y las listas de <code>data/</code>.</td><td><a href="/scripts/es/vehiculos/cuxial-fuel/configuration.md">Configuración</a></td></tr><tr><td><strong>Comandos y permisos</strong></td><td>Comandos de jugador, teclas y el posicionador de pantalla.</td><td><a href="/scripts/es/vehiculos/cuxial-fuel/commands.md">Comandos y permisos</a></td></tr><tr><td><strong>Exports y eventos</strong></td><td>Lee y fija el combustible desde tus propios recursos.</td><td><a href="/scripts/es/vehiculos/cuxial-fuel/developers.md">Exports y eventos</a></td></tr><tr><td><strong>Problemas frecuentes</strong></td><td>Fallos habituales y cómo resolverlos.</td><td><a href="/scripts/es/vehiculos/cuxial-fuel/troubleshooting.md">Problemas frecuentes</a></td></tr></tbody></table>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.cuxial.com/scripts/es/vehiculos/cuxial-fuel.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
