# setConvar (Cliente)

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

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

## Sintaxe

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

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `name` | `string` | Nome da convar. |
| `value` | `string` | Valor. |
| `persist` | `bool` | Guardar o valor para as próximas sessões neste servidor. *(padrão: `false`)* |

## Retorno

`true` se definiu, `false` se ainda não há sessão com um servidor. Dá erro se o servidor sincroniza essa convar.

## Exemplo

```lua
setConvar("hud_scale", "1.2", true)
```

### Atenção

O que foi guardado com `persist` se perde quando o servidor troca o seu `content.key`.

## Veja também

- [setConvar (Servidor)](https://wiki.mymp.gg/pt/setConvar-server.md): 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.
- [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.