> ## 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.

# Configuração

> Tudo o que dá para mudar no config/config.lua, explicado sem complicação.

Todas as opções ficam num arquivo só: `rco-vehicles/config/config.lua`. Abra com qualquer editor de texto (o Bloco de Notas serve, o VS Code é mais confortável).

<Tip>
  Mude só o que vem depois do sinal de `=`. Mantenha as aspas `'...'`, as vírgulas e as chaves do jeito que estão. Depois de salvar, reinicie o servidor.
</Tip>

<Note>
  Os comentários dentro do arquivo estão em inglês, porque o resource é vendido no mundo todo. Esta página explica cada opção em português.
</Note>

## O básico

| Opção | O que faz | Padrão |
| - | - | - |
| `Config.Locale` | Idioma dos menus: `'en'` ou `'pt-br'` | `'en'` |
| `Config.StoreName` | Nome da sua loja, aparece no topo de todo menu | `'Rust & Co.'` |
| `Config.Framework` | Deixe `'auto'`. Só escreva `'rsg'` ou `'vorp'` se o script errar | `'auto'` |
| `Config.Debug` | Modo de ajuda para configurar (veja [Posicionando concessionárias e garagens](#posicionando-concessionárias-e-garagens)). Desligue antes de abrir para os jogadores | `false` |

### Outro idioma

Copie o `locales/en.json`, traduza os textos do lado direito de cada linha, salve como, por exemplo, `locales/es.json` e coloque `Config.Locale = 'es'`. O que você não traduzir aparece em inglês.

## Dinheiro e limites

| Opção | O que faz | Padrão |
| - | - | - |
| `Config.MoneyAccount` | Qual dinheiro paga os veículos. RSG: `'cash'`, `'bank'`, `'gold'` ou outro tipo de dinheiro do seu servidor. VORP: `'cash'` ou `'gold'` | `'cash'` |
| `Config.MaxVehicles` | Quantos veículos um personagem pode ter | `10` |
| `Config.MovePrice` | Preço para trazer um veículo da garagem de outra cidade. `0` = de graça | `1` |

## Preços

Todo veículo RCO já tem o próprio preço. Você só mexe nesta lista para **mudar** um preço:

```lua theme={"dark"}
Config.Prices = {
    wanderer = 25,    -- nome do veículo = preço novo
}
```

O nome do veículo é o nome do modelo (a bicicleta Wanderer é `wanderer`). Veículo que não está na lista fica com o preço dele.

## Teclas e distâncias

| Opção | O que faz | Padrão |
| - | - | - |
| `Config.OpenKey` | Tecla para abrir concessionária ou garagem, a pé | **J** |
| `Config.StoreKey` | Tecla para guardar o veículo em que você está montado, na garagem | **R** |
| `Config.InteractKey` | Tecla para escolher uma opção na bomba de combustível e no seu veículo com a mangueira na mão (a rodinha do mouse ou as setas escolhem) | **G** |
| `Config.InteractDistance` | Quão perto (metros) o jogador precisa estar do ponto da concessionária ou garagem | `2.0` |
| `Config.StoreDistance` | Quão perto (metros) o veículo precisa estar do ponto da garagem para guardar | `15.0` |
| `Config.TransferDistance` | Quão perto (metros) o outro jogador precisa estar para receber um veículo | `5.0` |

<Note>
  As teclas são escritas com o código de controle do jogo (como `0xF3830D8E`), não com a letra. Só troque se souber o código da tecla que quer. A tecla de guardar precisa ser uma que o jogo lê com o jogador montado no veículo: o J, por exemplo, não funciona em veículo.
</Note>

## Garagens

Cada garagem é um bloco assim:

```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,
},
```

| Linha | O que significa |
| - | - |
| `valentine` | O nome curto da garagem. Minúsculo, sem espaço |
| `label` | O nome que o jogador vê |
| `coords` | Onde o jogador fica para abrir a garagem |
| `spawn` | Onde o veículo aparece ao ser retirado. O último número é para onde ele fica virado |
| `blip` | `true` mostra a garagem no mapa, `false` esconde |

Escolha um `spawn` com uns 6 metros livres em volta e nada baixo em cima: o menu da garagem mostra o veículo ali com a câmera girando em volta dele.

<Warning>
  Todo veículo guarda o **nome curto** da garagem dele. Se você trocar `valentine` por outro nome, os veículos guardados ali somem dela. Para criar uma garagem, adicione um bloco novo com um nome curto novo.
</Warning>

Já vêm sete garagens: Saint Denis, Rhodes, Valentine, Annesburg, Blackwater, Strawberry e Armadillo.

## Concessionárias

Funcionam como as garagens, com algumas linhas a mais:

| Linha | O que significa |
| - | - |
| `label` | O nome que o jogador vê |
| `coords` | Onde o jogador fica para abrir a concessionária |
| `range` | Quão perto (metros) de `coords` ela abre. Tire a linha para usar o `Config.InteractDistance` |
| `preview` | Onde fica o veículo em exposição enquanto o jogador escolhe |
| `npc` | O atendente (um modelo de personagem do jogo). Tire a linha para não ter atendente |
| `chair` | Opcional: a cadeira em que o atendente senta. Sem ela, ele procura um assento por perto |
| `garage` | A garagem (nome curto) que guarda os veículos comprados ali |
| `delivery` | Onde o veículo novo é entregue logo depois da compra. Tire a linha para entregar na garagem |
| `categories` | Que tipos de veículo são vendidos ali, por exemplo `{ 'bicycle' }`. `nil` vende tudo |
| `blip` | `true` mostra a concessionária no mapa |
| `lift` | Só para a loja de Saint Denis que vem com o resource: o veículo em exposição sobe numa plataforma. Não copie para outras concessionárias |

As alturas são ajustadas ao chão pelo script, então um `z` um metro errado não tem problema. A exceção é a concessionária de Saint Denis: o `preview` dela precisa ficar exato, porque é o topo da plataforma.

## Posicionando concessionárias e garagens

O jeito fácil de pegar os números de um ponto novo:

<Steps>
  <Step title="Ligue o modo de ajuda">
    Coloque `Config.Debug = true` e reinicie o servidor.
  </Step>

  <Step title="Fique no ponto">
    No jogo, vá até onde a garagem (ou o veículo) deve ficar, virado para o lado que você quer.
  </Step>

  <Step title="Copie sua posição">
    Digite `/vehicles_here` no chat, abra o console F8 e copie a linha que aparece para o config.
  </Step>

  <Step title="Desligue o modo de ajuda">
    Volte `Config.Debug = false` antes de abrir o servidor para os jogadores.
  </Step>
</Steps>

## Combustível

Carros e motos gastam gasolina andando; bicicleta nunca gasta. Veículo novo vem com o tanque cheio, e o veículo guarda o combustível quando vai para a garagem.

| Configuração | O que faz | Padrão |
| - | - | - |
| `Config.Fuel.enabled` | `false` desliga o combustível: o tanque nunca esvazia e os postos somem | `true` |
| `Config.Fuel.usage` | A velocidade com que o tanque esvazia. `1.0` = como cada veículo foi feito, `2.0` = o dobro, `0.5` = a metade | `1.0` |
| `Config.Fuel.price` | Preço de um litro, no dinheiro de `Config.MoneyAccount` | `0.10` |
| `Config.Fuel.rate` | Litros por segundo enquanto abastece | `0.6` |
| `Config.Fuel.reach` | Comprimento da mangueira (metros): o quão perto da bomba o veículo precisa estar | `8.0` |
| `Config.Fuel.pump` | A bomba colocada em cada posto. `'rco_fuel_pump'` é a nossa: a mangueira sai dela e a gasolina do vidro desce. Outro nome de modelo coloca aquele objeto no lugar; `nil` não coloca nada (o seu mapa já tem bombas) | `'rco_fuel_pump'` |

Na bomba, o jogador escolhe **Pegar a mangueira**. No veículo, **Abastecer** abre um talão onde ele escolhe quanto quer comprar; ele paga antes de encher, e **Parar** devolve o que não entrou. Um jogador por bomba de cada vez, e andar mais longe do que a mangueira alcança devolve ela.

Deixe `nozzle`, `nozzleBone` e `nozzleOffset` como estão quando usar a nossa bomba: eles põem o bico na mão do jogador.

## Postos de combustível

Cada posto é uma linha:

```lua theme={"dark"}
saintdenis = { label = 'Saint Denis', coords = vector4(2379.52, -1447.40, 45.84, 0.00), blip = true },
```

| Linha | O que significa |
| - | - |
| `saintdenis` | O nome curto do posto. Minúsculo, sem espaço |
| `label` | O nome que o jogador vê |
| `coords` | Onde o jogador fica para abastecer. O último número é a direção para onde ele olha: a bomba fica 0,9 metro na frente dele, virada para ele |
| `blip` | `true` mostra o posto no mapa, `false` esconde |

Vem com cinco postos: Saint Denis, Rhodes, Emerald Ranch, Blackwater e Armadillo. Para adicionar um, fique onde o jogador deve ficar, olhe para onde a bomba deve estar e pegue os números com o `/vehicles_here` (veja "Posicionando concessionárias e garagens", acima).

## Kit de reparo e dano dos veículos

Os veículos guardam o dano: um guardado soltando fumaça sai soltando fumaça, também depois de um restart ou quando ele foi perdido. Um veículo destruído volta da garagem muito danificado.

| Configuração | O que faz | Padrão |
| - | - | - |
| `Config.Repair.Item` | O nome do item no seu inventário (veja [Instalação](/pt-BR/rco-vehicles/installation)) | `'vehicle_repair_kit'` |
| `Config.Repair.Distance` | O quão perto (metros) o jogador precisa estar do veículo | `3.0` |
| `Config.Repair.Seconds` | Quanto tempo o conserto leva | `8` |
| `Config.Health.AfterWreck` | Quanta vida (por cento) um veículo destruído tem quando sai da garagem: soltando fumaça e lento até consertar | `15` |

O jogador usa o kit pelo inventário ao lado do veículo e se ajoelha para trabalhar nele com uma chave inglesa. O kit sai do inventário quando é usado e volta se o conserto não terminar (ele se afasta, morre ou entra num veículo). Veículo destruído não tem conserto com kit.


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