切换语言: English 日本語 Русский

Debug mode/zh: Difference between revisions

From Official Factorio Wiki
Jump to navigation Jump to search
m fixed links
Cardinal (talk | contribs)
Finished page translation.
Line 1: Line 1:
{{Languages}}
{{Languages}}
'''调试模式'''(Debug mode)主要由开发者和模组制作者用来分析游戏的运行状态。启用调试模式可显示游戏世界的详细信息。启用调试模式的默认键是{{keybinding|F5}}
[[File:debug_during_play.png|thumb|250px|right|调试模式界面,部分功能已启用。]]
'''{{Translation|Debug mode}}'''(Debug mode)主要用于分析游戏的运行状态,一般是由游戏开发者和模组作者使用。启用调试模式可显示游戏世界的详细信息。启用调试模式的默认快捷键是{{keybinding|F5}}


例如,你可以
例如,调试模式可以用于:
* 查看[[Enemies/zh#撕咬虫|撕咬虫]]从哪儿来以及它们计划攻击的目标;
* 查看[[Enemies/zh#撕咬虫|撕咬虫]]的来路,以及它们计划攻击的目标;
* 查看光标的位置/坐标;
* 查看光标的位置/坐标;
* 查看[[Tile/zh|格]]和[[Chunk/zh|]]的网格;
* 查看[[map structure/zh#格|格]]和[[map structure/zh#区块|区块]]组成的网格;
* 查看更多的与游戏无关,但是很有趣的信息。如每秒更新次数和帧率。
* 查看与游戏进程无关的附加信息。如每秒刷新数(UPS)和帧率(FPS)。
'''注意:''' 除了这个内部调试工具之外,社区还在[https://forums.factorio.com/viewforum.php?f=135 Factorio 子论坛]上提供了用于mod开发的第三方调试工具。
'''注意:''' 除了这个内部调试工具之外,还有社区贡献的第三方调试工具,这可以在官方论坛上的[https://forums.factorio.com/viewforum.php?f=135 模组开发工具]版区获取。


== 激活调试模式(Debug mode) ==
== 激活调试模式 ==


一共有两种调试等级(Debug-levels):
调试等级共分为两级:
* '''Always''' - 如果没有选择任何模式,这便是默认模式。此模式只保留少量活动选项。
* '''Debug''' - 按{{keybinding|F5}}键切换。允许切换调试覆盖层。


* '''Always''' - 如果没有选择任何模式,这便是默认模式。这里只保留很少的活动选项。
== 配置调试模式 ==
* '''Debug''' - 按{{keybinding|F5}}键切换。允许切换调试覆盖。


== 配置调试模式(Debug mode) ==
要配置上述的两个模式,请按{{keybinding|F4}}。这将打开一个包含许多选项的菜单,如果它遮挡了某些有趣的内容,玩家可以用鼠标移动该菜单。可以在两个菜单之间切换,对应该调试模式的选项('''Always'''、'''Debug''')。每个模式都可以根据用户的喜好进行配置,不同模式只是为了方便使用。可按下{{Keybinding|ctrl|F}}进行搜索。
 
要配置两种模式,请按{{keybinding|F4}}。这将打开一个包含许多选项的菜单。如果它遮挡了某些有趣的内容,你可以用鼠标移动该菜单。你可以在两个菜单之间切换,对应该调试模式的选项('''Always'''、'''Debug''')。每种模式的选项相同,用户可以根据喜好进行配置。不同模式仅为方便使用而设。可按下({{Keybinding|ctrl|F}})进行搜索。


== 调试选项以及功能 ==
== 调试选项以及功能 ==
Line 26: Line 26:
! 选项 !! 描述
! 选项 !! 描述
|-
|-
| show-fps || 将显示当前的每秒帧数(FPS)和每秒更新次数(UPS),<abbr title="每秒帧数">FPS</abbr>和<abbr title="每秒更新次数">UPS</abbr>。正常情况下应为 60 左右。
| show-fps || 将显示当前的每秒帧数和每秒刷新数,缩写为<abbr title="每秒帧数">FPS</abbr>和<abbr title="每秒更新次数">UPS</abbr>。正常情况下这两个值应当为60左右。
|-
|-
| show-clock || 显示实时时钟。
| show-clock || 显示实时时钟。
|-
|-
| show-detailed-info ||
| show-detailed-info ||
* 显示光标在[[Map_structure/zh#Tile|格]](及其分区)的位置。
* 显示光标在[[map structure/zh#|格]](及其分区)的位置。
* 当前分辨率和缩放比例。
* 当前分辨率和缩放比例。
* 屏幕上有多少个物体(由显卡绘制)。
* 屏幕上有多少个物体(由显卡绘制)。
* 游戏中使用了多少实体、块和路径。
* 游戏中使用了多少实体、区块和路径。
|-
|-
| show-time-usage ||
| show-time-usage ||
* Internal statistics about how long some calculations take, in milliseconds per [[Time/zh#刻|tick]].
* 一些内部计算所需时间的内部统计,单位为毫秒/[[time/zh#刻|]]
* Time is shown as average/min/max of the last 100 ticks, interval can be changed with /perf-avg-frames.
* 显示的统计数据为最近100刻中的平均值/最小值/最大值,统计的时长可以通过<code> /perf-avg-frames</code>命令进行更改。
* Minimum values exclude zeroes (e.g. from ticks where no mod hooks were run).
* 最小值不包括零(例如,没有模组钩子运行的时刻)。
* Overall calculation delays (some are parallel) must be under 16.6 ms to maintain normal framerate at 1x speed with 60 ticks per second.
* 汇总计算的延迟值(其中一些是并行的)必须低于16.6毫秒,以在1倍速游戏时维持每秒60刻的正常帧率。
* The Top section of metrics cover the wider game engines activities. The middle Update section relates to running the simulation for a tick. The bottom Map Generator section relates to the map generation activity.
* 本项目的最顶层部分涵盖了更广泛的游戏引擎活动,中间的“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 || The counts of each sprite rendered on screen.
| show-sprite-counts || 屏幕上渲染的精灵(sprite,一种动态渲染的图像)的数量。
|-
|-
| show-lua-object-statistics || Statistics related to the Lua garbarge collector. Update time (avg/min/max), created objects (avg/min/max [total]), destroyed objects (avg/min/max [total]).
| show-lua-object-statistics || 与Lua垃圾回收器相关的统计信息。包含更新时间 [update time](平均/最小/最大),已创建对象 [created objects](平均/最小/最大 [总数])以及已摧毁对象 [destroyed objects](平均/最小/最大 [总数])。
|-
|-
| show-heat-buffer-info ||
| show-heat-buffer-info ||
|-
|-
| show-multiplayer-waiting-icon || When in a multiplayer game: if the game is currently waiting for the server to process.
| show-multiplayer-waiting-icon || 在多人游戏中,如果游戏正在等待服务器处理,此选项会显示。
|-
|-
| show-multiplayer-statistics || 多人游戏时的延迟信息。
| show-multiplayer-statistics || 多人游戏中的延迟信息。
|-
|-
| show-multiplayer-selection-rectangles || Allows to view selection rectangles of other players in multiplayer.
| show-multiplayer-selection-rectangles || 允许在多人游戏中查看其它玩家的选框。
|-
|-
| show-debug-info-in-tooltips || Shows additional information in the tooltips of entities, items, recipes, tiles etc.
| show-debug-info-in-tooltips || 在实体、物品、配方、地格等对象的提示栏中显示额外信息。
|-
|-
| show-resistances-in-tooltips-always || Show entity resitances in all entity tooltips instead of just tooltips of enemy entities and entities with [https://lua-api.factorio.com/latest/prototypes/EntityWithHealthPrototype.html#hide_resistances hide_resistances] set to false.
| show-resistances-in-tooltips-always || 在所有实体的提示栏中显示实体的抗性。默认情况下只有敌人实体和“[https://lua-api.factorio.com/latest/prototypes/EntityWithHealthPrototype.html#hide_resistances hide_resistances]”变量设置为false的实体才会显示抗性。
|-
|-
| hide-mod-guis || 隐藏由mod添加的GUI。
| hide-mod-guis || 隐藏由模组添加的用户界面。
|-
|-
| show-tile-grid || 显示[[Map_structure/zh#Tile|]]和[[Map_structure#Chunk|区块]]的边界。
| show-tile-grid || 显示[[map structure/zh#|地格]]和[[Map structure/zh#区块|区块]]的边界。
|-
|-
| show-blueprint-grid ||
| show-blueprint-grid ||
|-
|-
| show-collision-rectangles || Shows the collision boxes of each entity (red).
| show-collision-rectangles || 显示每个实体的碰撞框(红色)。
|-
|-
| show-selection-rectangles || Shows a blue box over each entity, if you hover over it, it will be selected.
| show-selection-rectangles || 在每个实体上显示一个蓝色框,如果将鼠标悬停其上,它将会被选中。
|-
|-
| show-render-rectangles || Shows a pink box over each entity, if that is on your screen, the entity will be rendered.
| show-render-rectangles || 在每个实体上显示一个粉色框,如果位于屏幕上,则该实体会被渲染。
|-
|-
| show-sticker-boxes ||
| show-sticker-boxes ||
Line 81: Line 81:
| show-entity-velocities ||
| show-entity-velocities ||
|-
|-
| show-selected-entity-advanced-tiles || Shows on which advanced tiles (2×2 tiles) the entity is registered.
| show-selected-entity-advanced-tiles || 显示实体位于哪些高级地格(2×2格)上。
|-
|-
| show-selected-input-transport-belts || Shows which entities input into the selected transport line.
| show-selected-input-transport-belts || 显示输入到所选传送带上的实体。
|-
|-
| show-paths || The calculated paths for the biters in different colors.
| show-paths || 以不同颜色显示虫子的计算路径。
|-
|-
| show-path-requests ||
| show-path-requests ||
|-
|-
| show-next-waypoint-bb || Shows waypoints for biters (in green), nearly the same info as the next.
| show-next-waypoint-bb || 显示虫子的路径点(绿色),与下一个选项的信息基本相同。
|-
|-
| show-target || Shows the current target of the biters (red).
| show-target || 显示虫子当前的目标(红色)。
|-
|-
| show-unit-group-info || Biter groups, which belong together (circles and lines belonging together)
| 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 || Display a flying "repathed" text over a train whenever it repaths.
| show-train-repathing || 当火车重新规划路径时,在列车上方显示悬浮的“重新规划路径”文本。
|-
|-
| show-network-connected-entities || Displays the network-id of the electric network that a pole is connected to
| show-network-connected-entities || 显示电线杆连接的电网的编号。
|-
|-
| show-circuit-network-numbers || Shows the number (and color) of circuit networks
| show-circuit-network-numbers || 显示信号网络的编号(及颜色)。
|-
|-
| show-energy-sources-networks || Which network-id an entity is connected to.
| show-energy-sources-networks || 显示实体接入的电网的编号。
|-
|-
| show-active-state || Inserters, fish, turrets are turned to passive, if not used; Red = inactive, Purple = inactive when enemies aren't around (turrets etc), Green = inactive when player isn't around (fish). Passive entities consume less CPU power.
| show-active-state || {{Translation|Inserters}}、{{Translation|Raw fish}}、{{Translation|Turrets}}在未使用时将转入非活动状态。红色 = 不活动,紫色 = 附近无敌人时不活动(炮塔等),绿色 = 附近无玩家时不活动(鲜鱼)。非活动实体可以消耗更少的CPU资源。
|-
|-
| show-wakeup-lists || When an entity is sleeping in another entity it shows which entities it's sleeping in.
| 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 || 显示地图上每个区域所绘制的区块变体(1、2 或 4 个区块大小)。较为混乱,请放大查看具体含义。
| 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 || 聊天框将显示额外信息。 [https://forums.factorio.com/viewtopic.php?p=567834#p567834]
| 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

例如,调试模式可以用于:

  • 查看撕咬虫的来路,以及它们计划攻击的目标;
  • 查看光标的位置/坐标;
  • 查看区块组成的网格;
  • 查看与游戏进程无关的附加信息。如每秒刷新数(UPS)和帧率(FPS)。

注意: 除了这个内部调试工具之外,还有社区贡献的第三方调试工具,这可以在官方论坛上的模组开发工具版区获取。

激活调试模式

调试等级共分为两级:

  • Always - 如果没有选择任何模式,这便是默认模式。此模式只保留少量活动选项。
  • Debug - 按F5键切换。允许切换调试覆盖层。

配置调试模式

要配置上述的两个模式,请按F4。这将打开一个包含许多选项的菜单,如果它遮挡了某些有趣的内容,玩家可以用鼠标移动该菜单。可以在两个菜单之间切换,对应该调试模式的选项(AlwaysDebug)。每个模式都可以根据用户的喜好进行配置,不同模式只是为了方便使用。可按下CTRL + F进行搜索。

调试选项以及功能

选项 描述
show-fps 将显示当前的每秒帧数和每秒刷新数,缩写为FPSUPS。正常情况下这两个值应当为60左右。
show-clock 显示实时时钟。
show-detailed-info
  • 显示光标在(及其分区)的位置。
  • 当前分辨率和缩放比例。
  • 屏幕上有多少个物体(由显卡绘制)。
  • 游戏中使用了多少实体、区块和路径。
show-time-usage
  • 一些内部计算所需时间的内部统计,单位为毫秒/
  • 显示的统计数据为最近100刻中的平均值/最小值/最大值,统计的时长可以通过 /perf-avg-frames命令进行更改。
  • 最小值不包括零(例如,没有模组钩子运行的时刻)。
  • 汇总计算的延迟值(其中一些是并行的)必须低于16.6毫秒,以在1倍速游戏时维持每秒60刻的正常帧率。
  • 本项目的最顶层部分涵盖了更广泛的游戏引擎活动,中间的“Update”部分与在1刻中运行的模拟运算相关。底部的“Map Generator”部分则与地图生成活动相关。如需了解更多详情,请参阅:教程:优化游戏性能
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]