# Personal Force Field

Personal Force Field is a Rust/Oxide plugin that gives players a wearable energy shield that absorbs incoming damage and converts it into durability loss instead of health damage.

Features

* 🛡️ Personal Energy Shield — Wear the configured Force Field item to activate the shield.
* 💥 Damage Absorption — Incoming player, NPC, animal, turret, and trap damage is absorbed by the Force Field.
* 🔋 Durability System — The shield loses durability while worn and takes additional durability damage when absorbing attacks.
* 🟢 Visual Shield — Displays a green protective sphere around the player while the shield is active.
* 🔴 Low-Power Warning — The shield changes to red when durability falls below the configured threshold.
* 🟣 Damage Feedback — A temporary purple shield effect appears when the Force Field absorbs a hit.
* 📊 Power HUD — Displays the current Force Field durability percentage and online/offline status.
* 🔊 Active Sound Effect — Plays a configurable looping effect while the shield is active.
* 💥 Break Effect — Plays a configurable effect when the shield reaches zero durability.
* ♾️ Unlimited Shields — Players with the unlimited permission can use a shield without losing durability.
* 🎁 Plugin/Shop Integration — The console giveff command can be used by other plugins and reward systems such as ServerRewards.
* 🔐 Permission Controlled — Separate permissions control normal use and unlimited durability.

Commands

Player Command

/giveff

Gives the player a Personal Force Field.

Permission:

personalforcefield.use

Console Command

giveff <SteamID|name>

Gives a Personal Force Field to the specified player.

Also available as:

pff.giveff <SteamID|name>

The console command is designed for server administration and integration with other plugins or shop/reward systems.

Example:

giveff 76561198000000000

Permissions

| Permission | Description |
| ------------------------------ | ----------------------------------------------- |
| personalforcefield.use | Allows the player to use /giveff |
| personalforcefield.unlimited | Prevents the Force Field from losing durability |

Durability

The Force Field supports separate durability multipliers depending on the damage source.

Default values:

| Damage Source | Durability Loss |
| ------------------------------- | --------------: |
| Player damage | 2x |
| Animal / Zombie / NPC Scientist | 10x |
| Auto Turret | 2.5x |
| Flame Turret | 10x |
| Gun Trap | 3x |
| Passive drain while worn | 0.1/sec |

All of these values can be changed in the plugin configuration.

Configuration

The plugin allows customization of:

* Force Field item ID and skin ID
* Display name and amount given
* Green and red shield sphere prefabs
* Low-durability threshold
* Shield position and scale
* Passive durability drain
* Damage durability multipliers
* Active and break sound effects
* Damage flicker effect and duration
* Power HUD position
* HUD colors and font sizes

Integration

The console giveff command can be called by other server systems, making the plugin suitable for kits, shops, reward systems, and custom plugin integrations.

For example, it can be used as a ServerRewards command reward:

giveff {player.id}

PersonalForceField