[信息|管理]ProtocolStringReplacer——高效地修改各处显示的字符串[1.8-1.19] - 服务端插件

Rothes

本帖最后由 Rothes 于 2023-2-7 02:02 编辑

ProtocolStringReplacer

┃ 简介　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　

　ProtocolStringReplacer是一款通过修改网络数据包而实现替换字符串功能的插件，致力于优化效率、提供更多功能，以达到方便、实用的目标.
由于只修改了发送给玩家的数据包，故不会影响服务端上的处理.

┃ 特性　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　

更详细的列表请在 MCBBS v4 资源站中查看，此处列表不完整

修复服务端 Log4j 0day CVE 漏洞(全版本) [修复根源, 见截图] 独立版
修改以下内容中的字符串，或者屏蔽:

物品的完整NBT、DisplayName和Lore
成书的内容/署名
Boss血量条文本
任何控制台信息
告示牌信息
计分板信息
标题消息
聊天信息
窗口标题
实体名称

字符串替换采用 AC 算法! 十分迅速!
不会增加服务器的带宽压力! 所有替换均在原数据包上操作.
支持对控制台的信息管理! 每一个字符都可以替换或屏蔽!
支持修改 Json, 对 Json 的智能处理, 即使不了解 Json 也可使用普通替换模式, 不会破坏任何数据.
针对修改物品制作的缓存机制, 处理一个窗口内所有物品仅需1毫秒 (于~~i3-2120~~ + 已缓存情况下测试)
支持替换为PAPI变量, 且更安全, 可以在配置文件中设定占位符使用格式
游戏内的指令修改功能
以及现代化的指令结构
多个替换配置文件系统
有序化的字符串替换
完全的注释保留功能
完全支持热加载
过滤系统
计划内容:
更多游戏内指令修改功能
更多过滤功能
扩展更多信息等修改
制作维基
……

┃ 指令　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　

　/psr help
显示插件指令列表
　/psr edit
游戏内替换配置编辑器
　/psr parse
测试替换字符串
　/psr capture
捕获部分数据包的内容
　/psr reload
重载插件所有配置文件

详细的指令帮助请在游戏内输入子指令+ help 如/psr edit help

┃ 权限　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　

　protocolstringreplacer.command.edit
允许使用替换配置编辑器
　protocolstringreplacer.command.parse
允许使用替换字符串测试功能
　protocolstringreplacer.command.reload
允许重载插件配置文件
　protocolstringreplacer.command.capture
允许捕获数据包的内容
　protocolstringreplacer.feature.usermetacache
为创造模式恢复修改前的原物品 (防止创造模式替换到实际物品的特性)
　protocolstringreplacer.feature.usermetacache.noncreative
为非创造模式玩家也提供该功能 (用于一些奇怪的特殊情况, 若遇到无法移动物品等问题时尝试给予该权限)

┃ 截图　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　

┃ 配置文件　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　

注意：替换配置文件必须放于plugins/ProtocolStringReplacer/Replacers文件夹或其子文件夹中

此处的配置文件将在第一次启动插件后自动生成

Config.yml

# 请勿手动修改Configs-Version值!
Configs-Version: 6
Options:
# 本地语言. 将在 ProtocolStringReplacer/Locales 中寻找对应 yml 文件.
# 此设定也涉及一些内部操作, 建议按照规范语言缩写(小写)-地区缩写(大写) 来填写.
Locale: zh-CN
# 设置检测更新服务器的域名. 默认为 'raw.githubusercontent.com'.
# 若连接不上此加速线路, 应自行选择其它加速线路.
Git-Raw-Host: 'raw.fastgit.org'
# 设置 PSR 加载配置的时期. 可选 INIT (最早), LOAD (中), ENABLE (最晚, 默认值).
# 主要用于控制台消息的修改.
Config-Load-LifeCycle: 'ENABLE'
# PSR 会显示多少次由 ProtocolLib 导致的报错? 设置为 0 为永久禁止.
ProtocolLib-Side-Stack-Print-Count: 3
Features:
# 控制台相关设定.
Console:
# 在控制台内显示加载的替换配置文件.
Print-Replacer-Config-When-Loaded: true
# 自定义插件占位符的使用格式. 建议使用玩家想不到的格式
# 以防止玩家通过占位符获取到不该获取的信息.
# 在默认值下, 使用如｛player_name｝的格式来获取占位符的变量.
Placeholder:
# 使用占位符的前缀. 仅允许一个字符.
Placeholder-Head: ｛
# 使用占位符的后缀. 仅允许一个字符.
Placeholder-Tail: ｝
# 是否为显示在控制台的文本解析占位符.
Parse-For-Console: true
# 关于已替换物品缓存表的相关设定.
ItemMetaCache:
# 每多少秒执行一次清理缓存的任务.
Purge-Task-Interval: 600
# 只清理多少秒未读取过的缓存条目.
Purge-Access-Interval: 300
# 在与村民/流浪商人交易时移除物品上的NBT缓存
# 以解决部分小故障.
Remove-Cache-When-Merchant-Trade: false
# 关于网络数据包监听器的相关设定.
Packet-Listener:
# 定义 ProtocolStringReplacer 监听数据包全局优先度.
# 如果与其他发包插件产生冲突, 请修改该值.
Listener-Priority: HIGHEST
# 是否强行修改不允许修改的数据包.
Force-Replace: false
# 设定启用哪些类型的监听. 若某种类型中的文本不需要修改, 可设为 false 以优化性能.
Listen-Type-Enabled:
Boss-Bar: true
Chat: true
Chat-Preview: true
Combat-Kill: true
Entity: true
ItemStack: true
Kick-Disconnect: true
ScoreBoard: true
Sign: true
Tab-Complete: true
Title: true
Window-Title: true
# 聊天数据包的相关设定.
Chat-Packet:
# 仅适用于 1.19+ . 必须启用此功能 PSR 才能处理玩家发送的消息.
# 启用后, PSR 会转换所有 PLAYER_CHAT 数据包为 SYSTEM_CHAT,
# 以解决服务端/客户端开启“仅显示安全的聊天”后消息无法显示的问题.
# 注意: 这会影响到客户端对玩家聊天的检测. 例如, 您将无法通过聊天来举报其他玩家.
Convert-Player-Chat: true
# 有关替换模式优化的相关设定.
Replace-Mode:
# 在直观(Direct)替换模式成功替换后, 跳过对这个数据包所有的处理.
Skip-When-Direct-Replaced: true

