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

# Configuración

> Todo lo que puedes cambiar en config/config.lua, explicado con palabras sencillas.

Todas las opciones están en un solo archivo: `rco-vehicles/config/config.lua`. Ábrelo con cualquier editor de texto (el Bloc de notas sirve, VS Code es más cómodo).

<Tip>
  Cambia solo lo que va después del signo `=`. Deja las comillas `'...'`, las comas y las llaves tal como están. Después de guardar, reinicia el servidor.
</Tip>

<Note>
  Los comentarios dentro del archivo están en inglés. Esta página explica cada opción en español.
</Note>

## Lo básico

| Opción | Qué hace | Por defecto |
| - | - | - |
| `Config.Locale` | Idioma de los menús: `'en'` o `'pt-br'` | `'en'` |
| `Config.StoreName` | El nombre de tu tienda, arriba de cada menú | `'Rust & Co.'` |
| `Config.Framework` | Déjalo en `'auto'`. Solo escribe `'rsg'` o `'vorp'` si el script se equivoca | `'auto'` |
| `Config.Debug` | Modo de ayuda para configurar (mira "Colocar concesionarios y garajes" más abajo). Apágalo antes de abrir a los jugadores | `false` |

### Otro idioma

Copia `locales/en.json`, traduce los textos del lado derecho de cada línea, guárdalo por ejemplo como `locales/es.json` y pon `Config.Locale = 'es'`. Lo que no traduzcas aparece en inglés.

## Dinero y límites

| Opción | Qué hace | Por defecto |
| - | - | - |
| `Config.MoneyAccount` | Qué dinero paga los vehículos. RSG: `'cash'`, `'bank'`, `'gold'` u otro tipo de dinero de tu servidor. VORP: `'cash'` o `'gold'` | `'cash'` |
| `Config.MaxVehicles` | Cuántos vehículos puede tener un personaje | `10` |
| `Config.MovePrice` | Precio por traer un vehículo desde el garaje de otro pueblo. `0` = gratis | `1` |

## Precios

Cada vehículo RCO ya trae su precio. Solo tocas esta lista para **cambiar** un precio:

```lua theme={"dark"}
Config.Prices = {
    wanderer = 25,    -- nombre del vehículo = precio nuevo
}
```

El nombre del vehículo es el nombre del modelo (la bicicleta Wanderer es `wanderer`). Un vehículo que no está en la lista mantiene su precio.

## Teclas y distancias

| Opción | Qué hace | Por defecto |
| - | - | - |
| `Config.OpenKey` | Tecla para abrir un concesionario o garaje, a pie | **J** |
| `Config.StoreKey` | Tecla para guardar el vehículo en el que vas montado, en un garaje | **R** |
| `Config.InteractDistance` | A cuántos metros del punto del concesionario o garaje tiene que estar el jugador | `2.0` |
| `Config.StoreDistance` | A cuántos metros del punto del garaje tiene que estar el vehículo para guardarlo | `15.0` |
| `Config.TransferDistance` | A cuántos metros tiene que estar el otro jugador para recibir un vehículo | `5.0` |

<Note>
  Las teclas se escriben con el código de control del juego (como `0xF3830D8E`), no con la letra. Cámbialas solo si conoces el código de la tecla que quieres. La tecla de guardar tiene que ser una que el juego lea con el jugador montado: la J, por ejemplo, no funciona en un vehículo.
</Note>

## Garajes

Cada garaje es un bloque así:

```lua theme={"dark"}
valentine = {
    label = 'Valentine',
    coords = vector3(-179.53, 648.90, 113.58),
    spawn = vector4(-179.87, 653.14, 113.65, 136.06),
    blip = true,
},
```

| Línea | Qué significa |
| - | - |
| `valentine` | El nombre corto del garaje. En minúsculas, sin espacios |
| `label` | El nombre que ve el jugador |
| `coords` | Dónde se pone el jugador para abrir el garaje |
| `spawn` | Dónde aparece el vehículo al sacarlo. El último número es hacia dónde mira |
| `blip` | `true` lo muestra en el mapa, `false` lo oculta |

Elige un `spawn` con unos 6 metros libres alrededor y nada bajo encima: el menú del garaje muestra ahí el vehículo con la cámara girando a su alrededor.

<Warning>
  Cada vehículo recuerda el **nombre corto** de su garaje. Si cambias `valentine` por otro nombre, los vehículos guardados ahí desaparecen de él. Para añadir un garaje, añade un bloque nuevo con un nombre corto nuevo.
</Warning>

Vienen siete garajes: Saint Denis, Rhodes, Valentine, Annesburg, Blackwater, Strawberry y Armadillo.

## Concesionarios

Funcionan como los garajes, con algunas líneas más:

| Línea | Qué significa |
| - | - |
| `label` | El nombre que ve el jugador |
| `coords` | Dónde se pone el jugador para abrir el concesionario |
| `range` | A cuántos metros de `coords` se abre. Quita la línea para usar `Config.InteractDistance` |
| `preview` | Dónde está el vehículo en exposición mientras el jugador elige |
| `npc` | El dependiente (un modelo de personaje del juego). Quita la línea para no tener dependiente |
| `chair` | Opcional: la silla donde se sienta el dependiente. Sin ella, busca un asiento cerca |
| `garage` | El garaje (nombre corto) que guarda los vehículos comprados ahí |
| `delivery` | Dónde se entrega el vehículo nuevo justo después de la compra. Quita la línea para entregarlo en el garaje |
| `categories` | Qué tipos de vehículo se venden ahí, por ejemplo `{ 'bicycle' }`. `nil` vende todo |
| `blip` | `true` lo muestra en el mapa |
| `lift` | Solo para la tienda de Saint Denis que viene con el resource: el vehículo en exposición sube en una plataforma. No lo copies a otros concesionarios |

El script ajusta las alturas al suelo, así que una `z` con un metro de error no pasa nada. La excepción es el concesionario de Saint Denis: su `preview` tiene que ser exacto, porque es la parte de arriba de la plataforma.

## Colocar concesionarios y garajes

La forma fácil de sacar los números de un punto nuevo:

<Steps>
  <Step title="Enciende el modo de ayuda">
    Pon `Config.Debug = true` y reinicia el servidor.
  </Step>

  <Step title="Ponte en el punto">
    En el juego, ve a donde debe ir el garaje (o el vehículo), mirando hacia donde quieras.
  </Step>

  <Step title="Copia tu posición">
    Escribe `/vehicles_here` en el chat, abre la consola F8 y copia la línea que aparece en la configuración.
  </Step>

  <Step title="Apaga el modo de ayuda">
    Vuelve a poner `Config.Debug = false` antes de abrir el servidor a los jugadores.
  </Step>
</Steps>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.