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