# 🛡️ ShieldStuns
自动配置 Paper 服务器以获得最佳护盾机制
描述
ShieldStuns 是一个轻量级的实用插件，它会自动配置您的 Paper 服务器以启用 skip-vanilla-damage-tick-when-shield-blocked 设置。此插件无需手动编辑配置文件，即可确保您的服务器从启动之刻起就具有最佳的护盾阻挡行为。
# ✨ 功能
自动配置：在服务器启动时立即修改 paper-global.yml
零配置：无需任何设置 - 只需要将其放在 plugins 文件夹中
智能检测：仅在必要时修改设置
安全操作：创建方便备份的 YAML 输出，并采用正确的格式
详细日志记录：提供有关插件正在做什么的清晰控制台消息
抗错误：处理缺失的配置部分，并在需要时创建它们
# 🎯 它所做的事情
此插件会自动设置：
yamlcollisions:
skip-vanilla-damage-tick-when-shield-blocked: true
此配置更改会影响护盾阻挡与服务器中伤害时间之间的交互方式，从而为 PvP 和游戏玩法提供改进的护盾机制。
# 📋 要求
Paper 服务器 (1.19+) - 不适用于 Spigot/Bukkit
Java 17+
首次安装后服务器重启
# 🚀 安装
下载 ShieldStuns.jar
将其放在服务器的 plugins/ 文件夹中
启动您的服务器
重启您的服务器（Paper 应用配置更改所必需）
完成！插件将自动配置您的服务器
# 📊 用法
此插件完全自动运行：
首次启动：插件检测并修改 Paper 配置
后续启动：插件检查设置是否已正确
无命令：不需要任何玩家命令或权限
无 GUI：配置在后台静默进行
# 📝 控制台输出
如果一切正常，您将看到：
[ShieldStuns] ShieldStuns 插件正在启用...
[ShieldStuns] 成功修改 paper-global.yml！
[ShieldStuns] 成功启用 skip-vanilla-damage-tick-when-shield-blocked！
[ShieldStuns] 更改生效需要服务器重启！
[ShieldStuns] ShieldStuns 插件启用成功！
# ⚠️ 重要提示
仅限 Paper：此插件需要 Paper 服务器 - 它不能在 Spigot 或 Bukkit 上使用
需要重启：首次安装后，需要重启服务器才能使更改生效
一次性设置：配置完成后，插件会自动维护此设置
可以安全移除：配置完成后，您可以根据需要移除该插件（设置将保持不变）
# 🔧 技术细节
作者：PoggerCity
版本：1.0.0
API 版本：1.21+
加载阶段：STARTUP（早期加载以修改其他插件加载前的配置）
依赖项：无（独立运行）
# 🐛 故障排除
“找不到 paper-global.yml”
确保您使用的是 Paper 服务器，而不是 Spigot/Bukkit
至少启动一次您的服务器以生成配置文件
更改未生效
插件首次运行后重启您的服务器
检查控制台中的成功/错误消息
权限错误
确保您的服务器对 config/ 文件夹具有写入权限
# 📄 许可协议
此插件按原样提供，用于服务器管理目的。请随意使用和修改以满足您的服务器需求。
非常适合希望获得无忧 Paper 配置的服务器所有者！