复制代码

示例替换配置 (Example.yml)

# 此替换配置文件的相关设定.
Options:
# 是否开启本替换配置. 若为false则不会为这个文件处理. 若未定义, 默认为false.
Enabled: true
# 本文件的优先级. 若有多个替换配置, 优先级高的最早替换. 默认为5.
Priority: 5
# 可选参数
Version: '1.230201'
# 可选参数
Author: 'Rothes'
# 匹配字符串的方式. 可选值:
# 'Contain' : 只要包含就替换 (默认)
# 'Equal' : 要求设置与原字符串完全匹配
# 'Regex' : 使用Java正则表达式
# 不区分大小写.
Match-Mode: 'Contain'
# 筛选功能. 用于指定此文件替换字符串的条件.
Filter:
# 监听类型.
# 指定替换何处的字符串. 默认为全部. 可选值:
# 'Chat' : 替换聊天(chat|actionbar)信息文本
# 'Chat-Preview' : 替换聊天预览(Chat Preview)中的文本
# 'Tab-Complete' : 替换 Tab Complete 中的文本
# 'Sign' : 替换告示牌文本
# 'Title' : 替换标题(title|subtitle)文本
# 'Entity' : 替换实体名文本
# 'Boss-Bar' : 替换Boss血量条文本
# 'ItemStack' : 替换物品(物品名|Lore|书署名|书内容)文本
# 'Window-Title' : 替换容器标题文本
# 'ScoreBoard' : 替换计分板(标题|实体名称)
# 'Console' : 替换控制台内显示的文本信息
# 'Kick-Disconnect' : 替换踢出玩家时客户端上的踢出消息
# 'Combat-Kill' : 替换玩家重生界面上的死亡信息
# 不区分大小写.
Listen-Types:
- Chat
- Window-Title
- ItemStack
- Sign
# 针对计分板监听的特定过滤
ScoreBoard:
# 是否处理计分板标题. 默认为false.
Handle-Title: false
# 是否处理计分板中的实体名称. 默认为false.
# 注: 对于玩家, 实体名称为玩家名称; 对于非玩家则为UUID.
Handle-Entity-Name: false
# 是否处理计分板中的团队显示名称. 默认为false.
Handle-Team-Display-Name: false
# 是否处理计分板中的团队显示前缀. 默认为false.
Handle-Team-Prefix: false
# 是否处理计分板中的团队显示后缀. 默认为false.
Handle-Team-Suffix: false
# 针对物品监听的特定过滤
ItemStack:
# 仅 Json. 是否处理物品的完整 nbt. 默认为false.
Handle-Nbt-Compound: false
# 仅 Json. 是否处理物品的 Display nbt 组件. 默认为false.
Handle-Nbt-Display-Compound: false
# 是否处理物品的 Display nbt 组件中的各个元素. 默认为true.
Handle-Nbt-Display-Entries: true
User:
# 处理所需权限. 若设定, 用户必须拥有该权限
# 才能使该替换配置为其生效.
Permission: 'example.permission.1'
# 所需客户端语言. 只会为在下面列出的客户端语言处理.
# 设为空列表或者移除以跳过语言检查.
# 语言列表: https://minecraft.fandom.com/wiki/Language#Languages
Locales:
- en_us # English (US)
- en_gb # English (UK)
- zh_cn # 简体中文（中国大陆）
- zh_hk # 繁體中文（香港特別行政區）
- zh_tw # 繁體中文（台灣）
- lzh # 文言（華夏）
# PSR 将忽略长度超过此处定义值的字符串(但不是整个数据包)处理.
# 设为 -1 以禁用此功能.
Max-Length:
# 常规文本. (或者 Common)
Text: -1
# Json.
Json: -1
# Direct. 直观替换模式.
Direct: -1
# 替换的字符串列表.
# 替换模式优先度: Direct > Json > Common, 忽略文件优先度.
Replaces:
# 常规文本替换模式.
# 常规替换模式中的每个条目根据 Json 中的不同格式分割.
# 使用常规模式的一大好处就是它不会破坏组件中的格式.
Common:
- Original: '我的名字'
Replacement: '｛player_name｝'
- Original: '一个命名牌'
Replacement: '我的命名牌'
- Original: '这样来换行'
Replacement: |-
这样
来换行
# Json 替换模式, 适合高级用户.
# 不支持使用 Json 替换的监听类型有:
# ItemStack(版本1.12及以上书内容除外)、控制台消息,
# 以及计分板中的实体名称、版本1.12及以下的计分板标题.
Json:
# 修改客户端上熔炉界面标题显示的名称.
- Original: '{"translate":"container.furnace"}'
Replacement: '{"text":"恭喜您打开了一个熔炉! 666!"}'
# 直观替换模式. 适合不熟悉 Json 替换的用户.
# 默认情况下, 若直观模式替换过任何内容, Json 和常规文本替换模式
# 将不再对该数据包生效. 您可以在 Config.yml 中调整此设定.
# 除 Json 外, 这也是支持 1.16+ HEX 的替换模式.
# 注意: 如果直观替换模式替换过文本, 它将破坏 Json 中的非文本组件显示效果.
# ^ 这意味着替换后(如果有的话)会产生消息会无法点击，
# ^ 移除鼠标悬停信息、翻译效果等副作用.
Direct:
- Original: '§f<§f§4Rothes§f> §f我正在聊天'
Replacement: '§7* Rothes 正在聊天'
# 屏蔽的字符串列表. 如果一个数据包中的任何字符串被匹配,
# 这个数据包将整个被屏蔽发送给玩家.
# 此功能同样适用于控制台消息.
Blocks:
Common:
- '这条消息会被屏蔽'
- '这条同样也会'
Json:
- '{"text":"这条json会被屏蔽"}'
# 空列表.
Direct: []

复制代码

┃ 下载链接　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　

