# \ud83d\udee1\ufe0f ShieldStuns
\nAutomatically configure Paper server for optimal shield mechanics
\nDescription
\nShieldStuns 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.
\n# \u2728 Features<\/p>\n
Automatic Configuration: Instantly modifies paper-global.yml on server startup
\nZero Configuration: No setup required – just drop it in your plugins folder
\nSmart Detection: Only modifies settings when necessary
\nSafe Operation: Creates backup-friendly YAML output with proper formatting
\nDetailed Logging: Clear console messages about what the plugin is doing
\nError Resistant: Handles missing config sections and creates them if needed<\/p>\n
# \ud83c\udfaf What It Does
\nThis plugin automatically sets:
\nyamlcollisions:
\n skip-vanilla-damage-tick-when-shield-blocked: true
\nThis configuration change affects how shield blocking interacts with damage timing in your server, providing improved shield mechanics for PvP and gameplay.
\n# \ud83d\udccb Requirements<\/p>\n
Paper Server (1.19+) – Does not work with Spigot\/Bukkit
\nJava 17+
\nServer restart after first installation<\/p>\n
# \ud83d\ude80 Installation<\/p>\n
Download ShieldStuns.jar
\nPlace it in your server’s plugins\/ folder
\nStart your server
\nRestart your server (required for Paper to apply config changes)
\nDone! The plugin will automatically configure your server<\/p>\n
# \ud83d\udcca Usage
\nThis plugin works completely automatically:<\/p>\n
First Startup: Plugin detects and modifies Paper configuration
\nSubsequent Startups: Plugin checks if setting is already correct
\nNo Commands: No player commands or permissions needed
\nNo GUI: Configuration happens silently in the background<\/p>\n
# \ud83d\udcdd Console Output
\nWhen working correctly, you’ll see:
\n[ShieldStuns] ShieldStuns plugin is enabling…
\n[ShieldStuns] Modified paper-global.yml successfully!
\n[ShieldStuns] Successfully enabled skip-vanilla-damage-tick-when-shield-blocked!
\n[ShieldStuns] Server restart required for changes to take effect!
\n[ShieldStuns] ShieldStuns plugin enabled successfully!
\n# \u26a0\ufe0f Important Notes<\/p>\n
Paper Only: This plugin requires Paper server – it will not work on Spigot or Bukkit
\nRestart Required: After first installation, restart your server for changes to take effect
\nOne-Time Setup: Once configured, the plugin maintains the setting automatically
\nSafe to Remove: After configuration, you can remove the plugin if desired (setting will remain)<\/p>\n
# \ud83d\udd27 Technical Details<\/p>\n
Author: PoggerCity
\nVersion: 1.0.0
\nAPI Version: 1.21+
\nLoad Phase: STARTUP (loads early to modify config before other plugins)
\nDependencies: None (works standalone)<\/p>\n
# \ud83d\udc1b Troubleshooting
\n“paper-global.yml not found”<\/p>\n
Ensure you’re using Paper server, not Spigot\/Bukkit
\nStart your server at least once to generate config files<\/p>\n
Changes don’t take effect<\/p>\n
Restart your server after the plugin first runs
\nCheck console for success\/error messages<\/p>\n
Permission errors<\/p>\n
Ensure your server has write permissions to the config\/ folder<\/p>\n
# \ud83d\udcc4 License
\nThis plugin is provided as-is for server administration purposes. Feel free to use and modify for your server needs.<\/p>\n
Perfect for server owners who want hassle-free Paper configuration!<\/p>\n","protected":false},"excerpt":{"rendered":"
A simple plugin that enables shield stuns for you<\/p>\n","protected":false},"featured_media":138524,"template":"","meta":{"_minecraft_slug":"shield-stuns","_minecraft_project_id":"lgFOJ1HY","_minecraft_author":"Twizzlecranklehoot","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":2246,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"shield-stuns.zip","_minecraft_size_bytes":2826,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T06:03:39.869745Z","_minecraft_date_created":"2025-09-22T05:28:26.797990Z","_minecraft_date_modified":"2025-09-21T12:18:17.356919Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/shield-stuns","_minecraft_icon_attachment_id":138524,"_minecraft_imported_at":"2026-06-08T04:43:05+00:00","_minecraft_import_hash":"b658522b3fe96f386dfec688170b7e9e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,124,89,90,127,128,129],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,73,74,38,78,79,80,81],"class_list":["post-138523","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-bukkit","mod_category-game-mechanics","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\n