Shield Stuns

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8

平台： bukkit paper purpur spigot

标签： adventure game-mechanics optimization

?️ 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!