GitHub: https://github.com/Rothes/ProtocolStringReplacer

请在 MCBBS v4 资源站中下载插件, 此贴内附件不是最新版本:

https://beta.mcbbs.net/resource/servermod/xmkw2tv1

喜欢的话欢迎评论，别让这帖子沉啦

请安装前置插件

ProtocolLib 4.7.0+(Spigot 1.18 需 4.8.0+版本)

PlaceholderAPI 2.10.9+

请使用Java8+运行本插件

建议使用 Paper 或其分支服务端以获得最佳兼容性和效果

PSR 3.0.0 开发中! 3.0.0 将完全重写, 提供更多自定义项、提供一些 API, 并且模块化项目以便于适配其它平台，同时还会进一步优化插件

(目前预计适配 BungeeCord)，许可证切换为 LGPL

PSR 2.0.0 将可无损升级至 3.0.0

┃ 示例配置　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　

用法: 安装本插件后，解压并替换(合并)

plugins/ProtocolStringReplacer/Replacers

粘液科技本体汉化.zip (29.45 KB, 下载次数: 468)

使用时请将 Slimefun 默认语言设为简体中文，适配1.14+全粘液版本

敏感词屏蔽.zip (634 Bytes, 下载次数: 297)

客户端 Log4j Jndi 屏蔽.zip (726 Bytes, 下载次数: 144)

示例配置最后更新于2023/02/07

基于 PSR v2.17.1

┃ 更新日志　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　

版本更新日志已移至 MCBBS v4 资源站:

https://beta.mcbbs.net/resource/servermod/xmkw2tv1/releases

2.6.5 2022-02-23:

- 修复在一些服务端上会错误地移除控制台中的Ansi色彩码的问题.

2.6.4 2022-02-15:

- 修复在旧版本服务端上执行 /psr capture list 会发生 NoSushMethodError 的问题.

2.6.3 2022-02-15:

- 支持 1.17-1.18 的 Boss-Bar 修改.

2.6.2 2022-02-13:

- 修复因为 CommentYamlConfiguration 在新版本更改后未设定 SplitLines, 导致配置文件因注释保留而损坏的问题.

2.6.1 2022-02-13:

- 添加限制 ProtocolLib 导致的报错的显示次数的配置项.

2.6.0 2022-02-13:

- 修复缓存清理 Schedule 时间单位错误问题, 可能导致内存泄漏.

- 新增更新玩家库存时清理用户缓存, 降低内存占用.

- 修复用户缓存系统不正常工作的问题.

- 改进 ProtocolLib 报错的屏蔽措施.

- 内部代码修改.

2.5.2 2022-02-06:

- 修复 TemporaryPlayer 的相关问题.

2.5.1 2022-02-06:

- 修复一些 ItemHoverEvent 消息导致的 NPE 报错.

- 修复在 Spigot 1.8 中的 BossBar 警告信息.

- 支持 1.17-1.18 ActionBar 消息的修改.

- 修复 Console 监听类型在替换配置关闭时仍然处理的问题.

2.5.0 2022-01-16:

- 优化内存占用.

- 重新编写控制台信息替换, 现在可以对每一个字符进行替换、屏蔽, 且支持 1.8-1.18 全版本!

2.4.0 2022-01-02:

- 适配 Spigot 近期在 1.18.1 做出的一些更改.
- 适配一些 Forge/Fabric 服务端做出的一些更改.

- 适配 NachoSpigot 1.8 服务端做出的一些更改.

- 改进 Console 替换方式, 自适配选择最优挂钩方式.
- 修复某些情况 /psr edit 不可修改 Replaces 和 Blocks 的问题.

2.3.3 2021-12-13:

- 修复 1.18 以上版本因 log4j JDNI 修复导致的 NPE.

2.3.2 2021-12-13:

- 新增修复服务端 Log4j 0day CVE 漏洞(1.8-1.18)

- 修复更新检查器小错误.

2.3.1 2021-12-05:

- 修复在 Airplane 核心或者其他的一些核心上的 NPE 导致无法加载的问题.

- 更新检测器信息默认使用 UTF-8 编码.

- 改进更新检测提醒功能.

2.3.0 2021-12-04:

- 升级至 Spigot 1.18 版本.

- 修复多处潜在的 NPE 错误, 提升插件兼容性.

- 改进插件 Logger 前缀修改实现方式.

- 重写更新检测提醒功能.

- 修复一些服务端的 Gui 控制台仍显示 Ansi 转义符的问题.

2.2.1 2021-12-02:

- 重写更新检测机制.

- 检查 MapChunk 包中是否包含所需修改的键.

1.18 适配预计在周末发布, 以便于进行测试.

2.2.0 2021-12-01:

- 重命名多个类名以符合代码规范.

- 保存原始 MessageFactory 以防止在一些服务端上关闭插件时出现错误, 提升插件兼容性.
- 通过 Log4j2 插件注册表获取 LoggerNamePatternSelector 以防止在一些服务端上由于类迁移导致插件无法初始化, 提升插件兼容性.

- 优化插件, 降低内存占用.

1.18 适配预计在周末发布, 以便于进行测试.

2.1.2.1 2021-11-14:

- 修复一些控制台消息导致的 NPE.

2.1.2 2021-11-14:

- 修复由旧版本 Log4j2 内 Bug 导致的异常. (只在旧版本服务端发生)

2.1.1 2021-11-13:

- 新增 Options.Git-Raw-Host 配置项, 可以自行选择更新服务器的加速线路.

2.1.0 2021-11-13:

- 改进 1.12 及以上版本的 Console 替换方式: 现在可以为所欲为修改所有文本, 并且日志文件内不再显示 Ansi 码, 更干净.

- Config.yml 添加是否为 Console 解析占位符的选项.

2.0.5 2021-11-08:

- 改进用户目前窗口标题方法.

- 更正拼写错误.

维基正在编写中. 点击此处预览.

2.0.4 2021-10-23:

- 更换依赖 'commons-lang3' 至 'commons-lang'.

- 降低插件 jar 文件大小.

- 重命名 Config.yml 中的 'Localization' 为 'Locale'

- 添加替换配置过滤: User.Permission

