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

# Hot reload

> Veja as edições de uma estrutura aberta em um jogo conectado ao seu próprio servidor FiveM, sem exportar nem reiniciar.

O Hot reload envia a estrutura que você está editando para um servidor FiveM rodando no seu computador. Um jogador conectado a ele vê as mudanças após uma curta pausa, sem exportação no meio. Ele só acompanha a estrutura aberta em **Estruturas** e continua ligado quando você troca de ferramenta ou de aba. Fechar o projeto o desliga.

![Pílula de Hot reload em seus estados, de desligado a aplicado e a problemas no servidor](https://mintcdn.com/rageon/sn6rHDTWUcfx2HC1/images/pt_br/projects/hot-reload-pill.webp?fit=max\&auto=format\&n=sn6rHDTWUcfx2HC1\&q=85\&s=91d98448700c7fd5e7e252a227525a57)

A pílula de Hot reload em cada estado, ao lado da ficha do projeto.

## O que o servidor precisa

* FXServer rodando no mesmo computador do Rageon.
* O servidor vinculado em **Configurações** › **Bridge**, com o resource `rageon-bridge` instalado.
* `ensure rageon-bridge` no `server.cfg` do servidor. O Rageon copia o resource, mas nunca edita o `server.cfg`.
* Uma reinicialização do servidor depois de instalar ou atualizar o bridge.
* Nenhuma cópia exportada do mesmo projeto rodando nesse servidor. Remova a linha `ensure` dela e reinicie.

O Rageon avisa quando o bridge está ausente ou antigo demais, e oferece a correção.

## Vincular um servidor

**1. Adicione o servidor**

Clique na engrenagem de **Configurações** na barra de título, abra a aba **Bridge**, clique em **Adicionar** e escolha a pasta do servidor. Cada linha mostra o nome do servidor, o caminho `resources/` dele, se está online e o estado do bridge.

![Configurações do Bridge listando servidores FiveM com pontos de online e selos do bridge](https://mintcdn.com/rageon/sn6rHDTWUcfx2HC1/images/pt_br/projects/bridge-settings.webp?fit=max\&auto=format\&n=sn6rHDTWUcfx2HC1\&q=85\&s=ebff6436a3bdf1e9ace94b4ca3ed4c89)

Configurações › Bridge com servidores vinculados e o estado dos bridges.

**2. Instale o bridge**

Abra **Ações de …** na linha do servidor e escolha **Instalar**. Escolha **Reinstalar** quando o selo disser **desatualizado**. O selo vira **atual** quando os arquivos instalados estão em dia; o servidor ainda precisa reiniciar para usá-los.

**3. Reinicie o servidor**

Adicione `ensure rageon-bridge` ao `server.cfg` se não estiver lá e reinicie o servidor.

**Remover … da lista** só tira o servidor da lista. O resource continua na pasta do servidor. **Abrir diretório** abre o destino da instalação; **Trocar pasta de destino…** escolhe outra pasta dentro de `resources/`. Os selos do bridge são **verificando**, **ausente**, **atual**, **desatualizado**, **erro** e **instalando** durante a instalação.

## Ligar

**1. Abra uma estrutura**

Em **Estruturas**, abra a estrutura que você quer testar.

**2. Abra a pílula de Hot reload**

Clique em **Hot reload**, escolha um servidor e ligue o **Hot reload**. O interruptor e o seletor de servidor ficam desativados até você vincular um servidor; **Recarregar agora** só fica ativo quando o hot reload está ligado e o servidor está pronto. **Automático** usa o primeiro servidor vinculado que tenha um destino de exportação lembrado para este projeto. Se nenhum for lembrado, usa o primeiro servidor online, ou o primeiro vinculado se todos estiverem parados.

![Popover de Hot reload com o interruptor ligado, o servidor My PC online e Recarregar agora](https://mintcdn.com/rageon/sn6rHDTWUcfx2HC1/images/pt_br/projects/hot-reload-popover.webp?fit=max\&auto=format\&n=sn6rHDTWUcfx2HC1\&q=85\&s=82c849b66e25ea98c7106214a65fe1c4)

O popover com o servidor, o engine, o último reload e as peças.

**3. Edite**

Com o gatilho padrão **Ao editar**, uma pausa na edição inicia um reload. Espere **aplicado** confirmar que deu certo; **Recarregar agora** pede outro reload.

Desligue o **Hot reload** para remover a prévia do servidor.

## Estados da pílula

| Pílula | Significado |
| - | - |
| Ponto cinza | Desligado. |
| Spinner | Um reload está sendo montado ou aplicado. |
| Ponto verde | **aplicado**: o último reload passou. **online**: está ligado e o servidor está pronto, nada aplicado ainda. |
| Ponto vermelho | O último reload falhou. |
| Ponto âmbar | Um problema no servidor: sem servidor, servidor parado, sem `rageon-bridge`, bridge desatualizado, reinício necessário, sem camadas de colisão ou o resource do projeto está ativo. Abra o popover para ler. |

## Ajustes avançados

Clique em **Ajustes avançados…** no popover.

![Ajustes do Hot reload com as seções Servidor, Recarregar, Colisão, Peças e Sessão](https://mintcdn.com/rageon/sn6rHDTWUcfx2HC1/images/pt_br/projects/hot-reload-settings.webp?fit=max\&auto=format\&n=sn6rHDTWUcfx2HC1\&q=85\&s=ec7c58c3c07169b133c103892e8aa5e2)

Ajustes do Hot reload.

| Opção | O que faz | Padrão |
| - | - | - |
| **Servidor** | Qual servidor recebe a prévia. **Gerenciar servidores…** abre **Configurações** › **Bridge**. | **Automático** |
| **Porta** | A porta do servidor do jogo. O valor detectado aparece como texto de exemplo. Digite uma porta de 1 a 65535 para substituí-lo; limpe a substituição para voltar à detecção. | Detectada |
| **Gatilho** | **Ao editar** recarrega depois de uma pausa na edição, **Ao salvar** quando você salva o projeto, **Manual** só em **Recarregar agora**. | **Ao editar** |
| **Espera depois da edição** | A pausa antes de um reload **Ao editar**, de 300 a 3000 ms. Desativada para os outros gatilhos. | 300 ms |
| **Atualizar a colisão do mapa** | Troca a colisão a cada reload. Enquanto ligado, quem estiver perto da área vê a tela preta por cerca de 2 segundos a cada troca de colisão. Enquanto desligado, só a geometria troca e a colisão original do mapa continua sólida. | Ligado |
| **Peças** | Um interruptor por parte da estrutura, com o número de objetos que ela recarrega. Desligue as partes que você não está testando. | Todas ligadas |
| **Limpar prévias** | Remove a prévia do servidor. Desativado sem uma sessão no servidor. | |
| **Abrir pasta** | Abre a pasta do hot reload no servidor. Desativado sem um servidor selecionado. | |

**Camadas de colisão** mostra quantas das trocas de colisão da sessão estão em uso. **Sessão** mostra os modelos registrados no servidor. **Registro** lista os últimos 20 reloads, do mais novo ao mais antigo, com o tempo de cada fase em segundos.

## O que não recarrega

Salas, portais, luzes, timecycle, entity sets, som e o interior do jogo editado não recarregam. Exporte e reconecte ao servidor para vê-los. A lista de **Peças** marca o que uma parte não consegue recarregar.

Cada modelo fica na memória do jogo até o jogador se desconectar. Quando a sessão passa do aviso de memória, reconecte para liberá-la.

O Hot reload foi testado com um jogador conectado. Com mais, o Rageon avisa que a prévia pode divergir.

Viaturas não têm hot reload. Exporte o projeto e reinicie ou use `ensure` no resource.

## Limites e planos

O Hot reload não tem limite próprio. Ele depende dos servidores que o seu plano deixa você vincular. Servidores acima do limite ficam na lista, mas não aparecem como opções. Os detalhes estão na [página de preços](https://rageon.dev/pricing).

## Solução de problemas

> **Nenhum servidor FiveM vinculado.**
>
> Clique em **Vincular servidor…**, que abre **Configurações** › **Bridge**.

> **O servidor não responde em …. O app confere de novo a cada 2 s.**
>
> O servidor está parado ou não está neste computador. Inicie-o. O Rageon confere de novo sozinho enquanto o popover estiver aberto.

> **O rageon-bridge não está iniciado neste servidor.**
>
> Clique em **Instalar em Configurações › Bridge**, adicione `ensure rageon-bridge` ao `server.cfg` e reinicie o servidor.

> **O rageon-bridge deste servidor está …; o hot reload exige ….**
>
> Clique em **Atualizar em Configurações › Bridge** e reinicie o servidor.

> **O servidor ainda está rodando o engine antigo. Reinicie o servidor.**
>
> Reinicie o servidor depois de instalar ou atualizar o bridge.

> **As camadas de colisão não carregaram. Rode refresh no console do servidor ou reinicie-o.**
>
> Digite `refresh` no console do servidor ou reinicie o servidor.

> **O resource … deste projeto está ativo. Remova-o do server.cfg e reinicie o servidor.**
>
> A cópia exportada deste projeto está rodando no servidor e bloqueia a prévia. Remova a linha `ensure` dela e reinicie.

> **O servidor ainda está mostrando a prévia de uma sessão anterior.**
>
> Clique em **Limpar**.

> **O último reload falhou. …**
>
> Leia o motivo depois da frase e clique em **Recarregar agora**.

> **O servidor não terminou o reload em 20 segundos.**
>
> Clique em **Recarregar agora**.

> **A montagem não terminou em 60 segundos.**
>
> Clique em **Recarregar agora**.

> **A estrutura tem objetos demais para um reload (… objetos).**
>
> Divida a estrutura em estruturas menores.

> **Um jogador não conseguiu carregar a prévia.**
>
> Peça ao jogador que se reconecte.

> **Todas as 32 camadas de colisão desta sessão foram usadas. Reinicie o servidor para liberá-las.**
>
> Reinicie o servidor.

Outros erros nomeiam o problema na própria mensagem. Clique em **Recarregar agora** depois de corrigi-lo.


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