ShieldFix — Manage your player's Shields
Short Description
ShieldFix is a lightweight plugin that gives you precise control over the shield blocking delay (shield blocking cooldown). It provides global settings, per-player overrides, commands to set/increase/decrease player delays, configurable min/max limits, and optional PlaceholderAPI support.
Key Features
Per-player overrides — stores custom delays by UUID (survives name changes).
Admin and user commands — full control via /shieldset and /shielddelay.
Increase / Decrease — quick commands to adjust your own delay.
PlaceholderAPI (optional) — %shieldfix_delay% and %shieldfix_delay_<player>%.
Configurable limits — set min and max allowed delay values.
Feature toggles — enable/disable commands, event handling or PAPI in config.
Saved in config.yml — per-player values are stored under player-delays.
Commands
/shieldset — Set a player's delay (player must be online). Permission: shieldfix.set.others.
/shielddelay get [player] — Show your delay or another player's delay (shieldfix.get.others required for others).
/shielddelay set [player] — Set the delay (no player = set your own). Permissions: shieldfix.set.self / shieldfix.set.others.
/shielddelay inc [amount] — Increase your delay (default +1). Permission: shieldfix.modify.self.
/shielddelay dec [amount] — Decrease your delay (default -1). Permission: shieldfix.modify.self.
/shielddelay reload — Reload the config. Permission: shieldfix.reload.
Recommended Permission Nodes
shieldfix.set.others (default: op)
shieldfix.set.self (default: true)
shieldfix.modify.self (default: true)
shieldfix.get.others (default: op)
shieldfix.reload (default: op)
PlaceholderAPI
If features.papi.enable is true and PlaceholderAPI is installed, the plugin registers:
%shieldfix_delay% — returns the effective delay of the player viewing the placeholder.
%shieldfix_delay_PlayerName% — returns the effective delay of the specified online player (e.g. %shieldfix_delay_SomeNick%).
Example config options
Code (Text):
Global default
shielddelay: 0
Compatibility custom cooldown
custom-cooldown: 1
custom-cooldown-perms: "test"
custom-cooldown-players:
your_enemy
Feature toggles
features:
commands:
enable: true
papi:
enable: true
player_delays:
enable: true
shield_event:
enable: true
limits:
min-delay: 0
max-delay: 20
player-delays:
"550e8400-e29b-41d4-a716-446655440000": 2
Installation
Place ShieldFix.jar in your plugins/ folder.
Start/restart the server to generate config.yml.
* Install PlaceholderAPI to enable placeholders.
Behavior & Priority Rules
If player-delays contains a UUID entry, that value takes priority.
Otherwise, if the player is listed in custom-cooldown-players or has the custom-cooldown-perms permission, custom-cooldown is used (backwards compatibility).
Otherwise the global shielddelay is used.
All values set via commands are automatically clamped between limits.min-delay and limits.max-delay.
Support
If you need help, want to report a bug, or suggest a feature, contact the author (provide preferred contact: SpigotPM / Telegram / GitHub).
Thanks for using ShieldFix — if you like it, please leave a review!