xtavim的BetterMap同伴清理与生命周期模组，带客户端事件上报、服务器中继和配置同步。

BetterMapCleanup 0.7.3

BetterMap 1.1.0 的配套模组。移除已禁用分类的标记，维护资源枯竭/重生状态与合并计数，并在已连接用户之间转发生命周期事件。

事件同步

客户端观察到实际资源变化后，应用其配置的划除/移除行为，并将状态上报至服务器。服务器将该状态分发给已注册的BetterMapCleanup客户端。接收方应用不会将同一事件发回。服务器端资源观察仍作为附加事件来源保留。资源状态快照/持久化在重新连接后仍然可用。

中继仅接受已注册的就绪对等节点、已知的资源/传送门预制体以及报告者256米范围内的有限位置，并有突发限制。它中继客户端的观测结果；这些并非成功采集的独立证明。服务器同步的设置决定接收方的资源操作。

传送门处理

BetterMap负责传送门删除。BetterMapCleanup不再修补WearNTear.Destroy，也不再运行自己的孤立传送门删除逻辑。之前两个传送门清理配置选项已停用，如果旧配置文件中仍存在它们，将被忽略。

原生BetterMap的PortalPins.Destroyed结果被观测后，经由客户端→服务器→已连接的Cleanup用户进行中继。接收方会以被移除传送门的只读描述来调用同一个原生BetterMap函数，即使其原始ZDO在本地不存在也是如此。不会生成任何世界对象。回放无法产生新的报告。

服务器会按世界持久化已接受的传送门移除操作，并在玩家重新连接或请求bmc同步时重放这些操作。追赶机制在服务器重启后仍然有效，并会分批处理。服务器在重放前会检查其传送门注册表中是否存在位于BetterMap删除半径内的替代项；接收方也会保护本地已知的替代项。待处理的传入事件会等待地图就绪。图钉的选择/移除遵循BetterMap自身的规则；Cleanup不会维护第二套传送门移除器。

安装

将服务器和每个参与的客户端上的BetterMapCleanup更新至0.7.3。协议5有意不与旧版Cleanup版本交换状态。客户端需要BetterMap 1.1.0或兼容的PortalPins.Destroyed API。专用服务器可以在没有BetterMap的情况下运行Cleanup，因为它只负责转发数据。

从源仓库运行：

.\build.ps1 -Install

使用 -瓦尔海姆路径 对于非标准安装，该脚本会在本地安装；请将生成的 DLL 单独复制到专用服务器的 BepInEx/plugins/BetterMapCleanup 文件夹，然后重启服务器。

配置与诊断

现有资源设置仍选择“划掉/移除”、耗尽阈值和重生恢复。烟雾团使用耗尽图钉动作。 BMC状态 显示协议5且客户端报告=已启用。 同步 请求当前资源状态和已记录的门户移除。 BMC 对账 这是一个显式的本地资源修复命令。未添加自动世界扫描。

验证

参见 TESTING.md。构建和替身逻辑测试已通过；实时多客户端行为仍需游戏测试。

传送门历史记录从0.7.0版本开始；从未上报至服务器的移除操作无法重建。请在更新时保留服务器配置目录（包括各世界专用的.portals文件）。历史记录不会自动过期。资源快照包含最新的已知枯竭/重生状态，而非重放过时的采集事件。

原生软组织支持（0.7.3）

软组织与巨型遗骸的发现/设置现已完全归BetterMap所有。BetterMapCleanup不再注入或覆盖这些规则。已废弃 别针/软组织 和 钉子/保留巨型遗骸 条目将被忽略；请改为配置 BetterMap 的原生选项。资源耗尽操作和同步继续使用 BetterMap 的原生规则。请在客户端和服务器上更新配套组件并重启，以丢弃上一进程中的任何规则覆盖。