2.0.3 2021-10-18:

- 修复捕获功能报错.

- 修正英文语言.

2.0.2 2021-10-16:

- 重构 User 包路径.

- 重制 Capture 功能系统, 现可捕获除 Console 外所有字符串.

- 优化 ItemStack 处理.

- 修复控制台信息的 NPE 报错.

2.0.1 2021-10-02:

- 修复无法加载的问题.

2.0.0 2021-10-01:

- 核心代码重写.

- 大幅重构重复代码.
- 迁移、更新依赖库.
- 使用 Logger 打印控制台信息.
- 新增多语言系统.
- 新增修改控制台信息.
- 新增屏蔽数据包/屏蔽消息.
- 新增版本更新检查.
- 修复指令TAB不会合并引号的bug.
- 修复一些潜在的错误.
- 移除了不必要的一些消息.
- 优化编辑器使用体验, 显示彩色符号.
- 优化 Equal 匹配模式效率.
- 略微提高插件总体效率.
- 配置文件架构修改(自动从旧版本升级).
- 防止保存 Yml 时自动换行.
- 改进注释保留系统.

1.5.5 2021-08-23:

- 修复一些报错.

- 部分重构.

1.5.4 2021-08-22:

- 修复部分Chat Json捕获不到的问题.

1.5.3 2021-08-22:

- 支持捕获数据包内容. (目前只支持Json)

- 防止因为替换配置文件中正则错误导致整个插件无法加载.

1.5.2 2021-08-19:

- 修复上个版本的NPE报错.

1.5.1 2021-08-18:

- 再次针对 Contain 匹配模式进行优化, 现采用 AC 算法, 再次提升 50%~85% 效率.

- 不再支持同一替换配置中的累加替换(A->B, B->A).

- 不再处理空字符串.

1.5.0 2021-08-17:

- 针对 Contain 匹配模式进行优化, 字符串越长越明显, 提升 50%~75% 效率.

- 优化编辑器相关处理效率.

1.4.16 2021-08-15:

- 修复1.12-1.15处理HoverEvent报错的问题.
- 修复EntityMeta报错的问题.

1.4.15 2021-08-11:

- 修复添加缺失配置项不是默认以UTF-8编码添加的问题.
- 修复reload指令不能重载监听优先级的问题.

- UserCache 部分重构.

- 修复了上个版本新增的N/A个虫.

1.4.14 2021-08-11:

- 新增了N/A个虫.

1.4.13 2021-08-09:

- 迁移依赖库, 避免和其它插件冲突.

1.4.12 2021-08-06:

- 修复错误.

1.4.11 2021-08-05:

- 代码重构.

- 新增支持修改计分板信息.

- 新增支持强制修改只读数据包.

- 修复自动添加缺失配置的一些注释处理问题.

1.4.10 2021-08-03:

- 新增支持 Java 8 - Java 10 使用.

1.4.9 2021-07-31:

- 修复了一些玄学问题.

- 检测 ENTITY_META 是否为 NULL.

- 调整 Paper 服务端检测机制.

1.4.8 2021-07-31:

- 允许自定义数据包监听优先级.

- 新增 Listen-Dropped-Item-Entity 配置, 用于临时解决在 1.17 或更高版本服务器上因 ProtocolLib 而导致的一个问题.
- 新增自检测配置文件是否缺失项目.

- 新增防止修改只读数据包.

1.4.7 2021-07-30:

- 优化 Json/Component 修改效率.

- 优化占位符处理效率.
- 完善对 BookMeta 中 Json 的修改.

- 修复另外的一些小问题.

1.4.6 2021-07-29:

- 完善了Json/Component修改功能.
- 重新支持了Json修改. 请参考Example.yml.

- 修复了一些问题.

1.4.5 2021-07-29:

- 修复ItemContent展示头颅导致的警告信息.
- 修复EntityMeta修改的报错.

1.4.4.1 2021-07-28:

- 修复手快导致的一个问题.

1.4.4 2021-07-28:

- 修复v1.4.2更新导致的不兼容旧版本服务端的问题.
- 新增自适配修改物品展示框中物品功能.

- 迁移替换配置文件中Replaces到Replaces.Common,

以便于之后的更新. (安装新版本后自动更新)

1.4.3 2021-07-27:

- 修复检测不到前置启用的玄学问题.
- 支持修改物品展示框中物品的displayname和lore.

1.4.2 2021-07-27:

- 支持修改TextComponent原有的文本颜色.
- 支持修改Component的HoverEvent文本.

1.4.1 2021-07-18:

- 统一替换配置文件中的大小写.
- 替换配置文件中匹配类型、监听类型不再大小写严格.
- 修复Print-Replacer-Config-When-Loaded配置不生效的问题.
- 使用纳秒计时, 更精确.

- 忽略ENTITY_METADATA数据包报错.

1.4.0 2021-07-17:

- 修复entity监听可能会修改实际实体的问题.

- 重构包名, 代码规范.

1.3.4 2021-07-16:

- 优化Chat数据包的处理.

- 优化对json信息修改的处理.

(近期较忙, 暂未添加任何内容, 深表歉意.)

1.3.3 2021-07-14:

- 支持修改TranslatableComponent中的附加文本.

1.3.2 2021-07-14:

- 修复上个版本导致的一个问题.

1.3.1 2021-07-14:

- 修复Chat数据包因json格式问题导致的报错.

1.3.0 2021-07-04:

- 大幅重构插件.

- 过滤器Packet-Types更改为Listeners-Types，以方便适配版本以及更换版本.

- 完全支持了1.8-1.10版本.(1.7也可能支持, 没有测试)

- 更改配置文件的架构(安装新版本插件后自动更新).

- 新增parse指令，用于测试设置的替换配置文件是否生效并了解字符串替换的流程.

- 修复了一些已知的报错和问题.

1.2.1 2021-06-29:

- 修复1.11及以下版本控制台不可使用指令的问题.

1.2.0 2021-06-29:

- 兼容了1.11-1.12服务端.

- 对低于1.13的服务端采用lore的方式存储usercache.

- 修复使用替换配置编辑器创建的替换配置版本不为2的问题.

