ServerLogFilter-v1.2.0.mcdr

配置更新会告诉你，配置写坏会先帮你留一份

三处围绕配置文件的改进。对配置正常的人来说，插件行为不变——这一版可以放心升级。

1. 配置新增选项时会说明改了哪些

MCDR 本来就会把缺失的配置项按默认值补上并写回文件（你已有的取值不受影响）， 但整个过程是静默的。现在插件会主动说明：

==================================================================
[ServerLogFilter] 配置已更新：本次新增了 4 个配置项，已按默认值写入
  · warn_about_stale_rules  （v1.1.0 加入）
      某条规则连续多个开服周期零命中会提醒一次，便于清理失效规则。
  · stale_rule_threshold  （v1.1.0 加入）
      连续多少个开服周期零命中才提醒。设成 0 可关闭该提醒。
  ...
  配置文件：config/server_log_filter/config.json
==================================================================

2. 配置写坏时会先备份，再重建

在 patterns 里手工加规则时漏掉一个逗号是很容易犯的错。而 MCDR 的 regen 策略会 直接用默认值覆盖整个文件——你写的规则就此消失，控制台上只有 MCDR 自己一句简短的解析错误。

现在插件会在把文件交给 MCDR 之前先自己检查一遍：

==================================================================
[ServerLogFilter] 配置文件无法解析，已重置为默认配置
  · 出问题的文件：config/server_log_filter/config.json
  · 原文件已备份为：config/server_log_filter/config.json.old
  · 具体原因：JSON 语法错误：Expecting ',' delimiter: line 4 column 9 (char 83)
  · 新的 config.json 已用默认值生成。请对照备份文件把内容修正后填回，
    或用 !!logfilter reload 在修好后立即重新加载。
  常见原因：数组（patterns）里每个元素之间都要有英文逗号 ","，
            且最后一项后面不要留多余的逗号。
==================================================================

解析器给出的行号与列号直接指向出错位置，照着改就行；改好 !!logfilter reload 立即生效， 不用重启服务端。空文件、顶层不是 JSON 对象也按同样方式处理。 连备份都失败时（权限问题）插件照常加载并明确告知。

3. 零命中提醒不再逐条重复

原先每条空闲规则下面都跟着一模一样的一句「已连续 N 次开服零命中；自启用以来从未命中过」， 多条规则时这段话完全重复。次数已经写在标题里了，所以现在只列规则：

[ServerLogFilter] 注意：有 2 条过滤规则连续 3 次及以上开服都没有命中
  · standing on air - force-sending blocks below
  · test12345

只有当某条规则比阈值更久没命中时，才在它后面补一句 （已连续 9 次零命中）—— 那是标题里没有的信息。

文档

主 README 改为面向开服的人：插件干什么、安不安全、怎么装、怎么配、命令、加规则示例、 预期输出、排错表、环境要求。打包 / 测试 / 版本矩阵等开发内容移入 docs/DEVELOPMENT.md。

兼容性

最低 MCDR 版本要求没有变化，仍是 2.15.0。 在 2.15.0 / 2.15.7 / 2.16.0 上实测全部通过，逐项行为一致，零异常。

安装

下载下方的 ServerLogFilter-v1.2.0.mcdr，放进 MCDR 实例的 plugins/ 目录即可； 运行中的实例可用 !!MCDR reload plugin server_log_filter 热重载。 已有的配置文件不需要改动——新增的选项会自动补上并告知。

SHA256：1430736ee7c26496d50a07dd6cb30b6724bb25d33689cc5eb4a72f9e1acb39be

说明：.mcdr 是含时间戳的 zip，在不同检出目录重新打包会得到不同哈希（内容相同）。 上面是本资产的实测哈希。