ZH:Debugging

Notch的客户端和服务端（以及启动器）可以生成除平常显示的额外日志信息，其中的一些对调试非常有帮助. 要完成这个，需要通过指定一个自定义Log4j配置.

本地启动器直接提供了一个“日志配置”部分来完成这个. 对于其他情况，可以通过向游戏添加 参数来完成：


 * [[media:ClientDebugging.png|Java启动器中的JVM参数部分]]
 * 服务端启动命令的 之前
 * 直接调用 时 之前

当使用本地启动器时，使用日志配置的XML变体并勾选“自定义日志配置输出XML”. 这会允许启动器在其输出中提供更干净的的信息. 当使用java启动器或启动服务端时，使用非XML变体（你在控制台中不需要XML，且XML变体不适用于服务端GUI）.

你可以通过解压要工作的jar中的 来获取游戏的默认配置.

选项
log4j配置中只有一些选项拥有有用的行为.

最主要的一个是 中的. 一般来说，它被设置为 ，但它同样接受 、 、 、 、 、 和. Minecraft实际上使用的最底层是 ，所以要获得最多的额外信息应该使用这个.

另一个重要的选项是 列表. 默认地，游戏使用 过滤掉所有数据包相关的信息，它会拒绝所有标记为 的日志信息. 你可以更改它来使过滤器反而只接受 而拒绝其他的一切，或者你也可以整个移除 让它显示所有的信息. 除 之外，还有一些别的日志标记： 、 、 以及. 和 的行为完全一样； 和 可以用于只显示一组数据包；而 可以用于发射有关音乐通道何时开始及结束的信息（通常只在诊断音频似乎会播放两次的问题时才有用）.

另外要注意：默认地，如果一天中的日志超过7个，那么log4j会覆写旧的日志（见MC-100524）. 你可以通过向 添加 来禁用此行为，这使得一天最多1000个文件（这不太可能被命中——在较大的对象上使用1000，因为在较大的数量上开始出现性能命中）.

仅网络数据包
应用至：原版客户端及服务端

产生所有服务端/客户端发送和接受到数据包的日志，除此之外没有别的内容（这也同样禁用了正常内容的日志，包括聊天）不幸的是，自Netty重写后（Minecraft 1.7），只能记录数据包的ID和类，而不能记录它们的内容；然而这些信息还可能会有一些帮助.

Config:

Config (XML output):

所有调试信息
应用至：原版客户端和服务端

你可以记录比你想象的多得多. 这除了会输出平常的日志消息（比如聊天），还会输出网络数据包、声音开始/停止播放（仅客户端）、一些认证请求以及别的杂项信息.

Config:

Config (XML output):

所有CraftBukkit/Spigot上的调试信息
应用至：从CraftBukkit衍生的CraftBukkit服务端

因为CraftBukkit使用了一些不一样的控制台输出（且没有服务端GUI），所以配置需要进行一些小小的改变来正确地显示. 然而，这么做也会显示重映射的数据包类名

Config:

启动器任务信息
应用至：Launcher.jar

通过在（Java启动器的）launcher.jar上启用调试启动，你可以看到与Mojang API——如果你想看你自己账号对每个端点的示例连接，这会起到一些帮助.

注意如果你调用了普通的启动器EXE/JAR，该配置也许不会生效——取而代之地，应将它用于位于 的.

Config: