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 plugin is enabling... Modified paper-global.yml successfully! Successfully enabled skip-vanilla-damage-tick-when-shield-blocked! Server restart required for changes to take effect! 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!