# getPedBonePosition (Cliente)

> Devolve a posição de um osso de um ped no mundo.

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

## Sintaxe

```lua
vec3|false getPedBonePosition(ped ped, int|string bone)
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `ped` | `ped` | O ped ou jogador. |
| `bone` | `int\|string` | Um id de osso do MTA até 54, a tag de um osso do rig ou o nome dele. |

## Retorno

Um `vec3` com a posição. `vec3(0, 0, 0)` se o ped está fora do alcance de streaming. `false` se o id não é de um osso do corpo ou o ped não tem esse osso.

Para objetos e para os ids acima de 54, use `getElementBonePosition`.

## Exemplo

```lua
addEventHandler("onClientRender", root, function()
    local head = getPedBonePosition(localPlayer, 5)
    if head then
        local sx, sy = getScreenFromWorldPosition(head.x, head.y, head.z + 0.3)
        if sx then
            dxDrawText(getPlayerName(localPlayer), sx, sy)
        end
    end
end)
```

### Vindo do MTA

No MTA devolve três números. Aqui devolve um `vec3` e também aceita ossos do rig por tag ou nome.

### Atenção

Dá erro se o ped está no alcance de streaming e não tem um osso com essa tag ou nome.

## Veja também

- [getElementBonePosition (Cliente)](https://wiki.mymp.gg/pt/getElementBonePosition.md): Devolve a posição de um osso de um ped ou objeto no mundo.
- [getElementBoneMatrix (Cliente)](https://wiki.mymp.gg/pt/getElementBoneMatrix.md): Devolve a matriz de um osso de um ped ou objeto no mundo.