# Function: onLabelStarting() (/jsdoc/pixi-vn/index/namespaces/Game/functions/onLabelStarting)



\> **onLabelStarting**(`value`): `void`

Defined in: [src/index.ts:432](https://github.com/DRincs-Productions/pixi-vn/blob/efc9536feda21bc17c50370f5e35fd8d8d88843a/src/index.ts#L432)

Is a function that will be executed every time a label is about to be started, either via
`narration.call`, `narration.jump`, or a choice of type `"call"` / `"jump"`.

By default (when this is not set), the label starts immediately, exactly like before this hook
existed. If you set it, you take control: call `defaultStart()` yourself whenever you actually
want the label to run — right away, or later (e.g. on a subsequent player action in your
template). Until `defaultStart()` is called, nothing about the label happens: it is not added to
the history and no step of it runs.

## Parameters [#parameters]

### value [#value]

(`labelId`, `props`, `options`, `defaultStart`) => [`StepLabelResultType`](/jsdoc/pixi-vn/index/type-aliases/StepLabelResultType) | `Promise`\<[`StepLabelResultType`](/jsdoc/pixi-vn/index/type-aliases/StepLabelResultType)>

## Returns [#returns]

`void`

## Example [#example]

```ts
Game.onLabelStarting((labelId, props, options, defaultStart) => {
    pendingLabelStart = defaultStart; // keep it for later, don't run it now
})
```