?️ SMP Fixes
Paper 和 Purpur SMP 服务器的必备辅助插件。
修复损坏的原版机制,让你的玩家获得应有的体验。
❓ 问题所在
如果你运行的是 Paper 或 Purpur 服务器,并且启用了 skip-vanilla-damage-tick-when-shield-blocked: true 以启用眩晕(Stun)机制——你可能已经注意到有些东西坏了:
? 护盾格挡的音效完全消失了。
玩家用护盾格挡攻击时,却听不到……任何声音。没有令人满意的叮当声,也没有反馈。这感觉不对劲,破坏了沉浸感。
SMP Fixes 恢复了缺失的护盾格挡与护盾破碎音效,禁用聊天举报,启用属性交换让你永远冲刺,以及更多……
✨ 功能特性
? 护盾音效恢复
- 自动检测你的
paper-global.yml / paper.yml / purpur.yml 设置
- 在格挡攻击时恢复
ITEM_SHIELD_BLOCK 音效
- 无缝处理斧头击破护盾的情况 —— 防止重复播放破碎音效,同时保留原版音频
- 精确的 180° 角度计算 —— 仅当护盾实际格挡伤害时才播放音效
- 支持所有可格挡的伤害类型:近战、横扫、投射物、爆炸和荆棘
? 更好的末影珍珠
- 当末影珍珠击中或穿过任何目标玩家(射击者除外)或任何生物时,它保证发生碰撞。
- 将射击者直接传送至目标实体内部。
⚡ 玩家延迟补偿 (/settings)
- 玩家可以通过
/settings(或 /settings <pearl|windcharge|potion> [on|off])单独切换延迟补偿功能。
- 支持的项目:
- 玩家设置会被保存并在重启后持久化。
⚙️ 游戏内配置管理
不再需要翻找配置文件!SMP Fixes 允许你通过直接在游戏中的命令切换关键服务器设置:
| 命令 |
作用 |
/settings |
打开简单的个人延迟补偿设置 GUI |
/smpfixes reload |
重新加载插件配置 + 执行 purpur reload 和 paper reload |
/smpfixes attribute-swap <true|false> |
切换 Paper 配置中的 update-equipment-on-player-actions(逻辑取反) |
/smpfixes shield-stuns <true|false> |
切换 Paper 配置中的 skip-vanilla-damage-tick-when-shield-blocked |
/smpfixes no-chat-report <true|false> |
切换 server.properties 中的 enforce-secure-profile(逻辑取反) |
/smpfixes projectile-offset-zero <true|false> |
将 purpur.yml 中所有投射物的偏移量设置为 0.0(末影珍珠、旋风棒、弓等) |
/smpfixes offline-mode <true|false> |
切换 server.properties 中的 online-mode(逻辑取反) |
? 智能自动检测
- 自动扫描
config/paper-global.yml、paper.yml 和 purpur.yml
- 仅在需要时激活护盾音效修复
- 无需手动设置 —— 只需放入并运行!
? 安装
- 从发布页面下载最新的
.jar 文件
- 将其放入服务器的
plugins/ 文件夹
- 重启服务器
- 完成! 插件会自动检测你的设置并在需要时激活
? 配置
插件会生成一个 config.yml,其中包含完全可自定义的选项:
# 自动检测 Paper/Purpur 设置(推荐)
auto-detect-paper-setting: true
# 即使未检测到 Paper 设置也强制启用
force-enable: false
# 启用调试日志
debug: false
# 功能开关
no-chat-report: true
attribute-swap: true
shield-stuns: true
zero-projectile-offset: true
# 护盾格挡音效设置
sound:
enabled: true
type: "ITEM_SHIELD_BLOCK"
category: "PLAYERS"
volume: 1.0
pitch-min: 0.8
pitch-max: 1.2
# 斧头击破护盾音效设置
shield-break-sound:
enabled: false
type: "ITEM_SHIELD_BREAK"
category: "PLAYERS"
volume: 1.0
pitch-min: 0.8
pitch-max: 1.2
? 权限
| 权限节点 |
描述 |
默认值 |
smpfixes.admin |
访问所有 SMP Fixes 管理员命令 |
OP |
smpfixes.settings |
允许玩家管理个人延迟补偿偏好 |
所有人 |
? 要求
- 服务器: Paper, Purpur, 或任何基于 Paper 的分叉版本
- Minecraft: 1.21+
- Java: 21+
? 支持与社区
有问题、发现了 Bug,或有功能建议?
加入我们的 Discord 服务器获取支持、更新以及其他更多信息
?️ SMP Fixes
The essential companion plugin for Paper & Purpur SMP servers.
Fixes broken vanilla mechanics so your players get the experience they deserve.
❓ The Problem
If you run a Paper or Purpur server and you've enabled skip-vanilla-damage-tick-when-shield-blocked: true to enable the Stun mechanic — you've probably noticed something is broken:
? The shield block sound is completely gone.
Players block an attack with their shield, but hear... nothing. No satisfying clang, no feedback. It feels wrong and breaks immersion.
SMP Fixes restores the missing shield block & shield break sounds, Disables the chat reports, Enables the Attribute Swap so you Lunge forever and more...
✨ Features
? Shield Sound Restoration
- Automatically detects your
paper-global.yml / paper.yml / purpur.yml settings
- Restores
ITEM_SHIELD_BLOCK sound when blocking attacks
- Seamless axe shield disable handling — prevents duplicate break sounds while preserving vanilla audio
- Accurate 180° angle calculation — sounds only play when the shield actually blocks the hit
- Supports all blockable damage types: melee, sweep, projectile, explosions, and thorns
? Better Ender Pearls
- When an Ender Pearl hits or passes through any target player (except the shooter) or any mob, it guarantees collision.
- Teleports the shooter directly inside the target entity.
⚡ Player Ping Compensation (/settings)
- Players can individually toggle ping compensation via
/settings (or /settings <pearl|windcharge|potion> [on|off]).
- Supported items:
- Ender Pearls
- Wind Charges
- Potions (Splash & Lingering)
- Player settings are stored and persist across restarts.
⚙️ In-Game Config Management
No more digging through config files! SMP Fixes lets you toggle critical server settings directly from in-game commands:
| Command |
What it does |
/settings |
Opens the simple personal ping compensation settings GUI |
/smpfixes reload |
Reloads the plugin config + runs purpur reload & paper reload |
/smpfixes attribute-swap <true|false> |
Toggles update-equipment-on-player-actions in Paper config (inverse logic) |
/smpfixes shield-stuns <true|false> |
Toggles skip-vanilla-damage-tick-when-shield-blocked in Paper config |
/smpfixes no-chat-report <true|false> |
Toggles enforce-secure-profile in server.properties (inverse logic) |
/smpfixes projectile-offset-zero <true|false> |
Sets all projectile offsets in purpur.yml to 0.0 (ender-pearl, wind-charge, bow, etc.) |
/smpfixes offline-mode <true|false> |
Toggles online-mode in server.properties (inverse logic) |
? Smart Auto-Detection
- Automatically scans
config/paper-global.yml, paper.yml, and purpur.yml
- Activates the shield sound fix only when needed
- No manual setup required — just drop and go!
? Installation
- Download the latest
.jar from the releases
- Drop it into your server's
plugins/ folder
- Restart your server
- Done! The plugin auto-detects your settings and activates if needed
? Configuration
The plugin generates a config.yml with fully customizable options:
# Auto-detect Paper/Purpur settings (recommended)
auto-detect-paper-setting: true
# Force enable even if paper setting isn't detected
force-enable: false
# Enable debug logging
debug: false
# Feature Toggles
no-chat-report: true
attribute-swap: true
shield-stuns: true
zero-projectile-offset: true
# Shield block sound settings
sound:
enabled: true
type: "ITEM_SHIELD_BLOCK"
category: "PLAYERS"
volume: 1.0
pitch-min: 0.8
pitch-max: 1.2
# Axe shield break sound settings
shield-break-sound:
enabled: false
type: "ITEM_SHIELD_BREAK"
category: "PLAYERS"
volume: 1.0
pitch-min: 0.8
pitch-max: 1.2
? Permissions
| Permission |
Description |
Default |
smpfixes.admin |
Access to all SMP Fixes admin commands |
OP |
smpfixes.settings |
Allows players to manage personal ping compensation preferences |
Everyone |
? Requirements
- Server: Paper, Purpur, or any Paper-based fork
- Minecraft: 1.21+
- Java: 21+
? Support & Community
Have a question, found a bug, or want to suggest a feature?
Join our Discord server for support, updates, and for more info
评论 0
登录后参与评分
还没有评论,来抢沙发吧