WALink

WALink

一个将游戏内文字聊天与WhatsApp群聊连接起来的模组。

管理

WALink

实验性的 Minecraft 模组,将游戏内文字聊天与 WhatsApp 群聊连接起来,同时不会占用你普通 Chrome 标签页的内存。 (我提到内存占用的原因是,其他一些 WhatsApp 自动化实现确实会打开一个 Chrome 标签页!)

可能会出现错误、崩溃和卡死,这仍处于实验阶段。(大部分情况只是我没有实现足够的错误处理,所以 99% 的情况下如果出了问题,任何事情都可能发生,而不是简单地重启或通知你。)

大多数问题应该已经消失,但始终存在出错的微小可能性。最好的首选修复方法大概就是直接重启 walink。

网络短暂中断后应该会重新连接,但不保证有效。有时需要手动重启。

免责声明

我不鼓励使用软件篡改自己的 WhatsApp 账户。这仅用于实验和概念验证目的。

使用本软件的风险

现实中?相当低。虽然我不支持使用此模组,因为在你账户上使用自动化软件违反 WhatsApp 的服务条款,但该政策很可能只是为了阻止大规模诈骗操作。只要你只在和朋友们一起玩的小型服务器上使用它,账户被终止的真实风险极低。此外,我无法百分百确信地说这一点,但我相信 baileys 库很好地模拟了 WhatsApp Web 协议,在没有人工审查的情况下不会自动触发任何重大危险信号。

另外需要注意,这当然会降低你 WhatsApp 群聊的安全性。虽然它通常是端到端加密的,但这将它连接到了非端到端加密的 Minecraft 服务器,因此从技术上讲更容易被黑客攻击。此外,消息会被存储在服务器日志中,你可能想删除旧日志。另外,该模组会创建自己的日志,其中可能包含敏感信息。你可以通过命令删除这些日志,详见下文。

安装 / 设置

安装 Node.js 以及 npm(重要!)并确保它在你系统的 PATH 中(在下载页面上,你只需下载适用于你系统的预构建安装程序/二进制文件即可)。将模组的 .jar 放入你的 fabric 模组文件夹。启动游戏/服务器。启动后,运行 /walink chat_name NAME 来配置你想要连接的群聊名称(必须是群聊)(必须与群聊名称完全匹配)。运行 /walink auth,等待二维码出现。用手机扫描该二维码以将 WALink 与你的 WhatsApp 账户关联。运行 /walink restart 以完全启动后端并让 WALink 正常工作。

已知问题

很少发生的情况是,在启动 WALink 时,它尝试同步旧聊天,多次显示“0 percent”,然后卡住并且永远不再继续(等待大约一分钟以百分百确定它卡住了)。这很可能是 WALink 使用的底层库的问题,唯一的修复方法是取消 WALink 的认证并重新认证。

也可能在认证或启动时卡住,这种情况下只需停止并重试该过程。

一个修复方法始终是直接停止 minecraft,删除整个 walink-data 文件夹,然后重试。它有时会遇到无法解释的问题。调试它们简直是噩梦,因为你永远不知道是库、我自己的代码还是其他完全不同的东西的问题,而当我尝试复现该问题时,它却完全消失了。

配置

目标群聊可以通过命令设置(见上文和下文)。其余配置可以通过配置文件(config/walink.json)编辑。要应用对配置的手动更改,你需要先完全关闭服务器!否则,它会在退出时覆盖配置。

卸载

直接移除模组即可。可选地,你可能想删除 walink-data 文件夹,因为它只是 WALink 留下的文件,其中可能也包含敏感信息。在此之前,你还可以在游戏中先运行 /walink deauth 以省去一些麻烦。

命令

在 Minecraft 中:

  • /walink help:获取关于这些命令的简短帮助信息。
  • /walink auth:将 WALink 与你的 WhatsApp 账户进行认证。通常只需在首次运行时执行,除非需要重新认证。在你的 WhatsApp 应用中,WALink 将显示为“Google Chrome (Windows)”,因为底层库模仿了 WhatsApp Web 实例。
  • /walink deauth:取消 WALink 与你的 WhatsApp 账户的认证。需要在 WALink 运行时才能在 WhatsApp 应用中解除关联,否则它会保留在应用中(真的是个僵尸。WALink 下次会要求新的认证)。在出现认证/登录相关问题时很有用。
  • /walink vanish on/off:[未实现] 允许你的消息不出现在 WhatsApp 群聊中。
  • /walink stop:停止 WALink。可以用 /restart 重新启动。
  • /walink restart:重启 WALink 的 Node.js 后端以解决可能的问题和卡死,或者如果之前未启动过则直接启动它。
  • /walink chat_name:设置目标群聊名称。警告:它必须是唯一的群聊名称,且必须完全匹配。如果存在两个同名群聊,消息最终会进入哪个群聊基本上就是碰运气。
  • /walink clear_logs:清除旧日志(当前运行的日志除外)。

在 WhatsApp 中:

  • .mc help:获取关于这些命令的简短帮助信息。
  • .mc vanish on/off:[未实现] 允许你的消息不出现在 Minecraft 文字聊天中
  • .mc players:显示当前服务器上的玩家列表。/walink vanish 无法防止出现在此列表中。

技术细节

需要安装 Node.js 和 npm。它捆绑了一个 node 程序以及 baileys,以实现与 WhatsApp 的轻量级通信而无需大量资源占用。

支持的版本

从 1.21.10 开始的任何版本,我会尽量在最新版本发布后尽快更新。

更旧的版本可能受支持,你可能需要编辑模组存档内的 fabric.mod.json。不过我对此不保证任何东西。

可能会推出对重要旧版本的向后移植(实际上就是用改变了一个值的方式重新构建模组,看看是否一切正常,99% 的情况下应该都正常)。

如果你想要特定版本的模组,请在 GitHub 上开一个 issue。我会尝试针对那个特定的游戏版本重新编译并测试。