# ENTITY::GET_OFFSET_FROM_ENTITY_GIVEN_WORLD_COORDS

- **Hash:** `0x497C6B1A2C9AE69C`
- **Namespace:** ENTITY
- **Runtime name (Lua/JS):** `GetOffsetFromEntityGivenWorldCoords`
- **Side:** client (game native)
- **Name status:** official
- **Documentation:** named only
- **Since game build:** 1207
- **URL:** https://natives.borderlinerp.com/natives/ENTITY/GET_OFFSET_FROM_ENTITY_GIVEN_WORLD_COORDS

## Signature

```c
Vector3 GET_OFFSET_FROM_ENTITY_GIVEN_WORLD_COORDS(Entity entity, float posX, float posY, float posZ);
```

## Parameters

- `entity` (`Entity`)
- `posX` (`float`)
- `posY` (`float`)
- `posZ` (`float`)

## Returns

`Vector3`

## Usage

### Lua

```lua
local retval = GetOffsetFromEntityGivenWorldCoords(entity, posX, posY, posZ)

-- always available, by hash
local retval = Citizen.InvokeNative(0x497C6B1A2C9AE69C, entity, posX, posY, posZ, Citizen.ResultAsVector())
```

### JavaScript

```js
const retval = GetOffsetFromEntityGivenWorldCoords(entity, posX, posY, posZ);

// by hash
const retval = Citizen.invokeNative('0x497C6B1A2C9AE69C', entity, posX + 0.0000001, posY + 0.0000001, posZ + 0.0000001, Citizen.returnResultAnyway(), Citizen.resultAsVector());
```

### C#

```csharp
Vector3 retval = Function.Call<Vector3>((Hash)0x497C6B1A2C9AE69C, entity, posX, posY, posZ);
```

- 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.

*Sources: alloc8or RDR3 NativeDB.*
