# engineSetModelMaterial (Cliente)

> Substitui os materiais escolhidos de todas as instâncias de um modelo por um material.

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

## Sintaxe

```lua
bool engineSetModelMaterial(string|element model, int|string selector, material material [, int priority = 0])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `model` | `string\|element` | O nome do modelo ou um elemento `model`. |
| `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. |
| `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.

## Exemplo

```lua
local chrome = engineCreateMaterial("surface")
engineSetMaterialValue(chrome, "metallicFactor", 1)
engineSetMaterialValue(chrome, "roughnessFactor", 0.05)
engineSetModelMaterial("infernus", "*chrome*", chrome)
```

### Atenção

Um nome que não é de modelo é um erro.

## Veja também

- [engineRestoreModelMaterial (Cliente)](https://wiki.mymp.gg/pt/engineRestoreModelMaterial.md): Desfaz o que engineSetModelMaterial deste recurso fez de todas as instâncias de um modelo.
- [engineGetModelMaterials (Cliente)](https://wiki.mymp.gg/pt/engineGetModelMaterials.md): Lista os materiais do modelo carregado, na ordem em que o modelo os guarda.
- [engineSetWorldMaterial (Cliente)](https://wiki.mymp.gg/pt/engineSetWorldMaterial.md): Substitui os materiais escolhidos de todos os modelos do mundo por um material.
- [engineSetElementMaterial (Cliente)](https://wiki.mymp.gg/pt/engineSetElementMaterial.md): Substitui os materiais escolhidos de um único veículo, ped ou objeto por um material.