> For the complete documentation index, see [llms.txt](https://wiki.thescriptersguild.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.thescriptersguild.com/knowledge/scripting/guides-and-info/restore-player-shield-instantly.md).

# Restore Player Shield Instantly

Use the Set Player Overshield node with a 0.00 Percent Shield value to immediately restore a player's shield to maximum.

<figure><img src="https://692276616-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN06Vv6nlwviUQ4hI2Kkd%2Fuploads%2Fgit-blob-74e137057d6f7b94c14119a6cbc4254a8f2c8ecf%2Fcover-tsg-placeholder.jpg?alt=media" alt="Cover image"><figcaption></figcaption></figure>

While standard shield regeneration typically occurs over time, it is possible to bypass this process through scripting. By manipulating overshield nodes or recharge traits, developers can trigger immediate shield restoration.

## Implementation via Overshield Node

The most effective way to restore a shield instantly is to use the [Set Player Overshield](/scripting/nodes/players/set-player-overshield.md) node. Although this node is primarily intended to add extra protection, its underlying logic can be leveraged to reset the standard shield bar.

### Node Configuration

To achieve a full shield restoration without adding additional overshield protection, configure the node with the following setting:

* **Percent Shield**: `0.00`

<figure><img src="https://692276616-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN06Vv6nlwviUQ4hI2Kkd%2Fuploads%2Fgit-blob-94c164df44488578fac0ced4f180176aec00f0c8%2F2026-03-02_HaloInfinite-bE7M.png?alt=media" alt="Set Player Overshield node"><figcaption><p>The `Set Player Overshield` node configured with a 0.00 percent shield value.</p></figcaption></figure>

## Underlying Mechanics

The ability to use this node for instant regeneration is due to the specific execution order of the overshield logic. When the `Set Player Overshield` node is triggered, the system performs two distinct actions in sequence:

1. The player's current shield is immediately set to its maximum value.
2. The specified overshield amount is then applied on top of that maximum value.

By providing a `Percent Shield` value of `0.00`, the second step adds no additional overshield protection, resulting in only an instant reset to the player's maximum standard shield.

{% hint style="success" %}
This technique is a useful workaround for mechanics that require an immediate "recharge" effect without the player gaining the extra durability associated with overshields.
{% endhint %}

## Alternative Method via Shield Recharge Trait

For a near-instantaneous recharge (approximately 0.2 seconds) without using the overshield node, you can manipulate the [Trait: Shield Recharge](/scripting/nodes/traits-player/trait-shield-recharge.md) node. This method adjusts the timing and speed of the standard regeneration process.

### Implementation

To use this method, you must declare, apply and remove a trait set:

* Use the [Declare Trait Set](/scripting/nodes/traits/declare-trait-set.md) node to create a set containing the shield recharge trait.
* Use the [Apply Player Trait Set](/scripting/nodes/traits-player/apply-player-trait-set.md) node (or its variants) to apply the set to a player.
* Use the [Remove Player Trait Set](/scripting/nodes/traits-player/remove-player-trait-set.md) node to remove the trait once the regeneration has finished.

### Configuration

To maximize recharge speed, use the following scalar values (compared to the default 5.000s cooldown and 2.000s recharge):

* **Recharge Delay Scalar**: `-1.00` (results in 0.000 s cooldown)
* **Recharge Rate Scalar**: `10.00` (results in 0.2000 s recharge time)

<figure><img src="https://692276616-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN06Vv6nlwviUQ4hI2Kkd%2Fuploads%2Fgit-blob-05b8af903263af4a87dadab20f3bb1037986999c%2FHaloInfinite_ejMHiRANOp.jpg?alt=media" alt="Ideal shield recharge settings"><figcaption><p>Comparison between default trait values and settings for instant shield recharge.</p></figcaption></figure>

Conversely, extreme values can be used to effectively disable regeneration:

* **Recharge Delay Scalar**: `7.00` or higher (results in 40.000 s cooldown)
* **Recharge Rate Scalar**: `-1.00` (results in infinite recharge time)

<figure><img src="https://692276616-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN06Vv6nlwviUQ4hI2Kkd%2Fuploads%2Fgit-blob-67a1a8658d9013f0f800e1c31bf17e488d6b483d%2FHaloInfinite_yHmp1CNP0o.jpg?alt=media" alt="Extreme shield recharge settings"><figcaption><p>Comparison between default trait values and settings that result in near-infinite recharge times.</p></figcaption></figure>

{% hint style="info" %}
These settings also impact health regeneration, resulting in a 0.000s health cooldown and 0.100s health recharge time.
{% endhint %}

***

## Source Data

* Discord thread: [Restore Player Shield Instantly](https://discord.com/channels/220766496635224065/1478032097200574626/1478032097200574626)

#### <mark style="color:green;">Contributors</mark>

Okom