Shield Stuns

ShieldStuns

Automatically configure Paper server for optimal shield mechanics
Description
ShieldStuns is a lightweight utility plugin that automatically configures your Paper server to enable the skip-vanilla-damage-tick-when-shield-blocked setting. This plugin eliminates the need to manually edit configuration files and ensures your server has the optimal shield blocking behavior from the moment it starts.

Features

Automatic Configuration: Instantly modifies paper-global.yml on server startup
Zero Configuration: No setup required - just drop it in your plugins folder
Smart Detection: Only modifies settings when necessary
Safe Operation: Creates backup-friendly YAML output with proper formatting
Detailed Logging: Clear console messages about what the plugin is doing
Error Resistant: Handles missing config sections and creates them if needed

What It Does

This plugin automatically sets:
yamlcollisions:
skip-vanilla-damage-tick-when-shield-blocked: true
This configuration change affects how shield blocking interacts with damage timing in your server, providing improved shield mechanics for PvP and gameplay.

Requirements

Paper Server (1.19+) - Does not work with Spigot/Bukkit
Java 17+
Server restart after first installation

Installation

Download ShieldStuns.jar
Place it in your server's plugins/ folder
Start your server
Restart your server (required for Paper to apply config changes)
Done! The plugin will automatically configure your server

Usage

This plugin works completely automatically:

First Startup: Plugin detects and modifies Paper configuration
Subsequent Startups: Plugin checks if setting is already correct
No Commands: No player commands or permissions needed
No GUI: Configuration happens silently in the background

Console Output

When working correctly, you'll see:
[ShieldStuns] ShieldStuns plugin is enabling...
[ShieldStuns] Modified paper-global.yml successfully!
[ShieldStuns] Successfully enabled skip-vanilla-damage-tick-when-shield-blocked!
[ShieldStuns] Server restart required for changes to take effect!
[ShieldStuns] ShieldStuns plugin enabled successfully!

Important Notes

Paper Only: This plugin requires Paper server - it will not work on Spigot or Bukkit
Restart Required: After first installation, restart your server for changes to take effect
One-Time Setup: Once configured, the plugin maintains the setting automatically
Safe to Remove: After configuration, you can remove the plugin if desired (setting will remain)

Technical Details

Author: PoggerCity
Version: 1.0.0
API Version: 1.21+
Load Phase: STARTUP (loads early to modify config before other plugins)
Dependencies: None (works standalone)

Troubleshooting

"paper-global.yml not found"

Ensure you're using Paper server, not Spigot/Bukkit
Start your server at least once to generate config files

Changes don't take effect

Restart your server after the plugin first runs
Check console for success/error messages

Permission errors

Ensure your server has write permissions to the config/ folder

License

This plugin is provided as-is for server administration purposes. Feel free to use and modify for your server needs.

Perfect for server owners who want hassle-free Paper configuration!