MateSignal非官方版 · 我的世界Mod

.detail-panel[hidden] { display: block !important; } .detail-tabs { display: none; } /* These three panels are rendered by the browser. */ [data-versions], [data-changelog-panel], [data-comments] { display: none; }

MateSignal Unofficial

这是 Shiny 的 MateSignal 的非官方移植版。 原版仅支持 Minecraft 1.21.10；此移植版新增了对 1.20.1、1.21.1 和 1.12.2 的支持。该模组的所有内容——事件集、通信协议、与 MateEngine 的交互——均来自原版。我仅负责平台适配，如果你游玩的是 1.21.10，请使用他们的版本。

MateSignal 是一个客户端 Minecraft 模组，用于在游戏和 MateEngine（一款 3D 桌面虚拟形象应用）之间搭建桥梁。它会监听游戏内事件，并通过本地 UDP 套接字将它们上报给 MateEngine，后者会在你的桌面虚拟形象上以对话气泡的形式显示对应的消息。

该模组仅限客户端使用。在服务器上安装不会产生任何效果，服务器也不需要安装它。

本项目与 MateEngine 项目或原作者无关联，也未获得其认可。概念、设计以及 MateEngine 集成的所有功劳均归他们所有。

支持的版本

Minecraft	加载器	Java	文件
1.20.1	Forge 47.x	17	`matesignal-forge-1.20.1-1.1.0.jar`
1.21.1	NeoForge 21.1.x	21	`matesignal-neoforge-1.21.1-1.1.0.jar`
1.12.2	Forge 14.23.5.2860	8	`matesignal-forge-1.12.2-1.1.0.jar`

下载与你的 Minecraft 版本相匹配的文件。这三个构建版本会发出完全相同的事件集，并且可以连接到同一个 MateEngine 实例。

功能

以下事件会产生虚拟形象消息：

破晓与夜幕降临
附近有敌对生物
生命值或饥饿值过低
溺水
死亡
开始下雨
上床睡觉
合成物品
进食
击杀生物
首次发现某个生物群系

共 13 个事件。

实体和生物群系名称会遵循 Minecraft 中所选的语言，因为它们是通过游戏自身的语言管理器解析的。

安装

安装与你 Minecraft 版本相匹配的加载器（Forge 或 NeoForge）
将对应的 jar 文件放入你的 .minecraft/mods 文件夹
启动 MateEngine
启动游戏

配置

在 1.20.1 和 1.21.1 上，可以在游戏内通过 模组 → MateSignal → 配置 访问设置，或直接编辑 config/matesignal-client.toml。在 1.12.2 上，文件为 config/matesignal.cfg。

可用选项：

生物检测半径
接近事件所使用的生物白名单
上述每个事件的独立开关

模组 id 为 matesignal，因此配置文件与原版模组兼容，你在两者之间切换时设置会保留。

命令

命令	描述
`/matesignal test all`	依次发出全部 13 个事件，每秒一个
`/matesignal test <event>`	发出单个事件；支持前缀匹配
`/matesignal list`	列出所有事件名称
`/matesignal reload`	重新加载生物群系名称覆盖表（仅限 1.12.2）

要检查模组和 MateEngine 是否正在通信，请运行 /matesignal test all。一连串气泡意味着连接正常。你不需要进入世界——主菜单即可。

如果没有反应

确保 MateEngine 正在运行。 模组只会向 localhost 发送数据；如果没有程序在监听，就不会有任何显示。
确保 UDP 端口 32145 未被屏蔽。 模组会向 127.0.0.1:32145 发送 UDP 数据报。
使用 /matesignal test all 手动触发一个事件。 出现气泡意味着连接正常，问题出在事件检测上；没有气泡意味着连接本身已中断。
检查 logs/latest.log。 模组加载失败会在那里留下错误信息。

使用警告

请勿在公共或竞技服务器上使用此模组。 虚拟形象会报告附近敌对生物等信息，这在某些服务器的规则下属于作弊行为。仅限单人游戏或与朋友的私人服务器使用。

与原版的差异

原版在事件名称 drowning_half 下发送溺水消息，而 MateEngine 无法识别该名称，因此该消息从未显示。此移植版修复了该问题，同时还修复了时间跳跃时误触发夜幕降临、实体和生物群系名称以未翻译的 id 形式发送，以及 1.12.2 上生物群系名称无法翻译的问题。

截图

截图 1

截图 2

截图 3

源码与许可证

完整源代码：https://github.com/LilyBlack0321/Mate-Signal-Unofficial

在 MateEngine Pro License v2.0 下分发——这是一份自定义许可证，而非标准的开源许可证。简而言之：此模组免费，源码公开，原作者已署名，且不声称自己是官方版本。无广告，无付费内容。

致谢：

原版模组和 MateEngine —— Shiny（Johnson Jason）
- https://github.com/shinyflvre/Mate-Signal
- https://github.com/shinyflvre/Mate-Engine
Fabric 移植版，用作参考 —— VeridonNetzwerk
- https://github.com/VeridonNetzwerk/Mate-Signal-Fabric