# setConvar (Servidor)

> Define uma convar no servidor, criando-a se não existir. Com `synced`, o valor vai para todos os clientes, inclusive os que entrarem depois, e o `getConvar` deles passa a ler este valor.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Função Lua
- **Lado**: Servidor
- **Categoria**: Convars
- **URL**: https://wiki.mymp.gg/pt/setConvar-server
- **Contraparte**: Também existe no cliente, com outra implementação: [setConvar (Cliente)](https://wiki.mymp.gg/pt/setConvar-client.md)

## Sintaxe

```lua
bool setConvar(string name, string value [, bool synced = false])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `name` | `string` | Nome da convar. |
| `value` | `string` | Valor. |
| `synced` | `bool` | Sincronizar com os clientes. Um `setConvar` sem ele para de sincronizar a convar. *(padrão: `false`)* |

## Retorno

`true`.

## Exemplo

```lua
setConvar("weather_cycle", "1", true)
```

### Atenção

Uma convar secreta, como `password` ou `server_key`, não pode ser sincronizada: a chamada dá erro. O nome e o valor de uma convar sincronizada cabem juntos em até 4000 bytes.

## Veja também

- [setConvar (Cliente)](https://wiki.mymp.gg/pt/setConvar-client.md): Define uma convar só neste cliente. Ela nunca é enviada ao servidor. Com persist, o valor fica guardado para este servidor e volta na próxima sessão.
- [getConvar (Compartilhado)](https://wiki.mymp.gg/pt/getConvar.md): Lê uma convar como texto. No cliente, uma convar que o servidor sincroniza vem antes da do próprio cliente.
