# TASK::_GET_LINKED_SCENARIO_POINTS

- **Hash:** `0xE7BBC4E56B989449`
- **Namespace:** TASK
- **Runtime name (Lua/JS):** `GetLinkedScenarioPoints`
- **Side:** client (game native)
- **Name status:** community guess (may change)
- **Documentation:** described
- **Since game build:** 1207
- **URL:** https://natives.borderlinerp.com/natives/TASK/_GET_LINKED_SCENARIO_POINTS

## Signature

```c
int _GET_LINKED_SCENARIO_POINTS(int scenarioPoint, int* outPoints, int maxPoints);
```

## Parameters

- `scenarioPoint` (`int`)
- `outPoints` (`int*`)
- `maxPoints` (`int`)

## Returns

`int`

## Description

*Source: alloc8or RDR3 NativeDB*

Fills an output array with scenario points linked ("chained") to a given parent scenario point. Returns the number of linked points found. Writes up to maxPoints and zeroes remaining entries. Useful for flows like chained put-down scenarios.

Params:
- scenarioPoint: Parent scenario point handle.
- outPoints: Pointer to an int array that receives the linked scenario point handles.
- maxPoints: Capacity of outPoints.

Returns: Count of linked scenario points written (0 if none).

*Source: VORPCORE RDR3natives*

Fills an output array with scenario points linked (chained) to a given parent scenario point. Returns the number of linked points found. Writes up to maxPoints and zeroes remaining entries. Useful for flows like chained put-down scenarios.

## Usage

### Lua

```lua
local retval, outPoints = GetLinkedScenarioPoints(scenarioPoint, maxPoints)

-- always available, by hash
local retval, outPoints = Citizen.InvokeNative(0xE7BBC4E56B989449, scenarioPoint, Citizen.PointerValueInt(), maxPoints, Citizen.ResultAsInteger())
```

### JavaScript

```js
const [retval, outPoints] = GetLinkedScenarioPoints(scenarioPoint, maxPoints);

// by hash
const [retval, outPoints] = Citizen.invokeNative('0xE7BBC4E56B989449', scenarioPoint, Citizen.pointerValueInt(), maxPoints, Citizen.returnResultAnyway(), Citizen.resultAsInteger());
```

### C#

```csharp
var outPoints = new OutputArgument();
int retval = Function.Call<int>((Hash)0xE7BBC4E56B989449, scenarioPoint, outPoints, maxPoints);
// outPoints.GetResult<int>()
```

- Pointer (out) arguments are not passed in Lua/JS: their values are returned after the result, in order.
- The name is a community guess and may change. If the named call is missing in your client build, use `InvokeNative` with the hash — it always works.

*Sources: alloc8or RDR3 NativeDB, VORPCORE RDR3natives.*