- 修复使用替换项编辑器set子指令不检测重复key的问题.

- 更新示例配置文件.

1.1.20 2021-06-27:

- 检测负数EntityId，防止报错.

1.1.19 2021-06-26:

- 修复Spigot端ChatComponent无法修改的问题.

- 支持修改Paper端在 1.17+ 新增的Component.

- 修复升级替换配置文件后出现两个TITLE监听的问题.

- 修复窗口使用"translate"仍会替换,导致标题变为英文的问题.

- 检测服务端，若不是Spigot或其衍生服务端(如Bukkit)将强行关闭插件.

- 改进设定数据包是否替换字符串的实现方式.

1.1.18 2021-06-25:

- 修复一些服务端版本上玩家执行指令抛出NPE的问题.

- 在plugin.yml中补充了Edit指令的权限节点.

- 优化替换项目列表浏览.

1.1.17 2021-06-24:

- 完整的注释保留功能.

- 增加游戏内指令编辑器.

- 修改了替换配置文件架构. (安装新版插件后会强制自动更新)

- 一些细微的优化.

1.1.16 2021-06-20:

- 修复正则匹配模式无法使用问题.

- 一些我自己都忘记做了啥的重构.

1.1.15 2021-06-20:

- 引入bStats.

1.1.14 2021-06-18:

- 完善注释保留类系统(尚仅支持Key-Value式数据).

- 修复了已知的一些问题.

1.1.13 2021-06-16:

- 完全支持1.17.

- 移除了beta标签.

1.1.12-beta 2021-06-15:

- 兼容1.17.

- 优化指令引号参数合并方法.

- 修复未加载玩家数据时修改包，可能抛出NPE的问题.

- 使用Java11.

1.1.11-beta 2021-06-14:

- 新增支持监听BOSS_BAR数据包.

1.1.10-beta 2021-06-14:

- 修复TITLE数据包抛出NPE的问题.

1.1.9-beta 2021-06-14:

- 新增支持监听TITLE(标题消息)数据包.

1.1.8-beta 2021-06-13:

- 新增支持监听MAP_CHUNK数据包.

1.1.7-beta 2021-06-13:

- 支持重载指令.

- 花里胡哨的彩色符号

1.1.6-beta 2021-06-13:

- 支持修改"书与笔"/ "成书"的内容和署名.

- 优化占位符处理机制

1.1.5-beta 2021-06-13:

- 支持修改告示牌信息

- 支持在控制台内显示加载的替换配置文件

- 调整Config.yml架构

1.1.4-beta 2021-06-12:

- 支持占位符替换

- 允许配置缓存清理设定

1.1.3-beta 2021-06-12:

- 上传至MCBBS插件板块

- 正式开源

- 小修小补

1.1.2-beta 2021-6-11:

- 非正则支持切换全匹配或非全匹配

- 修复创造模式修改物品问题

- 对ItemStack提供缓存机制

- 支持修改生物名称

1.1.1-beta 2021-6-5:

- 支持切换正则与非正则替换模式

- 支持过滤部分条件，以优化效率

- 修复窗口标题修改错误问题

- 优化'.'符号加载策略

1.1.0-beta 2021-5-23:

- 插件重构

- 优化插件，效率比之前高三~四倍

- 修复聊天消息报错

2021-5-16:

- 优化插件

- 支持修改'.'字符

2021-5-2:

- 在https://www.mcbbs.net/thread-827594-1-1.html处发布插件

┃ 问题反馈　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　

如果您在使用插件过程中遇到任何问题，欢迎在GitHub issue tracker上反馈。
有任何需要咨询的，可在贴内回复或私信，我每日都会检查MCBBS, 或直接在 QQ 上进行咨询:
空巢插件交流群: 422532220 机器人秒速审核, 如果没秒速就是炸了
插件维基编写中: https://rothes.gitbook.io/protocolstringreplacer/

┃ 常见问题　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　

1. PAPI占位符无法替换
PSR 默认的占位符格式为｛占位符｝(全角字符), 而不是 %占位符% . 这是为了服务器安全性, 防止玩家通过发送占位符来获取服务器信息. 同时, 可以使 PSR 自动检测字符串中是否包含占位符, 若无则不会调用 PAPI API, 这可以大大加快替换效率. 您可以在插件的 Config.yml 中调整此设定.
2. 有时无法替换生物的名称
这是由 ProtocolLib 的问题导致. 该问题不在 PSR 可以处理的范围之内, 且不仅仅只影响到了 PSR 插件的处理. 目前 PSR 已将该报错屏蔽.
3. 插件导致服务器大幅卡顿
PSR 已经对插件进行了很极致的优化, 且所有运行的进程皆异步进行. 若您遇到此问题, 通常这是由于一些插件在主线程上进行了有关的网络处理, 而 PSR 扩大了此行为对主线程的影响. 请手动排除您的服务端插件.
4. 无法使用色彩符号
由于一些原因, PSR 使用 Minecraft 原版提供的色彩符号 '§' 而不是 Bukkit 中常用的色彩符号 '&'. 请尝试将您的替换配置中的所有色彩符号替换为 '§'.
5. 无法加载插件: Invalid plugin.yml
由于 MCBBS 附件下载常出问题, 通过备用链接(SpigotMC)下载即可.

本插件目前基于GNU GPLv3协议开源

所用部分代码使用Apache等开源项目，其余皆为原创

来自群组: PluginsCDTribe

kiano66

感觉不错，很实用

HaPi_r

优化效率就很不错感谢分享（希望能常更新. 支持

小张up

本帖最后由小张up 于 2021-6-13 11:44 编辑

