# engineSetWorldMaterial (Cliente)

> Substitui os materiais escolhidos de todos os modelos do mundo por um material.

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

## Sintaxe

```lua
bool engineSetWorldMaterial(int|string selector, material material [, string targets = world vehicle, int priority = 0])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `selector` | `int\|string` | Qual material: o índice a partir de 1 ou o nome, como `engineGetModelMaterials` os lista. O nome não diferencia maiúsculas e aceita os curingas `*` e `?`. |
| `material` | `material` | O material que passa a ser desenhado no lugar. |
| `targets` | `string` | Que modelos alcança: `world`, `vehicle` e `ped`, separados por espaço ou vírgula. *(padrão: `world vehicle`)* |
| `priority` | `int` | Quando vários recursos escolhem o mesmo material, vence a maior prioridade; entre iguais, o mais recente. *(padrão: `0`)* |

## Retorno

`true` quando foi aplicado.

Um material definido para o modelo com `engineSetModelMaterial` vence o do mundo.

## Exemplo

```lua
local wet = engineCreateMaterial()
engineSetMaterialValue(wet, "roughnessFactor", 0.1)
engineSetWorldMaterial("*road*", wet, "world")
```

## Veja também

- [engineRestoreWorldMaterial (Cliente)](https://wiki.mymp.gg/pt/engineRestoreWorldMaterial.md): Desfaz o que engineSetWorldMaterial deste recurso fez de todos os modelos do mundo.
- [engineSetModelMaterial (Cliente)](https://wiki.mymp.gg/pt/engineSetModelMaterial.md): Substitui os materiais escolhidos de todas as instâncias de um modelo por um material.
- [engineSetWorldTexture (Cliente)](https://wiki.mymp.gg/pt/engineSetWorldTexture.md): 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.
- [engineCreateMaterial (Cliente)](https://wiki.mymp.gg/pt/engineCreateMaterial.md): Cria um material: um shader com valores de parâmetros, que depois substitui ou se sobrepõe aos materiais dos modelos.