McFunction-Debug-Adapter

McFunction-Debugger的Debug Adapter Protocol实现。

McFunction-Debug-Adapter仅支持通过stdin和stdout通信的单会话模式。要执行mcfunction文件，开发工具需要发送一个launch请求（不支持attach请求）。

执行上下文

调试函数将使用schedule命令执行，因此它将在没有@实体的世界原点位置运行。

启动参数

为了让调试适配器连接到Minecraft，它需要在launch请求中提供一些参数

程序

要调试的mcfunction文件的路径。mcfunction文件必须包含一个pack.mcmeta文件的datapack中。

minecraftWorldDir

调试适配器应连接到的Minecraft世界的目录。

对于单人游戏，这通常是保存目录中的一个目录

• Windows: %appdata%\.minecraft\saves\
• GNU/Linux: ~/.minecraft/saves/
• Mac: ~/Library/Application Support/minecraft/saves/

对于服务器，它由server.properties指定。

minecraftLogFile

Minecraft日志文件的路径。

对于单人游戏，通常在这些位置

• Windows: %appdata%\.minecraft\logs\latest.log
• GNU/Linux: ~/.minecraft/logs/latest.log
• Mac: ~/Library/Application Support/minecraft/logs/latest.log

对于服务器，它位于服务器目录中的 logs/latest.log。

示例

{
  "program": "C:/Users/Herobrine/my_datapack/data/my_namespace/functions/main.mcfunction",
  "minecraftWorldDir": "C:/Users/Herobrine/AppData/Roaming/.minecraft/saves/New World",
  "minecraftLogFile": "C:/Users/Herobrine/AppData/Roaming/.minecraft/logs/latest.log"
}

命令行界面

mcfunction-debug-适配器[FLAGS] [OPTIONS] --输入<DATAPACK> --输出<DATAPACK>

标志

--help

打印帮助信息。

--version

打印版本信息。

选项

--log-file

日志文件的路径。如果指定，调试适配器将在启动时创建此文件并将日志消息写入其中。

--log-level

日志级别也可以通过环境变量 LOG_LEVEL 进行配置。默认为 INFO。