[11:36:31 INFO]: [ProtocolStringReplacer] Enabling ProtocolStringReplacer v1.1.5-beta
[11:36:31 ERROR]: Error occurred while enabling ProtocolStringReplacer v1.1.5-beta (Is it up to date?)
java.lang.NoClassDefFoundError: me/clip/placeholderapi/replacer/Replacer
      at me.Rothes.ProtocolStringReplacer.ProtocolStringReplacer.initialize(ProtocolStringReplacer.java:77) ~[?:?]
      at me.Rothes.ProtocolStringReplacer.ProtocolStringReplacer.onEnable(ProtocolStringReplacer.java:41) ~[?:?]
      at org.bukkit.plugin.java.JavaPlugin.setEnabled(JavaPlugin.java:263) ~[patched_1.16.5.jar:git-Paper-762]
      at org.bukkit.plugin.java.JavaPluginLoader.enablePlugin(JavaPluginLoader.java:370) ~[patched_1.16.5.jar:git-Paper-762]
      at org.bukkit.plugin.SimplePluginManager.enablePlugin(SimplePluginManager.java:500) ~[patched_1.16.5.jar:git-Paper-762]
      at com.rylinaux.plugman.util.PluginUtil.load(PluginUtil.java:366) ~[?:?]
      at com.rylinaux.plugman.util.PluginUtil.load(PluginUtil.java:318) ~[?:?]
      at com.rylinaux.plugman.util.PluginUtil.reload(PluginUtil.java:380) ~[?:?]
      at com.rylinaux.plugman.command.ReloadCommand.execute(ReloadCommand.java:122) ~[?:?]
      at com.rylinaux.plugman.PlugManCommandHandler.onCommand(PlugManCommandHandler.java:95) ~[?:?]
      at org.bukkit.command.PluginCommand.execute(PluginCommand.java:45) ~[patched_1.16.5.jar:git-Paper-762]
      at org.bukkit.command.SimpleCommandMap.dispatch(SimpleCommandMap.java:159) ~[patched_1.16.5.jar:git-Paper-762]
      at org.bukkit.craftbukkit.v1_16_R3.CraftServer.dispatchCommand(CraftServer.java:826) ~[patched_1.16.5.jar:git-Paper-762]
      at org.bukkit.craftbukkit.v1_16_R3.CraftServer.dispatchServerCommand(CraftServer.java:788) ~[patched_1.16.5.jar:git-Paper-762]
      at net.minecraft.server.v1_16_R3.DedicatedServer.handleCommandQueue(DedicatedServer.java:470) ~[patched_1.16.5.jar:git-Paper-762]
      at net.minecraft.server.v1_16_R3.DedicatedServer.b(DedicatedServer.java:437) ~[patched_1.16.5.jar:git-Paper-762]
      at net.minecraft.server.v1_16_R3.MinecraftServer.a(MinecraftServer.java:1342) ~[patched_1.16.5.jar:git-Paper-762]
      at net.minecraft.server.v1_16_R3.MinecraftServer.w(MinecraftServer.java:1130) ~[patched_1.16.5.jar:git-Paper-762]
      at net.minecraft.server.v1_16_R3.MinecraftServer.lambda$a$0(MinecraftServer.java:291) ~[patched_1.16.5.jar:git-Paper-762]
      at java.lang.Thread.run(Thread.java:834) [?:?]
Caused by: java.lang.ClassNotFoundException: me.clip.placeholderapi.replacer.Replacer
      at org.bukkit.plugin.java.PluginClassLoader.loadClass0(PluginClassLoader.java:153) ~[patched_1.16.5.jar:git-Paper-762]
      at org.bukkit.plugin.java.PluginClassLoader.loadClass(PluginClassLoader.java:114) ~[patched_1.16.5.jar:git-Paper-762]
      at java.lang.ClassLoader.loadClass(ClassLoader.java:521) ~[?:?]
      ... 20 more

[11:38:07 INFO]: [PlugMan] Plugin Information: ProtocolLib
[11:38:07 INFO]: - Version: 4.6.1-SNAPSHOT-b501
[11:38:07 INFO]: - Author(s): dmulloy2, comphenix
[11:38:07 INFO]: - Status: Enabled
[11:38:58 INFO]: [PlugMan] Plugin Information: PlaceholderAPI
[11:38:58 INFO]: - Version: 2.10.4
[11:38:58 INFO]: - Author(s): extended_clip, Glare
[11:38:58 INFO]: - Status: Enabled

看了看你的maven构建脚本，我的Papi貌似过时了

Rothes

小张up 发表于 2021-6-13 11:37
[11:36:31 INFO]: Enabling ProtocolStringReplacer v1.1.5-beta
[11:36:31 ERROR]: Error occurred while ...

PlaceholderAPI不是最新的，试试更新到
PlaceholderAPI-2.10.9

小张up

Rothes 发表于 2021-6-13 11:42
PlaceholderAPI不是最新的，试试更新到
PlaceholderAPI-2.10.9

嗯，刚刚看到了

LINKCHUM

好像挺不错的，不过会不会跟tr菜单冲突呢

Rothes

LINKCHUM 发表于 2021-6-13 16:49
好像挺不错的，不过会不会跟tr菜单冲突呢

应该不会。而且提供了过滤功能，如果字符串有冲突，也可以通过调整配置文件自行修复

Rothes

本帖最后由 Rothes 于 2021-6-16 19:48 编辑

已兼容1.17，请安装1.17的专用ProtocolLib (来自官方预览版)
https://ci.dmulloy2.net/job/ProtocolLib/lastSuccessfulBuild/
目前ProtocolLib还有一些问题，如监听包错误，我只提供了兼容，这代表1.17可能部分功能失效。
这不是我的问题，请大家等待ProtocolLib方支持.
由于不知道ProtocolLib何时才能完全提供向后支持，新版已提供完全适配功能。

26880

我在1.17里面使用psr打示例的''我的名字''没有输出变量,不晓得是啥问题

小张up

本帖最后由小张up 于 2021-6-20 21:23 编辑

# 是否开启本替换配置. 若为false则不会为这个文件处理. 若未定义, 默认为false.
Enable: true
# 本文件的优先级. 若有多个替换配置, 优先级高的最早替换. 默认为5.
Priority: 30
# 匹配字符串的方式. 可选值:
# 'contain' : 只要包含就替换 (默认)
# 'equal' : 要求设置与原字符串完全匹配
# 'regex' : 使用正则表达式
Match-Type: 'regex'
# 筛选功能. 用于指定此文件替换字符串的条件.
Filter:
# 指定替换的数据包类型. 默认为全部. 可选值:
# WINDOW_ITEMS 监听打开窗口中的物品
# SET_SLOT 监听窗口中槽位的物品
# OPEN_WINDOW 监听窗口的标题文本
# CHAT 监听聊天文本
# ENTITY_METADATA 监听实体名称
# TILE_ENTITY_DATA 监听tile的nbt数据. 目前仅支持修改告示牌信息
Packet-Types:
- CHAT
Replaces:
# 左侧的key为原字符串右侧的value为替换后的字符串.
'me' : '我'
'/(?<=\[123\] .*)\[123\] /g' : ''

