# engineSetWorldTexture (Cliente)

> Troca uma textura em todos os modelos dos tipos escolhidos que a usam. Só os materiais dos modelos mudam, não o txd de onde a textura vem.

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

## Sintaxe

```lua
bool engineSetWorldTexture(string name, texture|dui|bool source [, string targets = "world vehicle", int priority = 0])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `name` | `string` | Nome da textura, ou um padrão glob, comparado com os nomes de textura de todos os modelos. |
| `source` | `texture\|dui\|bool` | Uma `texture`, um `dui`, ou `false` para esconder a textura. |
| `targets` | `string` | Quais modelos: `world`, `vehicle` e `ped`, separados por espaços ou vírgulas. *(padrão: `"world vehicle"`)* |
| `priority` | `int` | Entre várias trocas para a mesma textura, a maior prioridade vale; entre iguais, a mais nova. *(padrão: `0`)* |

## Retorno

`true` quando a troca é aplicada. Lança um erro se a fonte não for uma imagem ou `false`, ou se um alvo for desconhecido.

As trocas do mundo valem abaixo das de um modelo (`engineSetModelTexture`) e das de um elemento (`engineSetElementTexture`).

## Exemplo

```lua
engineSetWorldTexture("*graffiti*", false, "world")
```

## Veja também

- [engineRestoreWorldTexture (Cliente)](https://wiki.mymp.gg/pt/engineRestoreWorldTexture.md): Remove as trocas de textura do mundo que este recurso aplicou com engineSetWorldTexture.
- [engineSetModelTexture (Cliente)](https://wiki.mymp.gg/pt/engineSetModelTexture.md): Troca uma textura em todas as instâncias de um modelo. Só os materiais desse modelo mudam, não o txd de onde a textura vem.
- [engineSetElementTexture (Cliente)](https://wiki.mymp.gg/pt/engineSetElementTexture.md): Troca uma textura de um único veículo, ped, jogador ou objeto. As outras instâncias do mesmo modelo mantêm suas texturas.
- [engineSetWorldMaterial (Cliente)](https://wiki.mymp.gg/pt/engineSetWorldMaterial.md): Substitui os materiais escolhidos de todos os modelos do mundo por um material.