ProtocolStringReplacer - Efficient message editor - ProtocolStringReplacer - 高效消息编辑器

💡ProtocolStringReplacer

ProtocolStringReplacer 是一款通过编辑数据包来实现字符串替换功能的插件。它致力于优化效率并提供更多实用功能。由于仅编辑发送给玩家的数据包，因此不会影响服务器端的正常处理。

💡前置需求与注意事项

• 必需依赖: ProtocolLib 4.4.0+ 与 NBTAPI。
• 可选依赖: PlaceHolderAPI 2.10.7+。
• 重要提示: 在 ReplacerConfig 配置中替换颜色时，请使用原版 Minecraft 的颜色字符 §，而非 Bukkit 常用的 &。
• 例如: 应使用 §3§l，而不是 &3&l。

🎮功能特性

核心功能

• 修复 Log4j 0day CVE 漏洞（适用于所有服务器）。
• 支持将 PLAYER_CHAT 数据包转换为 SYSTEM_CHAT 数据包，以确保在 1.19 版本中替换生效。（副作用：客户端将无法识别发送消息的玩家，例如无法通过聊天举报玩家）。
• 支持替换字符串，或直接屏蔽整个数据包！
• 使用 Aho-Corasick 算法 进行字符串替换，速度极快。
• 不会增加服务器的带宽压力，所有替换都在原始数据包上处理。
• 支持编辑 JSON，并对 JSON 进行智能处理，不会破坏消息中的任何额外内容（如悬停事件）。
• 完整的配置热加载与热卸载支持。
• 提供安全的占位符替换系统。
• 内置过滤器系统（可按客户端语言、权限等条件过滤）。

可编辑内容

• 编辑 1.19.0-1.19.2 的聊天预览组件。
• 编辑物品的完整 NBT、显示名称与描述。
• 编辑 Tab 补全字符串。
• 编辑战斗死亡（死亡界面）消息。
• 编辑踢出玩家的断开连接消息。
• 编辑书的内容与作者。
• 编辑 Boss 血条文本。
• 编辑告示牌的完整 NBT 及 4/8 行文本。
• 编辑记分板文本。
• 编辑控制台消息。
• 编辑标题消息。
• 编辑聊天消息。
• 编辑窗口标题文本。
• 编辑实体名称。

辅助与优化

• 提供 /psr capture 命令，方便您复制原始文本。
• 物品元数据缓存系统，处理窗口中的物品堆仅需 1 毫秒。
• 可在游戏内实时编辑替换规则和屏蔽项。
• 可创建多个替换器配置，提高可读性与管理性。

🔧命令列表

• /psr help - 列出所有命令。
• /psr edit - 在游戏内编辑替换器配置。
• /psr parse - 测试字符串替换效果。
• /psr capture - 捕获数据包中的内容。
• /psr reload - 重新加载替换器配置。

🔧权限节点

• protocolstringreplacer.command.edit - 允许使用编辑命令。
• protocolstringreplacer.command.parse - 允许使用解析测试命令。
• protocolstringreplacer.command.reload - 允许使用重载命令。
• protocolstringreplacer.command.capture - 允许使用捕获命令。
• protocolstringreplacer.feature.usermetacache - 在收到玩家数据包时恢复原始物品堆，以避免创造模式下的错误。
• protocolstringreplacer.feature.usermetacache.noncreative - 同上，但适用于其他游戏模式。通常用于避免其他插件引起的错误。

❓配置与支持

配置示例

替换器配置示例已内置在插件 Jar 文件中，首次运行插件时会自动创建。请查看生成的 Config.yml 和 Replacers\Example.yml 文件，其中的注释解释了几乎所有功能。

获取帮助

• 如需讨论或获取支持，请加入我们的 Discord 服务器。
• 如果遇到任何 Bug，请在 GitHub 上提交报告，请使用英文或中文描述。
• 请注意：请勿在 SpigotMC 的评论区发布问题，我很少查看那里，您将无法获得及时支持。

✨致谢

感谢所有参与 bStats 匿名数据收集的服务器。这为我的开发工作提供了极大的帮助，并给了我持续的动力。

---

广告：寻找能提升服务器体验的插件？试试我们的新插件：ESU。