复制代码

我的配置文件是这样的，但为什么正则语句没用
在正则测试器中这个句子没问题

但在这个插件里却无效

是最新版
而且，使用插件后，容器都变英文了

Rothes

本帖最后由 Rothes 于 2021-6-20 22:38 编辑

小张up 发表于 2021-6-20 21:11
我的配置文件是这样的，但为什么正则语句没用
在正则测试器中这个句子没问题

现在json和chat组件的修改不是很完善。可能容器用的是translate，但是插件也解析了。等我完善之后应该就好。容器的问题，就麻烦暂时先手动修改一下OPEN_WINDOW数据包吧。
正则的问题我待会看看

Rothes

26880 发表于 2021-6-20 17:05
我在1.17里面使用psr打示例的''我的名字''没有输出变量,不晓得是啥问题

我没有把这个添加进示例配置文件。你需要手动添加
'我的名字': '｛player_name｝'

小张up

Rothes 发表于 2021-6-20 22:37
现在json和chat组件的修改不是很完善。可能容器用的是translate，但是插件也解析了。等我完善之后应该就好 ...

好，这么晚还在查阅消息辛苦了
加油

Rothes

小张up 发表于 2021-6-20 22:42
好，这么晚还在查阅消息辛苦了
加油

这几天我重构了一部分代码，之前没有上传这一部分。我待会上传新版插件，貌似已修复正则问题

26880

Rothes 发表于 2021-6-20 22:37
我没有把这个添加进示例配置文件。你需要手动添加
'我的名字': '｛player_name｝' ...

啊这，但是我这里直接放进plugins后生成的文件有示例一样的文件，单纯的替换也有效果，但是变量就拉了跨了

Rothes

26880 发表于 2021-6-21 10:51
啊这，但是我这里直接放进plugins后生成的文件有示例一样的文件，单纯的替换也有效果，但是变量就拉了跨 ...

检查一下PlaceholderAPI是否下载了Player变量。使用/papi ecloud download player

26880

Rothes 发表于 2021-6-21 12:34
检查一下PlaceholderAPI是否下载了Player变量。使用/papi ecloud download player

哦草,问题解决是我的锅,我还以为这个变量是papi自带的,浏览一圈变量网站被翻译器生草翻译骗过去了

3401286177

不兼容Loliserver呀，可惜了

Rothes

3401286177 发表于 2021-6-25 11:33
不兼容Loliserver呀，可惜了

检查了一下，看起来主要是前置ProtocolLib不支持。

Rothes

小张up 发表于 2021-6-20 21:11
我的配置文件是这样的，但为什么正则语句没用
在正则测试器中这个句子没问题

容器变为英文的问题已经修复，抱歉拖得有点久啦

小张up

本帖最后由小张up 于 2021-6-26 18:51 编辑

Rothes 发表于 2021-6-26 16:09
容器变为英文的问题已经修复，抱歉拖得有点久啦

