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