# getConvar (Compartilhado)

> Lê uma convar como texto. No cliente, uma convar que o servidor sincroniza vem antes da do próprio cliente.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Função Lua
- **Lado**: Compartilhado
- **Categoria**: Convars
- **URL**: https://wiki.mymp.gg/pt/getConvar

## Sintaxe

```lua
string|any getConvar(string name [, any default = false])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `name` | `string` | Nome da convar. |
| `default` | `any` | O que devolver quando a convar não existe ou está vazia. *(padrão: `false`)* |

## Retorno

O valor da convar. Se ela não existe ou está vazia, `default`.

## Exemplo

```lua
local mode = getConvar("gamemode", "freeroam")
```

## Veja também

- [getConvarInt (Compartilhado)](https://wiki.mymp.gg/pt/getConvarInt.md): Lê uma convar como número inteiro.
- [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.
- [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.