MSMP 增强版

MSMP 增强版

扩展Minecraft服务器管理协议（MSMP），包括新的JSON RPC方法和Unix套接字支持

管理

MSMP Enhanced

MSMP Enhanced 是一个服务端 Fabric 模组，用于扩展 Minecraft 1.21.9（25w35a）中引入的 Minecraft Server Management Protocol。

本模组提供可选的 Unix socket 支持，并新增了额外的 RPC 方法。 MSMP Enhanced 还可以用作远程服务器控制台后端，类似 RCON，但支持结构化的 Text Components 和命令 Tab 补全。 这使得外部工具（如 Web 面板或 CLI 工具）可以执行命令、查看带样式的输出，并在输入时获取命令的实时建议。

功能

方法

命令执行

  • 方法： msmpenhanced:command/run
  • 描述： 执行控制台命令，并以结构化 Text Components 的形式返回命令输出
  • 参数： command（String）
  • 响应： messages（Text Components 数组）

命令建议（Tab 补全）

  • 方法： msmpenhanced:command/suggest
  • 描述： 允许外部工具（例如 Web 面板或 CLI 工具）提供命令 Tab 补全
  • 参数： partialCommand（String）
  • 响应： suggestions（命令建议）

Unix Socket 支持（可选）

MSMP Enhanced 可以监听 Unix Domain Socket，而不是将 Minecraft Management Server 绑定到 TCP 端口。 配置选项请参见 配置。

Schemas

Command Suggestions

  • start（Integer）：建议的起始位置
  • end（Integer）：建议的结束位置
  • suggestions（Command Suggestion 数组）

Command Suggestion

  • text（String）：命令建议
  • tooltip（可选 Text Component）：附加提示

配置

配置存储在 config/msmpenhanced.json

{
  "unixSocketEnabled": false,
  "unixSocketPath": "msmp.sock"
}

MSMP Enhanced 默认使用 TCP（原版行为）。

许可证

本项目仅依据 GNU Lesser General Public License version 3 授权。