OverShield

Give Your Players a Second Health Bar.

Details

OverShield is a plugin that lets you create as many wearable shields as you like.

A shield is just an item and a skin, so you can use anything you want. When a player wears one they get a shield counter on their HUD that takes damage before their health takes any of it. Each shield has its own permission, so you decide who gets what, and you can sell or reward them however you like.

Every shield picks its own damage types to absorb, so a cheap shield might only stop Bullets and Melee while your top tier stops everything the game can throw at a player. Damage is taken off the shield first, and anything left over carries through to the player, so a big hit on a nearly empty shield still hurts.

When a shield runs dry it breaks, plays your break effect and tells the player. After that it starts charging itself back up, and plays your fully charged effect when it tops out.

By default shields ignore damage from other players, so they only protect against the world, NPCs and the environment. Flip Absorb PvP Damage on any shield if you want it working in PvP too.

Damage Types

Each shield turns these on and off individually:

Bullet, Arrow, Explosion, Melee, Fire, Cold, Fall, Radiation Exposure, Electric Shock, Cannon, Bee Sting, Paintball, Collision, Bleeding, Poison and Drowned.

Melee covers slash, stab, blunt and animal bites. Explosion covers rockets, grenades, satchels, MLRS and anti vehicle damage. Cannon covers the siege weapons.

Bleeding, Poison and Drowned tick over and over instead of landing in one hit, so they drain a shield steadily rather than all at once. Drowned is the fastest drain in the game, a 100 shield buys roughly five extra seconds underwater before a player actually starts drowning. I'd leave these off unless you want that, they are off by default.

With Radiation Exposure or Cold enabled the shield also holds off radiation poisoning and freezing while it still has charge, so players can push into hot zones or survive the snow as long as their shield lasts.

Recharging

Three settings per shield control how a shield comes back:

Recharge Delay - how long a player has to go without taking damage before charging starts.

Recharge Tick Interval - how often it adds charge once it has started.

Recovery Increase - how much charge each tick adds.

Split like that you can make a shield that makes players wait a long time after a fight but then refills fast, or one that starts trickling back almost straight away. Swapping a shield puts it on a short cooldown so players can't hot swap their way out of a fight.

The HUD

The shield shows as its item icon with the remaining charge underneath, and updates as the player takes hits and charges back up.

You can put it in the bottom left or bottom right next to the hotbar, the top left or top right corners, or pick custom and set the anchors and offsets yourself in the config.

Default Shields

By default OverShield comes with 3 shields. These are ideas to get you started, you can add as many as you like and each one gets its own permission.

Basic Shield - 100 charge, waits 10 seconds after a fight then refills in about 20.

Advanced Shield - 200 charge, waits 8 seconds and refills a little quicker.

Ultimate Shield - 225 charge, only waits 5 seconds and refills fastest.

All three absorb everything except Bee Sting, Paintball, Bleeding, Poison, Drowned and PvP damage, so there is plenty of room to build tiers above and below them.

Commands

/gs - Gives you one of every shield in your config, admin only

overshield.give <steamid or name> - Same thing from console or RCON, leave the name off in F1 to give to yourself

Permissions

overshield.basic - Allows equipping the Basic Shield

overshield.advanced - Allows equipping the Advanced Shield

overshield.ultimate - Allows equipping the Ultimate Shield

Every shield you add creates its own permission, whatever you name it in the config.

Other Stuff

Includes Lang for translation.