https://mineplugin.org/index.php?action=history&feed=atom&title=Paper%2FPaper_System_Properties 2026-06-01T01:56:18Z 本wiki上该页面的版本历史 MediaWiki 1.41.1 https://mineplugin.org/index.php?title=Paper/Paper_System_Properties&diff=18071&oldid=prev 2022-11-25T14:06:00Z

<p>创建页面，内容为“&lt;blockquote&gt;&#039;&#039;&#039;阅读前提醒&#039;&#039;&#039;&lt;br /&gt; 译者不是一名Java开发者，因此我并不是很推荐阅读此页文档。如果你是开发人员，请阅读 [https…”</p> <p><b>新页面</b></p><div>&lt;blockquote&gt;&#039;&#039;&#039;阅读前提醒&#039;&#039;&#039;&lt;br /&gt;<br /> 译者不是一名Java开发者，因此我并不是很推荐阅读此页文档。如果你是开发人员，请阅读 [https://docs.papermc.io/paper/reference/system-properties Paper System Properties]以了解。对于完全不确定的翻译，下面有原文。<br /> &lt;/blockquote&gt;<br /> 这些系统配置可以在启动服务器之前就可以为不同项进行配置。<br /> <br /> &lt;blockquote&gt;&#039;&#039;&#039;小心！&#039;&#039;&#039;&lt;br /&gt;<br /> 为JVM设定可以更改其工作方式，Paper服务器也不例外。&lt;br /&gt;<br /> 如果你不确定某个Flag的作用，&#039;&#039;&#039;不要轻易使用它&#039;&#039;&#039;！<br /> &lt;/blockquote&gt;<br /> == 工作原理 ==<br /> <br /> 系统配置在启动服务器时就已经设置好了。例如，如果你正在使用 &lt;code&gt;.bat&lt;/code&gt; 或是 &lt;code&gt;.sh&lt;/code&gt; 文件以启动服务器，你可以在文件中添加System Properties的相关参数。比如：<br /> <br /> &lt;syntaxhighlight lang=&quot;bash&quot;&gt;java -Dpaper.log-level=FINE -jar paper.jar&lt;/syntaxhighlight&gt;<br /> &lt;blockquote&gt;&#039;&#039;&#039;信息&#039;&#039;&#039;&lt;br /&gt;<br /> 部分Paper系统配置项需要带上一个“.”。&lt;br /&gt;<br /> 在使用Windows Powershell时，需要拿双引号把它裹上。&lt;br /&gt;<br /> 比如 &lt;code&gt;&amp;quot;-Dpaper.log-level=FINE&amp;quot;&lt;/code&gt;<br /> &lt;/blockquote&gt;<br /> 这里的 &lt;code&gt;-D&lt;/code&gt; 用于设置环境属性，而系统属性则是带着 &lt;code&gt;FINE&lt;/code&gt; 值的 &lt;code&gt;paper.log-level&lt;/code&gt;。&lt;br /&gt;<br /> 要使用，仅需将其加入到启动命令中即可。<br /> <br /> &lt;blockquote&gt;&#039;&#039;&#039;注意&#039;&#039;&#039; 当一个系统属性的状态为 &lt;code&gt;unset&lt;/code&gt; 时，更改为 &lt;code&gt;true&lt;/code&gt; 就可以用它了。<br /> &lt;/blockquote&gt;<br /> &lt;span id=&quot;properties-列表&quot;&gt;&lt;/span&gt;<br /> == Properties 列表 ==<br /> <br /> &lt;span id=&quot;paper.playerconnection.keepalive&quot;&gt;&lt;/span&gt;<br /> ==== paper.playerconnection.keepalive: ====<br /> <br /> * &#039;&#039;&#039;默认值&#039;&#039;&#039;: &lt;code&gt;30&lt;/code&gt;<br /> * &#039;&#039;&#039;描述&#039;&#039;&#039;: 当服务器接收不到玩家心跳包后，等待多长时间后断开连接。<br /> <br /> &lt;span id=&quot;timings.bypassmax&quot;&gt;&lt;/span&gt;<br /> ==== timings.bypassMax: ====<br /> <br /> * &#039;&#039;&#039;默认值&#039;&#039;&#039;: &lt;code&gt;unset&lt;/code&gt;<br /> * &#039;&#039;&#039;描述&#039;&#039;&#039;: 允许绕过Aikar的Timings API的最大数据限制。除非API更改为允许绕过，否则仅在服务器更改是无效的。<br /> <br /> &lt;span id=&quot;letmereload&quot;&gt;&lt;/span&gt;<br /> ==== LetMeReload: ====<br /> <br /> * &#039;&#039;&#039;默认值&#039;&#039;&#039;: &lt;code&gt;unset&lt;/code&gt;<br /> * &#039;&#039;&#039;描述&#039;&#039;&#039;: 当输入 &lt;code&gt;/reload&lt;/code&gt; 命令时禁用确认重载文本。<br /> <br /> &lt;span id=&quot;paper.disablechannellimit&quot;&gt;&lt;/span&gt;<br /> ==== paper.disableChannelLimit: ====<br /> <br /> * &#039;&#039;&#039;默认值&#039;&#039;&#039;: &lt;code&gt;unset&lt;/code&gt;<br /> * &#039;&#039;&#039;描述&#039;&#039;&#039;: 禁用服务器插件通道限制。将禁用每名玩家128插件通道的限制。<br /> <br /> &lt;span id=&quot;net.kyori.adventure.text.warnwhenlegacyformattingdetected&quot;&gt;&lt;/span&gt;<br /> ==== net.kyori.adventure.text.warnWhenLegacyFormattingDetected: ====<br /> <br /> * &#039;&#039;&#039;默认值&#039;&#039;&#039;: &lt;code&gt;false&lt;/code&gt;<br /> * &#039;&#039;&#039;描述&#039;&#039;&#039;: 当在聊天组件中检测到历史格式时是否要启用警告。<br /> <br /> &lt;span id=&quot;paper.disableclassprioritization&quot;&gt;&lt;/span&gt;<br /> ==== Paper.DisableClassPrioritization: ====<br /> <br /> * &#039;&#039;&#039;默认值&#039;&#039;&#039;: &lt;code&gt;unset&lt;/code&gt;<br /> * &#039;&#039;&#039;描述&#039;&#039;&#039;: 禁用类优先级系统，主要是解决未能正确处理relocate和shade的问题。<br /> <br /> &lt;span id=&quot;paper.disableflushconsolidate&quot;&gt;&lt;/span&gt;<br /> ==== Paper.disableFlushConsolidate: ====<br /> <br /> * &#039;&#039;&#039;默认值&#039;&#039;&#039;: &lt;code&gt;unset&lt;/code&gt;<br /> * &#039;&#039;&#039;描述&#039;&#039;&#039;: 禁用Netty Flush Consolidation系统。<br /> * &#039;&#039;&#039;原文&#039;&#039;&#039;: Disables the netty flush consolidation system.<br /> <br /> &lt;span id=&quot;paper.debugdynamicmissingkeys&quot;&gt;&lt;/span&gt;<br /> ==== Paper.debugDynamicMissingKeys: ====<br /> <br /> * &#039;&#039;&#039;默认值&#039;&#039;&#039;: &lt;code&gt;unset&lt;/code&gt;<br /> * &#039;&#039;&#039;描述&#039;&#039;&#039;: 启用在NBT对象中为缺失键记录调试日志。<br /> <br /> &lt;span id=&quot;disable.watchdog&quot;&gt;&lt;/span&gt;<br /> ==== disable.watchdog: ====<br /> <br /> * &#039;&#039;&#039;默认值&#039;&#039;&#039;: &lt;code&gt;unset&lt;/code&gt;<br /> * &#039;&#039;&#039;描述&#039;&#039;&#039;: 禁用Watchdog警告系统。<br /> <br /> &lt;span id=&quot;paper.explicit-flush&quot;&gt;&lt;/span&gt;<br /> ==== paper.explicit-flush: ====<br /> <br /> * &#039;&#039;&#039;默认值&#039;&#039;&#039;: &lt;code&gt;unset&lt;/code&gt;<br /> * &#039;&#039;&#039;描述&#039;&#039;&#039;: 启用网络通道刷新缓冲。<br /> <br /> &lt;span id=&quot;paper.enable-sync-chunk-writes&quot;&gt;&lt;/span&gt;<br /> ==== Paper.enable-sync-chunk-writes: ====<br /> <br /> * &#039;&#039;&#039;默认值&#039;&#039;&#039;: &lt;code&gt;unset&lt;/code&gt;<br /> * &#039;&#039;&#039;描述&#039;&#039;&#039;: 在每次调用时同步写入。会影响性能，尤其是是对于硬盘。<br /> <br /> &lt;span id=&quot;paper.debug-sync-loads&quot;&gt;&lt;/span&gt;<br /> ==== paper.debug-sync-loads: ====<br /> <br /> * &#039;&#039;&#039;默认值&#039;&#039;&#039;: &lt;code&gt;unset&lt;/code&gt;<br /> * &#039;&#039;&#039;描述&#039;&#039;&#039;: 同步加载区块时启用记录调试日志。<br /> <br /> &lt;span id=&quot;paper.ignoreworlddataversion&quot;&gt;&lt;/span&gt;<br /> ==== Paper.ignoreWorldDataVersion: ====<br /> <br /> * &#039;&#039;&#039;默认值&#039;&#039;&#039;: &lt;code&gt;unset&lt;/code&gt;<br /> * &#039;&#039;&#039;描述&#039;&#039;&#039;: 当加载世界时忽略数据版本。不推荐启用此项因为可能会导致出现问题。<br /> <br /> &lt;span id=&quot;debug.entities&quot;&gt;&lt;/span&gt;<br /> ==== debug.entities: ====<br /> <br /> * &#039;&#039;&#039;默认值&#039;&#039;&#039;: &lt;code&gt;unset&lt;/code&gt;<br /> * &#039;&#039;&#039;描述&#039;&#039;&#039;: 为实体信息启用调试日志文本。<br /> <br /> &lt;span id=&quot;paper.bypasshostcheck&quot;&gt;&lt;/span&gt;<br /> ==== Paper.bypassHostCheck: ====<br /> <br /> * &#039;&#039;&#039;默认值&#039;&#039;&#039;: &lt;code&gt;unset&lt;/code&gt;<br /> * &#039;&#039;&#039;描述&#039;&#039;&#039;: 当客户端尝试连接到服务器时绕过主机类型匹配。<br /> <br /> &lt;span id=&quot;paper.ticklist-warn-on-excessive-delay&quot;&gt;&lt;/span&gt;<br /> ==== paper.ticklist-warn-on-excessive-delay: ====<br /> <br /> * &#039;&#039;&#039;默认值&#039;&#039;&#039;: &lt;code&gt;unset&lt;/code&gt;<br /> * &#039;&#039;&#039;描述&#039;&#039;&#039;: 当Tick列表延时过长时启用警告。<br /> <br /> &lt;span id=&quot;debug.rewriteforide&quot;&gt;&lt;/span&gt;<br /> ==== debug.rewriteForIde: ====<br /> <br /> * &#039;&#039;&#039;默认值&#039;&#039;&#039;: &lt;code&gt;unset&lt;/code&gt;<br /> * &#039;&#039;&#039;描述&#039;&#039;&#039;: 在堆栈跟踪中移除NMS更改以在IDE中方便调试。也会remap CB插件调用以移除版本信息。<br /> <br /> &lt;span id=&quot;convertlegacysigns&quot;&gt;&lt;/span&gt;<br /> ==== convertLegacySigns: ====<br /> <br /> * &#039;&#039;&#039;默认值&#039;&#039;&#039;: &lt;code&gt;unset&lt;/code&gt;<br /> * &#039;&#039;&#039;描述&#039;&#039;&#039;: 将（旧）告示牌转换到新格式中。<br /> <br /> &lt;span id=&quot;paper.maxcustomchannelname&quot;&gt;&lt;/span&gt;<br /> ==== paper.maxCustomChannelName: ====<br /> <br /> * &#039;&#039;&#039;默认值&#039;&#039;&#039;: &lt;code&gt;64&lt;/code&gt;<br /> * &#039;&#039;&#039;描述&#039;&#039;&#039;: 设置插件通道名称的最大值。<br /> <br /> &lt;span id=&quot;paper.maxsignlength&quot;&gt;&lt;/span&gt;<br /> ==== Paper.maxSignLength: ====<br /> <br /> * &#039;&#039;&#039;默认值&#039;&#039;&#039;: &lt;code&gt;80&lt;/code&gt;<br /> * &#039;&#039;&#039;描述&#039;&#039;&#039;: 设置告示牌一行文字的最大数量的文本。<br /> <br /> &lt;span id=&quot;paper.filterthreshhold&quot;&gt;&lt;/span&gt;<br /> ==== Paper.FilterThreshhold: ====<br /> <br /> * &#039;&#039;&#039;默认值&#039;&#039;&#039;: &lt;code&gt;8192&lt;/code&gt;<br /> * &#039;&#039;&#039;最小值&#039;&#039;&#039;: &lt;code&gt;8192&lt;/code&gt;<br /> * &#039;&#039;&#039;描述&#039;&#039;&#039;: 设置过滤包的最大值的大小。<br /> <br /> &lt;span id=&quot;paper.minprecacheddatafixversion&quot;&gt;&lt;/span&gt;<br /> ==== Paper.minPrecachedDatafixVersion: ====<br /> <br /> * &#039;&#039;&#039;默认值&#039;&#039;&#039;: &lt;code&gt;Minecraft 世界版本 + 1&lt;/code&gt;<br /> * &#039;&#039;&#039;描述&#039;&#039;&#039;: 如果你想要转换大量的区块，你可以考虑从一点开始进行转换并设置此项。<br /> <br /> &lt;span id=&quot;paper.workerthreadcount&quot;&gt;&lt;/span&gt;<br /> ==== Paper.WorkerThreadCount: ====<br /> <br /> * &#039;&#039;&#039;默认值&#039;&#039;&#039;: &lt;code&gt;8&lt;/code&gt; 或 &lt;code&gt;CPU数量 - 2&lt;/code&gt;。看哪个更低。<br /> * &#039;&#039;&#039;描述&#039;&#039;&#039;: 用于区块加载的工作线程数。<br /> <br /> &lt;span id=&quot;paper.excessivetelimit&quot;&gt;&lt;/span&gt;<br /> ==== Paper.excessiveTELimit: ====<br /> <br /> * &#039;&#039;&#039;默认值&#039;&#039;&#039;: &lt;code&gt;750&lt;/code&gt;<br /> * &#039;&#039;&#039;描述&#039;&#039;&#039;: 超过此值则将方块实体拆分成多个包。<br /> <br /> &lt;span id=&quot;io.papermc.paper.suppress.sout.nags&quot;&gt;&lt;/span&gt;<br /> ==== io.papermc.paper.suppress.sout.nags: ====<br /> <br /> * &#039;&#039;&#039;默认值&#039;&#039;&#039;: &lt;code&gt;unset&lt;/code&gt;<br /> * &#039;&#039;&#039;描述&#039;&#039;&#039;: 禁止插件使用System.out/System.err输出消息。<br /> <br /> &lt;span id=&quot;paper.strict-thread-checks&quot;&gt;&lt;/span&gt;<br /> ==== paper.strict-thread-checks: ====<br /> <br /> * &#039;&#039;&#039;默认值&#039;&#039;&#039;: &lt;code&gt;unset&lt;/code&gt;<br /> * &#039;&#039;&#039;描述&#039;&#039;&#039;: 设定AsyncCatcher的状态，若代码在非主线程上运行时将记录错误。<br /> <br /> &lt;span id=&quot;paper.skipserverpropertiescomments&quot;&gt;&lt;/span&gt;<br /> ==== Paper.skipServerPropertiesComments: ====<br /> <br /> * &#039;&#039;&#039;默认值&#039;&#039;&#039;: &lt;code&gt;unset&lt;/code&gt;<br /> * &#039;&#039;&#039;描述&#039;&#039;&#039;: 跳过server.properties中的注释。<br /> <br /> &lt;span id=&quot;paper.debuginvalidskullprofiles&quot;&gt;&lt;/span&gt;<br /> ==== Paper.debugInvalidSkullProfiles: ====<br /> <br /> * &#039;&#039;&#039;默认值&#039;&#039;&#039;: &lt;code&gt;unset&lt;/code&gt;<br /> * &#039;&#039;&#039;描述&#039;&#039;&#039;: 为无效头颅启用调试日志记录。将记录所有无效头颅与其实际位置。<br /> <br /> &lt;span id=&quot;paper.alwaysprintwarningstate&quot;&gt;&lt;/span&gt;<br /> ==== paper.alwaysPrintWarningState: ====<br /> <br /> * &#039;&#039;&#039;默认值&#039;&#039;&#039;: &lt;code&gt;unset&lt;/code&gt;<br /> * &#039;&#039;&#039;描述&#039;&#039;&#039;: 是否始终为特定level打印警告。<br /> * &#039;&#039;&#039;原文&#039;&#039;&#039;: Always prints the warning state for the particular level.<br /> <br /> &lt;span id=&quot;paper.printstacktraceonbadpluginclassaccess&quot;&gt;&lt;/span&gt;<br /> ==== Paper.printStacktraceOnBadPluginClassAccess: ====<br /> <br /> * &#039;&#039;&#039;默认值&#039;&#039;&#039;: &lt;code&gt;unset&lt;/code&gt;<br /> * &#039;&#039;&#039;描述&#039;&#039;&#039;: 当插件尝试访问一个非插件依赖的类时，打印堆栈跟踪<br /> <br /> &lt;span id=&quot;paper.parseyamlcommentsbydefault&quot;&gt;&lt;/span&gt;<br /> ==== Paper.parseYamlCommentsByDefault: ====<br /> <br /> * &#039;&#039;&#039;默认值&#039;&#039;&#039;: &lt;code&gt;true&lt;/code&gt;<br /> * &#039;&#039;&#039;描述&#039;&#039;&#039;: 默认是否分析Yaml中的注释。</div>

Poikcue