没事，插件已经非常优秀了
(另外我那个正则咋样改才能编译过）

Meload

非常不错的插件，支持下

Rothes

小张up 发表于 2021-6-26 18:45
没事，插件已经非常优秀了
(另外我那个正则咋样改才能编译过）

谢谢，这个正则你是想要实现什么啊？

小张up

Rothes 发表于 2021-6-26 20:51
谢谢，这个正则你是想要实现什么啊？

匹配一句话中除去第一个"[123] "之外的所有"[123] "

虽说匹配器里能使用，但匹配器也提示

有没有可能是Java不支持本特性造成的

Rothes

本帖最后由 Rothes 于 2021-6-27 10:52 编辑

小张up 发表于 2021-6-27 09:50
匹配一句话中除去第一个"[123] "之外的所有"[123] "

试试
'(?<=\[123\])(.*?)\[123\]': '$1'

814823670

可以拿走了兄弟

凉凉の咸鱼

本帖最后由凉凉の咸鱼于 2021-6-27 14:21 编辑

玩家进服务器的时候报此类错误
Paper-1.17 build 49
ProtocolLib-4.7.0 build 524

[ProtocolStringReplacer] Unhandled exception occured in onPacketSending(PacketEvent) for ProtocolStringReplacer
java.lang.IllegalArgumentException: entityID cannot be negative
at org.apache.commons.lang.Validate.isTrue(Validate.java:136) ~[patched_1.17.jar:git-Paper-49]
at com.comphenix.protocol.injector.EntityUtilities.getEntityFromID(EntityUtilities.java:218) ~[?:?]
at com.comphenix.protocol.injector.PacketFilterManager.getEntityFromID(PacketFilterManager.java:851) ~[?:?]
at com.comphenix.protocol.wrappers.BukkitConverters$10.getSpecific(BukkitConverters.java:691) ~[?:?]
at com.comphenix.protocol.wrappers.BukkitConverters$10.getSpecific(BukkitConverters.java:676) ~[?:?]
at com.comphenix.protocol.reflect.StructureModifier.readInternal(StructureModifier.java:229) ~[?:?]
at com.comphenix.protocol.reflect.StructureModifier.read(StructureModifier.java:197) ~[?:?]
at me.Rothes.ProtocolStringReplacer.PacketListeners.Server.EntityMetadata$1.onPacketSending(EntityMetadata.java:22) ~[?:?]
at com.comphenix.protocol.injector.SortedPacketListenerList.invokeSendingListener(SortedPacketListenerList.java:195) ~[?:?]
at com.comphenix.protocol.injector.SortedPacketListenerList.invokePacketSending(SortedPacketListenerList.java:149) ~[?:?]
at com.comphenix.protocol.injector.PacketFilterManager.handlePacket(PacketFilterManager.java:535) ~[?:?]
at com.comphenix.protocol.injector.PacketFilterManager.invokePacketSending(PacketFilterManager.java:516) ~[?:?]
at com.comphenix.protocol.injector.netty.ProtocolInjector.packetQueued(ProtocolInjector.java:346) ~[?:?]
at com.comphenix.protocol.injector.netty.ProtocolInjector.onPacketSending(ProtocolInjector.java:308) ~[?:?]
at com.comphenix.protocol.injector.netty.ChannelInjector.processSending(ChannelInjector.java:433) ~[?:?]
at com.comphenix.protocol.injector.netty.ChannelInjector.access$800(ChannelInjector.java:70) ~[?:?]
at com.comphenix.protocol.injector.netty.ChannelInjector$3.handleScheduled(ChannelInjector.java:373) ~[?:?]
at com.comphenix.protocol.injector.netty.ChannelInjector$3.onMessageScheduled(ChannelInjector.java:343) ~[?:?]
at com.comphenix.protocol.injector.netty.ChannelProxy$2.schedulingRunnable(ChannelProxy.java:127) ~[?:?]
at com.comphenix.protocol.injector.netty.EventLoopProxy.execute(EventLoopProxy.java:95) ~[?:?]
at net.minecraft.network.Connection.sendPacket(Connection.java:294) ~[?:?]
at net.minecraft.network.Connection.processQueue(Connection.java:373) ~[?:?]
at net.minecraft.network.Connection.flushQueue(Connection.java:346) ~[?:?]
at net.minecraft.network.Connection.send(Connection.java:277) ~[?:?]
at net.minecraft.server.network.ServerGamePacketListenerImpl.send(ServerGamePacketListenerImpl.java:1920) ~[?:?]
at net.minecraft.server.network.ServerGamePacketListenerImpl.send(ServerGamePacketListenerImpl.java:1906) ~[?:?]
at net.minecraft.server.level.ChunkMap$TrackedEntity.broadcast(ChunkMap.java:2327) ~[?:?]
at net.minecraft.server.level.ServerEntity.sendChanges(ServerEntity.java:204) ~[?:?]
at net.minecraft.server.level.ChunkMap.processTrackQueue(ChunkMap.java:2051) ~[patched_1.17.jar:git-Paper-49]
at net.minecraft.server.level.ChunkMap.tick(ChunkMap.java:2062) ~[patched_1.17.jar:git-Paper-49]
at net.minecraft.server.level.ServerChunkCache.tickChunks(ServerChunkCache.java:874) ~[?:?]
at net.minecraft.server.level.ServerChunkCache.tick(ServerChunkCache.java:753) ~[?:?]
at net.minecraft.server.level.ServerLevel.tick(ServerLevel.java:581) ~[?:?]
at net.minecraft.server.MinecraftServer.tickChildren(MinecraftServer.java:1551) ~[patched_1.17.jar:git-Paper-49]
at net.minecraft.server.dedicated.DedicatedServer.tickChildren(DedicatedServer.java:477) ~[patched_1.17.jar:git-Paper-49]
at net.minecraft.server.MinecraftServer.tickServer(MinecraftServer.java:1404) ~[patched_1.17.jar:git-Paper-49]
at net.minecraft.server.MinecraftServer.runServer(MinecraftServer.java:1180) ~[patched_1.17.jar:git-Paper-49]
at net.minecraft.server.MinecraftServer.lambda$spin$0(MinecraftServer.java:320) ~[patched_1.17.jar:git-Paper-49]
at java.lang.Thread.run(Thread.java:831) [?:?]
[14:15:19 ERROR]: Parameters:
net.minecraft.network.protocol.game.PacketPlayOutEntityMetadata@25c1b56e[
a=-6
b=[net.minecraft.network.syncher.DataWatcher$Item@57635385]
]

复制代码

Rothes

本帖最后由 Rothes 于 2021-6-27 18:32 编辑

凉凉の咸鱼发表于 2021-6-27 14:16
玩家进服务器的时候报此类错误
Paper-1.17 build 49
ProtocolLib-4.7.0 build 524

这个貌似是Protocollib的问题，我之前就看到有人反馈了
可以发一下完整的插件列表看看
新版已添加一个检测防止问题，按照源码，Protocollib就应该返回Null的，但是它没有这么做

凉凉の咸鱼

Rothes 发表于 2021-6-27 18:14
这个貌似是Protocollib的问题，我之前就看到有人反馈了
可以发一下完整的插件列表看看
新版已添加 ...

还是有这错误, 不过问题也不是太大用 ConsoleSpamFix 干掉了..

Plugins (28):
Boom,
Chunkmaster,
CMI,
CMIEInjector,
CMILib,
ConsoleSpamFix,
CoreProtect,
DeluxeMenus,
eBackup,
FartherViewDistance,
JulyLibrary,
JulySafe,
LockettePro,
LuckPerms,
Moeka,
momojs,
MultiLogin,
Multiverse-Core,
PlaceholderAPI,
ProtocolLib,
ProtocolStringReplacer,
QuickShop,
QuickShopList,
Residence,
Shift_Menu,
TAB,
Vault,
ZccAfk

复制代码

Rothes

凉凉の咸鱼发表于 2021-6-27 19:08
还是有这错误, 不过问题也不是太大用 ConsoleSpamFix 干掉了..

还是有那就只能等ProtocolLib修掉了...我这边无从下手

DongShaoNB

您好，服务器中已经安装papi但是您的插件先加载导致检测不到papi了，这咋办

Rothes

本帖最后由 Rothes 于 2021-7-1 12:35 编辑

DongShaoNB 发表于 2021-7-1 07:18
您好，服务器中已经安装papi但是您的插件先加载导致检测不到papi了，这咋办 ...

这个问题不应该发生，应该是因服务端版本而异
如果确实是这样的话，请手动使用压缩软件打开插件jar中的plugin.yml
把softdepend改成depend
请说明服务端版本，我之后会研究

DongShaoNB

Rothes 发表于 2021-7-1 12:34
这个问题不应该发生，应该是因服务端版本而异
如果确实是这样的话，请手动使用压缩软件打开插件jar中的plu ...

paper-1.17-55

下一页最后一页