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

# Installation

Install yei-starterpack and its required database dependency.

Requisitos previos

* Servidor FiveM funcionando (QBox, QBCore, ESX o standalone).
* [`oxmysql`](https://github.com/overextended/oxmysql) instalado y funcionando.

{% hint style="info" %}
Opcional pero recomendado: `ox_lib` y `ox_target` para la mejor experiencia de notificaciones e interacción.
{% endhint %}

### Paso 1 — Descargar

Descarga el `.zip` del resource desde tu compra de Tebex/BuiltByBit o tu link de descarga entregado.

### Paso 2 — Ubicación correcta

Descomprime el contenido dentro de tu carpeta `resources`. La estructura final debe verse así:

```
resources/
└── [standalone]/
    └── yei-starterpack/
        ├── fxmanifest.lua
        ├── client/
        │   └── main.lua
        ├── server/
        │   └── main.lua
        ├── shared/
        │   ├── config.lua
        │   └── framework.lua
        └── web/
            ├── index.html
            ├── style.css
            └── app.js
```

{% hint style="warning" %}
Si ya tenías una versión anterior instalada, borra la carpeta vieja completa antes de copiar la nueva — evita mezclar archivos de versiones distintas.
{% endhint %}

### Paso 3 — Ensure en server.cfg

Agrega estas líneas en tu `server.cfg`. **oxmysql debe cargar antes** que `yei-starterpack`:

```cfg
ensure oxmysql
ensure yei-starterpack
```

### Paso 4 — Instalación de base de datos

No necesitas correr ningún `.sql` manualmente. El resource crea automáticamente la tabla `yei_starterpack_claims` la primera vez que arranca, siempre que `oxmysql` esté conectado correctamente a tu base de datos.

### Paso 5 — Permiso de administrador (opcional)

Si quieres poder usar el comando de reseteo (`/resetstarterpack`), agrega el ACE correspondiente en tu `server.cfg`:

```cfg
add_ace group.admin yei-starterpack.admin allow
```

Cambia `group.admin` por el grupo o principal que uses para tus staff/admins.

### Paso 6 — Configurar el script

Abre `shared/config.lua` y ajusta framework, NPC, vehículos, recompensas y colores a tu gusto. Ver Configuration para el detalle de cada opción.

### Paso 7 — Configurar inventario (si aplica)

Si usas `ox_inventory`, no necesitas hacer nada extra: el script lo detecta automáticamente. Si usas el inventario nativo de QB/ESX, los ítems se entregan por las funciones del framework detectado.

### Paso 8 — Reiniciar el servidor

Reinicia completamente el servidor (o al menos `oxmysql` y `yei-starterpack`) para que todos los cambios tomen efecto.

### Errores comunes

| Problema                                 | Causa típica                                                      | Solución                                                           |
| ---------------------------------------- | ----------------------------------------------------------------- | ------------------------------------------------------------------ |
| El NPC no aparece                        | El resource cargó antes de tiempo, o coords fuera del mundo       | Verifica las coords en `config.lua`, revisa la consola por errores |
| "La base de datos todavía no está lista" | `oxmysql` no estaba iniciado o no conectó                         | Confirma que `oxmysql` está antes en el `server.cfg`               |
| El menú no abre                          | `ox_target`/`qb-target` no detectan la entidad, o el NUI no cargó | Revisa la consola del cliente (F8)                                 |
| No entrega el vehículo a la garage       | `GiveVehicleInDatabase` en `false`, o framework no reconocido     | Revisa `Core.GiveVehicleInDatabase`                                |
| El comando de reset no funciona          | Falta el ACE `yei-starterpack.admin`                              | Agrega el `add_ace` correspondiente y reinicia                     |


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.yeistudios.com/scripts/car-wipe-1/installation.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.