ChatStack

ChatStack

找出哪个聊天模组正在屏蔽其他模组,并将聊天行交还给你想要的那个模组

实用

ChatStack

找出是哪个聊天模组屏蔽了其他模组——并把这行聊天还回去

在 Hytale 服务器上装两个聊天模组,有时两个都能用,有时只有一个能用。没有报错, 没有警告,日志里什么都没有——只是等级前缀突然不显示了,或者等级徽章不显示了, 而且无从得知是哪个模组抢占了聊天,也无从得知原因

ChatStack 就是为了杜绝这种情况而存在的


问题所在,精确描述

Hytale 只为每条聊天消息提供一个格式化器槽位:

public class PlayerChatEvent {
   private PlayerChatEvent.Formatter formatter;   // one slot
   public void setFormatter(Formatter f) { ... }  // last writer replaces
}

每个聊天模组都必须占用这个槽位才能完成自己的工作——而两个模组同时存在时会怎样, 完全取决于各自是如何编写的:

  • 一个模组如果捕获它找到的格式化器并调用它,则不会影响其他模组。两者都能显示
  • 一个模组如果忽略它,则会静默抹掉下面的一切。其中一个形同虚设

API 中没有任何机制能区分这两者。从外部看,一个正常工作的模组栈和一个损坏的模组栈看起来 一模一样:一个模组在最上层,而你无法看出它是否保留了其余的模组。已发布的 Hytale 聊天模组 有十多个,却无法知道哪两个能共存

ChatStack 的功能

1. 它告诉你谁在冲突,以及谁真正能把消息送达玩家

/chatstack status 会列出本次会话中所有占用聊天格式化器的模组,以它们的 jar 文件名标识,并说明每个模组是保留了它找到的格式化器,还是替换了它:

ChatStack  -  12 chat message(s) seen
[outermost] Azeys:PrefixesPlus   claimed 12, keeps what it found
[nested]    com.hytale:HyChat    claimed 12, replaces what it found
All 2 mods reach players: each one calls the formatter below it

而当其中一个模组吞掉了其他模组时,它会点名指出:

[outermost] SomeChatMod          claimed 12, replaces what it found
[nested]    Azeys:PrefixesPlus   claimed 12, never runs
Azeys:PrefixesPlus never reaches players: SomeChatMod discards the formatter
it finds instead of calling it
Use /chatstack owner Azeys:PrefixesPlus to give it the chat line instead.

这些信息今天在其他任何地方都不存在——不在日志里,不在游戏内

2. 它让你来做选择

/chatstack owner <mod> 决定哪个模组拥有聊天行,按服务器配置,可以在游戏内或配置文件中设置。 不再有“谁最后加载谁赢”。auto 会把它交还回去


它的工作原理,如实说明

ChatStack 在聊天分发的六个点上注册了相同的观察机制,因此一个在两个点之间占用槽位的模组会被 后一个点捕获。在每对占用之间,它留下一个标记,该标记渲染的内容与它下方格式化器渲染的内容 完全一致,并记录自己被调用过。一个标记被触达只意味着一件事——那个模组调用了它找到的 格式化器——而整个报告正是建立在这一事实之上

它不会向任何人的代码增加调用。 每个标记只委托一次,因此每个模组的格式化器运行的次数 与未安装 ChatStack 时完全相同。不会用测试输入调用任何东西;不会有任何东西被调用两次

它不会破坏聊天。 每个探针都有包装:故障只记录一次,并保持事件不变。 一个只做观察的模组没有理由让服务器的聊天随它一起崩溃

它唯一如实的局限: 两个模组如果在同样两个探针之间占用槽位,会被报告为一个,因为 它们之间没有运行任何 ChatStack 的东西。实际上,模组会按命名优先级注册,而探针正好位于 这些优先级处


安装

把 jar 放入 [GameFolder]/UserData/Mods/(单人游戏)或 [ServerFolder]/Mods/(专用 服务器)。就这些

一个 jar。没有依赖。没有早期插件,没有字节码修补,没有启动器替换。 ChatStack 只使用 Hytale 的公共插件 API

要求

Hytale 0.6.3 或更高版本。仅服务端——玩家无需安装任何东西

兼容性

ChatStack 不替换你的聊天模组,也不要求你替换。它位于它们之后并 进行报告。移除它,每个模组的行为与之前完全一致

它适用于在它之前发布的模组,也适用于在它之后发布、从未听说过它的模组


接下来

报告冲突是能够确定完成的那一半。另一半——合并两个模组的装饰到一行,使两者同时 显示——已经设计并制作了原型,将在无需任何猜测即可完成时发布。把一个格式化器拆解 意味着用测试输入调用另一个模组的代码,这不能随意或默认开启

如果你想要它,请在此页面说明:它会在列表中的优先级上升