Debug mode/zh: Difference between revisions
Jump to navigation
Jump to search
m fixed links |
Finished page translation. |
||
Line 1: | Line 1: | ||
{{Languages}} | {{Languages}} | ||
''' | [[File:debug_during_play.png|thumb|250px|right|调试模式界面,部分功能已启用。]] | ||
'''{{Translation|Debug mode}}'''(Debug mode)主要用于分析游戏的运行状态,一般是由游戏开发者和模组作者使用。启用调试模式可显示游戏世界的详细信息。启用调试模式的默认快捷键是{{keybinding|F5}}。 | |||
例如,调试模式可以用于: | |||
* 查看[[Enemies/zh#撕咬虫|撕咬虫]] | * 查看[[Enemies/zh#撕咬虫|撕咬虫]]的来路,以及它们计划攻击的目标; | ||
* 查看光标的位置/坐标; | * 查看光标的位置/坐标; | ||
* 查看[[ | * 查看[[map structure/zh#格|格]]和[[map structure/zh#区块|区块]]组成的网格; | ||
* | * 查看与游戏进程无关的附加信息。如每秒刷新数(UPS)和帧率(FPS)。 | ||
'''注意:''' | '''注意:''' 除了这个内部调试工具之外,还有社区贡献的第三方调试工具,这可以在官方论坛上的[https://forums.factorio.com/viewforum.php?f=135 模组开发工具]版区获取。 | ||
== | == 激活调试模式 == | ||
调试等级共分为两级: | |||
* '''Always''' - 如果没有选择任何模式,这便是默认模式。此模式只保留少量活动选项。 | |||
* '''Debug''' - 按{{keybinding|F5}}键切换。允许切换调试覆盖层。 | |||
== 配置调试模式 == | |||
要配置上述的两个模式,请按{{keybinding|F4}}。这将打开一个包含许多选项的菜单,如果它遮挡了某些有趣的内容,玩家可以用鼠标移动该菜单。可以在两个菜单之间切换,对应该调试模式的选项('''Always'''、'''Debug''')。每个模式都可以根据用户的喜好进行配置,不同模式只是为了方便使用。可按下{{Keybinding|ctrl|F}}进行搜索。 | |||
== 调试选项以及功能 == | == 调试选项以及功能 == | ||
Line 26: | Line 26: | ||
! 选项 !! 描述 | ! 选项 !! 描述 | ||
|- | |- | ||
| show-fps || | | show-fps || 将显示当前的每秒帧数和每秒刷新数,缩写为<abbr title="每秒帧数">FPS</abbr>和<abbr title="每秒更新次数">UPS</abbr>。正常情况下这两个值应当为60左右。 | ||
|- | |- | ||
| show-clock || 显示实时时钟。 | | show-clock || 显示实时时钟。 | ||
|- | |- | ||
| show-detailed-info || | | show-detailed-info || | ||
* 显示光标在[[ | * 显示光标在[[map structure/zh#格|格]](及其分区)的位置。 | ||
* 当前分辨率和缩放比例。 | * 当前分辨率和缩放比例。 | ||
* 屏幕上有多少个物体(由显卡绘制)。 | * 屏幕上有多少个物体(由显卡绘制)。 | ||
* | * 游戏中使用了多少实体、区块和路径。 | ||
|- | |- | ||
| show-time-usage || | | show-time-usage || | ||
* | * 一些内部计算所需时间的内部统计,单位为毫秒/[[time/zh#刻|刻]]。 | ||
* | * 显示的统计数据为最近100刻中的平均值/最小值/最大值,统计的时长可以通过<code> /perf-avg-frames</code>命令进行更改。 | ||
* | * 最小值不包括零(例如,没有模组钩子运行的时刻)。 | ||
* | * 汇总计算的延迟值(其中一些是并行的)必须低于16.6毫秒,以在1倍速游戏时维持每秒60刻的正常帧率。 | ||
* | * 本项目的最顶层部分涵盖了更广泛的游戏引擎活动,中间的“Update”部分与在1刻中运行的模拟运算相关。底部的“Map Generator”部分则与地图生成活动相关。如需了解更多详情,请参阅:{{L|Tutorial:Diagnosing performance issues|anchor=深入了解_"time_usage"_界面}}。 | ||
|- | |- | ||
| show-entity-time-usage || | | show-entity-time-usage || | ||
Line 47: | Line 47: | ||
| show-gpu-time-usage || | | show-gpu-time-usage || | ||
|- | |- | ||
| show-sprite-counts || | | show-sprite-counts || 屏幕上渲染的精灵(sprite,一种动态渲染的图像)的数量。 | ||
|- | |- | ||
| show-lua-object-statistics || | | show-lua-object-statistics || 与Lua垃圾回收器相关的统计信息。包含更新时间 [update time](平均/最小/最大),已创建对象 [created objects](平均/最小/最大 [总数])以及已摧毁对象 [destroyed objects](平均/最小/最大 [总数])。 | ||
|- | |- | ||
| show-heat-buffer-info || | | show-heat-buffer-info || | ||
|- | |- | ||
| show-multiplayer-waiting-icon || | | show-multiplayer-waiting-icon || 在多人游戏中,如果游戏正在等待服务器处理,此选项会显示。 | ||
|- | |- | ||
| show-multiplayer-statistics || | | show-multiplayer-statistics || 多人游戏中的延迟信息。 | ||
|- | |- | ||
| show-multiplayer-selection-rectangles || | | show-multiplayer-selection-rectangles || 允许在多人游戏中查看其它玩家的选框。 | ||
|- | |- | ||
| show-debug-info-in-tooltips || | | show-debug-info-in-tooltips || 在实体、物品、配方、地格等对象的提示栏中显示额外信息。 | ||
|- | |- | ||
| show-resistances-in-tooltips-always || | | show-resistances-in-tooltips-always || 在所有实体的提示栏中显示实体的抗性。默认情况下只有敌人实体和“[https://lua-api.factorio.com/latest/prototypes/EntityWithHealthPrototype.html#hide_resistances hide_resistances]”变量设置为false的实体才会显示抗性。 | ||
|- | |- | ||
| hide-mod-guis || | | hide-mod-guis || 隐藏由模组添加的用户界面。 | ||
|- | |- | ||
| show-tile-grid || 显示[[ | | show-tile-grid || 显示[[map structure/zh#格|地格]]和[[Map structure/zh#区块|区块]]的边界。 | ||
|- | |- | ||
| show-blueprint-grid || | | show-blueprint-grid || | ||
|- | |- | ||
| show-collision-rectangles || | | show-collision-rectangles || 显示每个实体的碰撞框(红色)。 | ||
|- | |- | ||
| show-selection-rectangles || | | show-selection-rectangles || 在每个实体上显示一个蓝色框,如果将鼠标悬停其上,它将会被选中。 | ||
|- | |- | ||
| show-render-rectangles || | | show-render-rectangles || 在每个实体上显示一个粉色框,如果位于屏幕上,则该实体会被渲染。 | ||
|- | |- | ||
| show-sticker-boxes || | | show-sticker-boxes || | ||
Line 81: | Line 81: | ||
| show-entity-velocities || | | show-entity-velocities || | ||
|- | |- | ||
| show-selected-entity-advanced-tiles || | | show-selected-entity-advanced-tiles || 显示实体位于哪些高级地格(2×2格)上。 | ||
|- | |- | ||
| show-selected-input-transport-belts || | | show-selected-input-transport-belts || 显示输入到所选传送带上的实体。 | ||
|- | |- | ||
| show-paths || | | show-paths || 以不同颜色显示虫子的计算路径。 | ||
|- | |- | ||
| show-path-requests || | | show-path-requests || | ||
|- | |- | ||
| show-next-waypoint-bb || | | show-next-waypoint-bb || 显示虫子的路径点(绿色),与下一个选项的信息基本相同。 | ||
|- | |- | ||
| show-target || | | show-target || 显示虫子当前的目标(红色)。 | ||
|- | |- | ||
| show-unit-group-info || | | show-unit-group-info || 显示属于同一组的虫子(包括圆圈和线条)。 | ||
|- | |- | ||
| show-unit-behavior-info || | | show-unit-behavior-info || | ||
Line 99: | Line 99: | ||
| show-pathfinder-fringe || | | show-pathfinder-fringe || | ||
|- | |- | ||
| show-path-cache || | | show-path-cache || 显示路径的源位置和长度(?) | ||
|- | |- | ||
| show-path-cache-paths || | | show-path-cache-paths || | ||
|- | |- | ||
| show-rail-paths || | | show-rail-paths || 显示火车行驶的路径。 | ||
|- | |- | ||
| show-rolling-stock-count || | | show-rolling-stock-count || 显示机械臂装卸车厢的位置。 | ||
|- | |- | ||
| show-rail-connections || 显示铁路连接。 | | show-rail-connections || 显示铁路连接。 | ||
Line 113: | Line 113: | ||
| show-rail-segment-collision-boxes || | | show-rail-segment-collision-boxes || | ||
|- | |- | ||
| show-train-stop-point || | | show-train-stop-point || 当火车减速时,显示计算出的可能停车位置。 | ||
|- | |- | ||
| show-train-braking-distance || | | show-train-braking-distance || 火车以当前速度停下来所需的距离。 | ||
|- | |- | ||
| show-train-signals || | | show-train-signals || | ||
|- | |- | ||
| show-train-repathing || | | show-train-repathing || 当火车重新规划路径时,在列车上方显示悬浮的“重新规划路径”文本。 | ||
|- | |- | ||
| show-network-connected-entities || | | show-network-connected-entities || 显示电线杆连接的电网的编号。 | ||
|- | |- | ||
| show-circuit-network-numbers || | | show-circuit-network-numbers || 显示信号网络的编号(及颜色)。 | ||
|- | |- | ||
| show-energy-sources-networks || | | show-energy-sources-networks || 显示实体接入的电网的编号。 | ||
|- | |- | ||
| show-active-state || Inserters | | show-active-state || {{Translation|Inserters}}、{{Translation|Raw fish}}、{{Translation|Turrets}}在未使用时将转入非活动状态。红色 = 不活动,紫色 = 附近无敌人时不活动(炮塔等),绿色 = 附近无玩家时不活动(鲜鱼)。非活动实体可以消耗更少的CPU资源。 | ||
|- | |- | ||
| show-wakeup-lists || | | show-wakeup-lists || 当实体在另一个实体中休眠(即不活动)时,显示它在哪些实体中休眠。 | ||
|- | |- | ||
| show-transport-lines || | | show-transport-lines || | ||
Line 135: | Line 135: | ||
| show-transport-line-gaps || | | show-transport-line-gaps || | ||
|- | |- | ||
| show-pollution-values || | | show-pollution-values || 显示每个区块中的污染数值。 | ||
|- | |- | ||
| show-active-entities-on-chunk-counts || | | show-active-entities-on-chunk-counts || | ||
显示每个区块中活动实体的数量。它们分为两类: | |||
* 蓝色 = | * 蓝色 = 当玩家靠近时激活(例如鲜鱼) | ||
* 绿色 = | * 绿色 = 当敌人靠近时激活(例如炮塔) | ||
|- | |- | ||
| show-active-chunks || | | show-active-chunks || 在地图视图中显示“已探索 ”的区块,未标记的区块不计入。 | ||
|- | |- | ||
| show-polluted-chunks || | | show-polluted-chunks || 显示受到污染的区块。 | ||
|- | |- | ||
| hide-chart-tags || 隐藏地图标签。 | | hide-chart-tags || 隐藏地图标签。 | ||
|- | |- | ||
| show-enemy-expansion-candidate-chunks || | | show-enemy-expansion-candidate-chunks || 显示虫群可扩张的剩余空间,从红色(几乎没有空间)到绿色(有扩张空间)。 | ||
|- | |- | ||
| show-enemy-expansion-candidate-chunk-values || | | show-enemy-expansion-candidate-chunk-values || 敌人将要尝试扩张的目标区块。 | ||
|- | |- | ||
| show-bad-attack-chunks || | | show-bad-attack-chunks || | ||
|- | |- | ||
| show-tile-variations || | | show-tile-variations || 显示地图上每个区域所绘制的地格变体(1、2或4格大小)。此选项的内容较为混乱,需要放大以查看具体含义。 | ||
|- | |- | ||
| show-raw-tile-transitions || | | show-raw-tile-transitions || 关闭陆地和水体的连接纹理,使它们更容易区分。 | ||
|- | |- | ||
| show-fluid-box-fluid-info || | | show-fluid-box-fluid-info || 显示管道/储液罐中的流体存量,并显示管道中流体的流动情况。 | ||
|- | |- | ||
| show-environment-sound-info || | | show-environment-sound-info || 显示实体正在播放的声音类型和音量大小。 | ||
|- | |- | ||
| show-environment-sound-area || | | show-environment-sound-area || | ||
Line 186: | Line 186: | ||
| show-chunk-components || | | show-chunk-components || | ||
|- | |- | ||
| show-train-no-path-details || | | show-train-no-path-details || 聊天框将显示找不到路径的火车发出的额外寻路信息。 [https://forums.factorio.com/viewtopic.php?p=567834#p567834] | ||
|} | |} | ||
{{C|Main}} | {{C|Main}} |
Revision as of 20:40, 16 April 2025

调试模式(Debug mode)主要用于分析游戏的运行状态,一般是由游戏开发者和模组作者使用。启用调试模式可显示游戏世界的详细信息。启用调试模式的默认快捷键是F5。
例如,调试模式可以用于:
注意: 除了这个内部调试工具之外,还有社区贡献的第三方调试工具,这可以在官方论坛上的模组开发工具版区获取。
激活调试模式
调试等级共分为两级:
- Always - 如果没有选择任何模式,这便是默认模式。此模式只保留少量活动选项。
- Debug - 按F5键切换。允许切换调试覆盖层。
配置调试模式
要配置上述的两个模式,请按F4。这将打开一个包含许多选项的菜单,如果它遮挡了某些有趣的内容,玩家可以用鼠标移动该菜单。可以在两个菜单之间切换,对应该调试模式的选项(Always、Debug)。每个模式都可以根据用户的喜好进行配置,不同模式只是为了方便使用。可按下CTRL + F进行搜索。
调试选项以及功能
选项 | 描述 |
---|---|
show-fps | 将显示当前的每秒帧数和每秒刷新数,缩写为FPS和UPS。正常情况下这两个值应当为60左右。 |
show-clock | 显示实时时钟。 |
show-detailed-info |
|
show-time-usage | |
show-entity-time-usage | |
show-gpu-time-usage | |
show-sprite-counts | 屏幕上渲染的精灵(sprite,一种动态渲染的图像)的数量。 |
show-lua-object-statistics | 与Lua垃圾回收器相关的统计信息。包含更新时间 [update time](平均/最小/最大),已创建对象 [created objects](平均/最小/最大 [总数])以及已摧毁对象 [destroyed objects](平均/最小/最大 [总数])。 |
show-heat-buffer-info | |
show-multiplayer-waiting-icon | 在多人游戏中,如果游戏正在等待服务器处理,此选项会显示。 |
show-multiplayer-statistics | 多人游戏中的延迟信息。 |
show-multiplayer-selection-rectangles | 允许在多人游戏中查看其它玩家的选框。 |
show-debug-info-in-tooltips | 在实体、物品、配方、地格等对象的提示栏中显示额外信息。 |
show-resistances-in-tooltips-always | 在所有实体的提示栏中显示实体的抗性。默认情况下只有敌人实体和“hide_resistances”变量设置为false的实体才会显示抗性。 |
hide-mod-guis | 隐藏由模组添加的用户界面。 |
show-tile-grid | 显示地格和区块的边界。 |
show-blueprint-grid | |
show-collision-rectangles | 显示每个实体的碰撞框(红色)。 |
show-selection-rectangles | 在每个实体上显示一个蓝色框,如果将鼠标悬停其上,它将会被选中。 |
show-render-rectangles | 在每个实体上显示一个粉色框,如果位于屏幕上,则该实体会被渲染。 |
show-sticker-boxes | |
show-entity-positions | |
show-entity-velocities | |
show-selected-entity-advanced-tiles | 显示实体位于哪些高级地格(2×2格)上。 |
show-selected-input-transport-belts | 显示输入到所选传送带上的实体。 |
show-paths | 以不同颜色显示虫子的计算路径。 |
show-path-requests | |
show-next-waypoint-bb | 显示虫子的路径点(绿色),与下一个选项的信息基本相同。 |
show-target | 显示虫子当前的目标(红色)。 |
show-unit-group-info | 显示属于同一组的虫子(包括圆圈和线条)。 |
show-unit-behavior-info | |
show-pathfinder-fringe | |
show-path-cache | 显示路径的源位置和长度(?) |
show-path-cache-paths | |
show-rail-paths | 显示火车行驶的路径。 |
show-rolling-stock-count | 显示机械臂装卸车厢的位置。 |
show-rail-connections | 显示铁路连接。 |
show-rail-joints | |
show-rail-segment-collision-boxes | |
show-train-stop-point | 当火车减速时,显示计算出的可能停车位置。 |
show-train-braking-distance | 火车以当前速度停下来所需的距离。 |
show-train-signals | |
show-train-repathing | 当火车重新规划路径时,在列车上方显示悬浮的“重新规划路径”文本。 |
show-network-connected-entities | 显示电线杆连接的电网的编号。 |
show-circuit-network-numbers | 显示信号网络的编号(及颜色)。 |
show-energy-sources-networks | 显示实体接入的电网的编号。 |
show-active-state | 机械臂、鲜鱼、炮塔在未使用时将转入非活动状态。红色 = 不活动,紫色 = 附近无敌人时不活动(炮塔等),绿色 = 附近无玩家时不活动(鲜鱼)。非活动实体可以消耗更少的CPU资源。 |
show-wakeup-lists | 当实体在另一个实体中休眠(即不活动)时,显示它在哪些实体中休眠。 |
show-transport-lines | |
show-transport-line-gaps | |
show-pollution-values | 显示每个区块中的污染数值。 |
show-active-entities-on-chunk-counts |
显示每个区块中活动实体的数量。它们分为两类:
|
show-active-chunks | 在地图视图中显示“已探索 ”的区块,未标记的区块不计入。 |
show-polluted-chunks | 显示受到污染的区块。 |
hide-chart-tags | 隐藏地图标签。 |
show-enemy-expansion-candidate-chunks | 显示虫群可扩张的剩余空间,从红色(几乎没有空间)到绿色(有扩张空间)。 |
show-enemy-expansion-candidate-chunk-values | 敌人将要尝试扩张的目标区块。 |
show-bad-attack-chunks | |
show-tile-variations | 显示地图上每个区域所绘制的地格变体(1、2或4格大小)。此选项的内容较为混乱,需要放大以查看具体含义。 |
show-raw-tile-transitions | 关闭陆地和水体的连接纹理,使它们更容易区分。 |
show-fluid-box-fluid-info | 显示管道/储液罐中的流体存量,并显示管道中流体的流动情况。 |
show-environment-sound-info | 显示实体正在播放的声音类型和音量大小。 |
show-environment-sound-area | |
show-selected-entity-audible-range | |
show-recently-played-sound-info | |
show-logistic-robot-targets | |
show-spidertron-movement | |
show-player-robots | |
show-fire-info | |
show-sticker-info | |
show-decorative-names | |
show-decorative-collision-rectangles | |
allow-increased-zoom | |
show-chunk-components | |
show-train-no-path-details | 聊天框将显示找不到路径的火车发出的额外寻路信息。 [1] |