# PED::GET_PED_BONE_COORDS

- **Hash:** `0x17C07FC640E86B4E`
- **Namespace:** PED
- **Runtime name (Lua/JS):** `GetPedBoneCoords`
- **Side:** client (game native)
- **Name status:** official
- **Documentation:** described
- **Since game build:** 1207
- **URL:** https://natives.borderlinerp.com/natives/PED/GET_PED_BONE_COORDS

## Signature

```c
Vector3 GET_PED_BONE_COORDS(Ped ped, int boneId, float offsetX, float offsetY, float offsetZ);
```

## Parameters

- `ped` (`Ped`)
- `boneId` (`int`)
- `offsetX` (`float`)
- `offsetY` (`float`)
- `offsetZ` (`float`)

## Returns

`Vector3`

## Description

Gets the position of the specified bone of the specified ped.

ped: The ped to get the position of a bone from.
boneId: The ID of the bone to get the position from. This is NOT the index.
offsetX: The X-component of the offset to add to the position relative to the bone's rotation.
offsetY: The Y-component of the offset to add to the position relative to the bone's rotation.
offsetZ: The Z-component of the offset to add to the position relative to the bone's rotation.

## Usage

### Lua

```lua
local retval = GetPedBoneCoords(ped, boneId, offsetX, offsetY, offsetZ)

-- always available, by hash
local retval = Citizen.InvokeNative(0x17C07FC640E86B4E, ped, boneId, offsetX, offsetY, offsetZ, Citizen.ResultAsVector())
```

### JavaScript

```js
const retval = GetPedBoneCoords(ped, boneId, offsetX, offsetY, offsetZ);

// by hash
const retval = Citizen.invokeNative('0x17C07FC640E86B4E', ped, boneId, offsetX + 0.0000001, offsetY + 0.0000001, offsetZ + 0.0000001, Citizen.returnResultAnyway(), Citizen.resultAsVector());
```

### C#

```csharp
Vector3 retval = Function.Call<Vector3>((Hash)0x17C07FC640E86B4E, ped, boneId, offsetX, offsetY, offsetZ);
```

- Float parameters: Lua integers (`10`, or whole numbers decoded from NUI/JSON) are sent as ints and read as garbage. Write `10.0` or `value + 0.0`. The generated JS wrappers add `0.0000001` to non-zero floats for the same reason.

## Related enums

- [eAnimBoneTag](https://natives.borderlinerp.com/enums/eAnimBoneTag.md) — 911 values

*Sources: alloc8or RDR3 NativeDB.*
