imported>Kaniol: /* Launcher session information */

2019-11-17T13:28:45Z

Launcher session information

← Older revision	Revision as of 13:28, 17 November 2019
(No difference)

imported>Kaniol: /* Launcher session information */

2019-11-17T13:28:45Z

Launcher session information

New page

Notch的客户端和服务端（以及启动器）可以生成除平常显示的额外日志信息，其中的一些对调试非常有帮助。要完成这个，需要通过指定一个自定义[http://logging.apache.org/log4j/2.x/manual/configuration.html Log4j配置]。

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

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

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

{{Warning|如果不能找到指定了<code>-Dlog4j.configurationFile</code>的配置，那么将会使用默认的那个代替。}}

你可以通过解压要工作的jar中的<code>log4j2.xml</code>来获取游戏的默认配置。

== 选项 ==

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

最主要的一个是<code><nowiki><Root></nowiki></code>中的<code>level</code>。一般来说，它被设置为<code>info</code>，但它同样接受<code>trace</code>、<code>debug</code>、<code>info</code>、<code>warn</code>、<code>error</code>、<code>all</code>和<code>off</code>。Minecraft实际上使用的最底层是<code>debug</code>，所以要获得最多的额外信息应该使用这个。

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

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

== 示例配置 ==

=== 仅网络数据包 ===

''应用至：原版客户端及服务端''

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

{{warning|数据包ID在日志中显示为十进制；它们不是十六进制的。}}

<div class="mw-collapsible mw-collapsed" style="border: 1px solid #aaa;">
Config:
<syntaxhighlight lang="xml" class="mw-collapsible-content">
<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN" packages="com.mojang.util">
<Appenders>
<Console name="SysOut" target="SYSTEM_OUT">
<PatternLayout pattern="[%d{HH:mm:ss}] [%t/%level]: %msg%n" />
</Console>
<Queue name="ServerGuiConsole">
<PatternLayout pattern="[%d{HH:mm:ss} %level]: %msg%n" />
</Queue>
<RollingRandomAccessFile name="File" fileName="logs/latest.log" filePattern="logs/%d{yyyy-MM-dd}-%i.log.gz">
<PatternLayout pattern="[%d{HH:mm:ss}] [%t/%level]: %msg%n" />
<Policies>
<TimeBasedTriggeringPolicy />
<OnStartupTriggeringPolicy />
</Policies>
<DefaultRolloverStrategy max="1000"/>
</RollingRandomAccessFile>
</Appenders>
<Loggers>
<Root level="debug">
<filters>
<MarkerFilter marker="NETWORK_PACKETS" onMatch="ACCEPT" onMismatch="DENY" />
</filters>
<AppenderRef ref="SysOut"/>
<AppenderRef ref="File"/>
<AppenderRef ref="ServerGuiConsole"/>
</Root>
</Loggers>
</Configuration>
</syntaxhighlight>
</div>

<div class="mw-collapsible mw-collapsed" style="border: 1px solid #aaa;">
Config (XML output):
<syntaxhighlight lang="xml" class="mw-collapsible-content">
<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
<Appenders>
<Console name="SysOut" target="SYSTEM_OUT">
<XMLLayout />
</Console>
<RollingRandomAccessFile name="File" fileName="logs/latest.log" filePattern="logs/%d{yyyy-MM-dd}-%i.log.gz">
<PatternLayout pattern="[%d{HH:mm:ss}] [%t/%level]: %msg%n" />
<Policies>
<TimeBasedTriggeringPolicy />
<OnStartupTriggeringPolicy />
</Policies>
<DefaultRolloverStrategy max="1000"/>
</RollingRandomAccessFile>
</Appenders>
<Loggers>
<Root level="debug">
<filters>
<MarkerFilter marker="NETWORK_PACKETS" onMatch="ACCEPT" onMismatch="DENY" />
</filters>
<AppenderRef ref="SysOut"/>
<AppenderRef ref="File"/>
</Root>
</Loggers>
</Configuration>
</syntaxhighlight>
</div>

=== 所有调试信息 ===

''应用至：原版客户端和服务端''

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

<div class="mw-collapsible mw-collapsed" style="border: 1px solid #aaa;">
Config:
<syntaxhighlight lang="xml" class="mw-collapsible-content">
<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN" packages="com.mojang.util">
<Appenders>
<Console name="SysOut" target="SYSTEM_OUT">
<PatternLayout pattern="[%d{HH:mm:ss}] [%t/%level]: %msg%n" />
</Console>
<Queue name="ServerGuiConsole">
<PatternLayout pattern="[%d{HH:mm:ss} %level]: %msg%n" />
</Queue>
<RollingRandomAccessFile name="File" fileName="logs/latest.log" filePattern="logs/%d{yyyy-MM-dd}-%i.log.gz">
<PatternLayout pattern="[%d{HH:mm:ss}] [%t/%level]: %msg%n" />
<Policies>
<TimeBasedTriggeringPolicy />
<OnStartupTriggeringPolicy />
</Policies>
<DefaultRolloverStrategy max="1000"/>
</RollingRandomAccessFile>
</Appenders>
<Loggers>
<Root level="debug">
<AppenderRef ref="SysOut"/>
<AppenderRef ref="File"/>
<AppenderRef ref="ServerGuiConsole"/>
</Root>
</Loggers>
</Configuration>
</syntaxhighlight>
</div>

<div class="mw-collapsible mw-collapsed" style="border: 1px solid #aaa;">
Config (XML output):
<syntaxhighlight lang="xml" class="mw-collapsible-content">
<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
<Appenders>
<Console name="SysOut" target="SYSTEM_OUT">
<XMLLayout />
</Console>
<RollingRandomAccessFile name="File" fileName="logs/latest.log" filePattern="logs/%d{yyyy-MM-dd}-%i.log.gz">
<PatternLayout pattern="[%d{HH:mm:ss}] [%t/%level]: %msg%n" />
<Policies>
<TimeBasedTriggeringPolicy />
<OnStartupTriggeringPolicy />
</Policies>
<DefaultRolloverStrategy max="1000"/>
</RollingRandomAccessFile>
</Appenders>
<Loggers>
<Root level="debug">
<AppenderRef ref="SysOut"/>
<AppenderRef ref="File"/>
</Root>
</Loggers>
</Configuration>
</syntaxhighlight>
</div>

=== 所有CraftBukkit/Spigot上的调试信息 ===

''应用至：从CraftBukkit衍生的CraftBukkit服务端''

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

<div class="mw-collapsible mw-collapsed" style="border: 1px solid #aaa;">
Config:
<syntaxhighlight lang="xml" class="mw-collapsible-content">
<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN" packages="net.minecraft,com.mojang">
<Appenders>
<Console name="WINDOWS_COMPAT" target="SYSTEM_OUT"></Console>
<Queue name="TerminalConsole">
<PatternLayout pattern="[%d{HH:mm:ss} %level]: %msg%n" />
</Queue>
<RollingRandomAccessFile name="File" fileName="logs/latest.log" filePattern="logs/%d{yyyy-MM-dd}-%i.log.gz">
<PatternLayout pattern="[%d{HH:mm:ss}] [%t/%level]: %msg%n" />
<Policies>
<TimeBasedTriggeringPolicy />
<OnStartupTriggeringPolicy />
</Policies>
<DefaultRolloverStrategy max="1000"/>
</RollingRandomAccessFile>
</Appenders>
<Loggers>
<Root level="debug">
<AppenderRef ref="WINDOWS_COMPAT"/>
<AppenderRef ref="File"/>
<AppenderRef ref="TerminalConsole"/>
</Root>
</Loggers>
</Configuration>
</syntaxhighlight>
</div>

=== 启动器任务信息 ===

''应用至：Launcher.jar''

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

注意如果你调用了普通的启动器EXE/JAR，该配置也许''不会''生效——取而代之地，应将它用于位于<code>%appdata%\.minecraft</code>的<code>launcher.jar</code>。

<div class="mw-collapsible mw-collapsed" style="border: 1px solid #aaa;">
Config:
<syntaxhighlight lang="xml" class="mw-collapsible-content">
<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN" packages="com.mojang">
<Appenders>
<Console name="SysOut" target="SYSTEM_OUT">
<PatternLayout pattern="[%d{HH:mm:ss} %level]: %msg%n" />
</Console>
<Queue name="DevelopmentConsole">
<PatternLayout pattern="[%d{HH:mm:ss} %level]: %msg%n" />
</Queue>
<Async name="Async">
<AppenderRef ref="SysOut"/>
<AppenderRef ref="DevelopmentConsole"/>
</Async>
</Appenders>
<Loggers>
<Root level="debug">
<AppenderRef ref="Async"/>
</Root>
</Loggers>
</Configuration>
</syntaxhighlight>

</div>

ZH:Debugging - Revision history

imported>Kaniol: /* Launcher session information */

imported>Kaniol: /* Launcher session information */