EnderTrax

.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; }

一个 NeoForge 模组，适用于 Minecraft 1.21.1，将你的专用服务器与 MineTrax 网页套件集成。它会实时向你的 MineTrax 面板报告服务器和玩家统计数据，并打开一个双向命令通道，使网页面板能够与你的服务器交互。

功能

服务器情报 — 定期向 MineTrax 报告 TPS、内存、CPU、运行时间、磁盘空间、加载的区块以及每个维度的世界数据。
玩家会话追踪 — 追踪游戏时间、AFK 时间、死亡、击杀、挖掘/放置的方块、使用/合成/拾取的物品、跳跃次数、PvP 伤害等 — 全部拆分为间隔计数器和累积计数器。
死亡与 PvP 报告 — 每当玩家死亡或发生 PvP 击杀时，立即向 MineTrax 发送报告，包括位置、伤害来源、武器以及涉及的玩家。
聊天转发 — 实时将游戏内聊天消息中继到 MineTrax 面板。
账户关联 — 玩家可以在游戏内运行 /link <otp> 命令，将其 Minecraft 账户关联到 MineTrax 网页资料。
WebQuery 服务器 — 一个轻量级的 TCP 套接字桥接器，允许 MineTrax 网页面板向你的服务器推送命令（广播消息、运行控制台命令、检查玩家状态等）。

要求

Minecraft 1.21.1 (NeoForge 服务器)
NeoForge 21.1.222 或兼容版本
Java 21
一个正在运行的 MineTrax 网页套件实例

安装

下载或构建模组 jar 文件。
将其放入 NeoForge 服务器的 mods/ 文件夹。
启动服务器一次，生成位于 config/endertrax-common.toml 的配置文件。
停止服务器，填写配置（见下文），然后重新启动服务器。

配置

配置文件位于 config/endertrax-common.toml，并在首次运行时自动生成。

必需设置

Key	Description
`apiHost`	MineTrax 网站的完整 URL，例如 `https://your-website.com`
`apiKey`	来自 MineTrax 服务器设置页面的 API 密钥
`apiSecret`	来自 MineTrax 服务器设置页面的 API 密钥
`serverId`	来自 MineTrax 服务器设置页面的服务器 ID

在设置所有四项并将 enabled = true 之前，模组不会报告任何内容。

完整配置参考

Key	Default	Description
`enabled`	`true`	主开关 — 设置为 `false` 以禁用所有报告
`apiHost`	`""`	MineTrax 网站 URL
`apiKey`	`""`	API 密钥
`apiSecret`	`""`	API 密秘钥
`serverId`	`""`	服务器 ID
`webqueryHost`	`0.0.0.0`	WebQuery 监听器的主机/IP
`webqueryPort`	`25569`	WebQuery 监听器端口
`enableServerIntel`	`true`	切换定期服务器统计数据报告
`enablePlayerIntel`	`true`	切换玩家会话追踪
`enableChatReporting`	`true`	切换聊天消息转发
`serverIntelIntervalSeconds`	`60`	报告服务器统计数据的频率 (10–3600 秒)
`playerIntelIntervalSeconds`	`300`	刷新玩家会话数据的频率 (30–3600 秒)

配置示例

[general]
    enabled = true
    apiHost = "https://your-website.com"
    apiKey = "your-api-key-here"
    apiSecret = "your-api-secret-here"
    serverId = "1"

    webqueryHost = "0.0.0.0"
    webqueryPort = 25569

    enableServerIntel = true
    enablePlayerIntel = true
    enableChatReporting = true

    serverIntelIntervalSeconds = 60
    playerIntelIntervalSeconds = 300

WebQuery

WebQuery 系统是一个 TCP 套接字服务器（默认端口 25569），允许你的 MineTrax 网页面板实时向服务器推送命令。所有流量均使用你的 apiKey 和 apiSecret 进行 AES-CBC 加密和 HMAC-SHA256 签名。

如果 MineTrax 托管在单独的机器上，请确保端口 25569 在你的防火墙中已打开。

来自 MineTrax 的支持的入站命令：

Command	Description
`ping`	返回在线/最大玩家数量
`status`	返回完整的在线玩家列表
`broadcast`	向所有玩家广播一条消息
`user-say`	以网页用户身份广播一条消息
`command`	运行一条控制台命令
`check-player-online`	检查一个玩家当前是否在线
`account-link-success`	将一个玩家的账户标记为已关联

命令

Command	Permission	Description
`/link <otp>`	所有玩家	使用网站提供的一次性密码（OTP）将你的 Minecraft 账户关联到你的 MineTrax 网页资料