命令行参数

本页面的内容:

概述

命令行参数是一连串的关键字字符串,当运行可执行文件时可以通过命令行或者可执行文件的快捷方式将其传入。它们的目的是自定义引擎运行的方式,以便符合开发人员或用户的需要。这可以像使得运行编辑器而不运行游戏那么简单;或它也可以更加复杂,比如使用某个特定的地图在指定的分辨率和帧频率下启动游戏,同时把每帧转存到一个单独的图像文件中。

模式

这些参数强制主编辑器可执行程序(UE4Editor.exe) 以使用未烘焙内容的游戏或服务器来运行。

这些命令是不区分大小写的。

示例:

UE4Editor.exe -game
参数 描述
-game 使用未烘焙内容来启动游戏。
-server 将游戏作为使用未烘焙内容的服务器来运行。

URL参数

URLs可以传入到可执行命令中来强制游戏在启动时加载特定的地图。这些参数也可以和 SERVER或EDITOR模式结合使用来使用特定的地图运行编辑器或服务器。传入URL参数是可选的,但是该参数必须紧跟在可执行命令名称的后面或者如果存在任何模式开关则紧跟在该模式开关的后面。

URL由两部分组成: 地图名称或服务器IP地址以及一系列的可选的附加参数。地图名称可以是使放在Maps目录中的任何地图的名称。这里是否包含文件扩展名(也就是, .umap)是可选的。要想加载在Maps目录中不能找到的地图,那么可以使用来自于Maps目录的绝对路径或相对路径。在这种情况下,则强制包含文件扩展名。服务器IP地址是一个标准的4-部分IP地址,即由0到255之间的4个值组成,这些数值之间用句号分隔。其它的选项通过把它们附加到地图名称或服务器IP地址的后面来指定。每个选项都使用‘?’作为前缀,并且可以使用'='来设置值。使用'-'来启动选项将会把该选项从缓存的URL选项中移除。

示例:

MyGame.exe /Game/Maps/MyMap
UE4Editor.exe MyGame.uproject /Game/Maps/MyMap?game=MyGameInfo -game
UE4Editor.exe MyGame.uproject /Game/Maps/MyMap?listen -server
MyGame.exe 127.0.0.1

一般选项

参数 描述
game 告诉引擎要使用的GameInfo类(覆盖默认的值)。
name 使用的玩家名称。

服务器选项

参数 描述
listen 指定服务器作为监听服务器。
bIsLanMatch 设置多玩家游戏是否在本地网络上(比如 bIsLanMatch=0 )。
bIsFromInvite 定义该玩家的加入受到了邀请。
spectatoronly 以观看模式启动游戏。

开关

根据特定关键字的及它的应用目的的不同,这些参数可以传入到游戏或编辑器中。有些参数是一般的开关(也就是-UNATTENDED),而其它的参数是设置开关,它们是“键=值”对(也就是-LOG=MyLog.txt)。这些命令是大小写不敏感的。传入普通的开关的语法是在每个参数前面加上一个减号(‘-’),然后后面紧跟上那个参数。设置开关除了服务器开关外,其它的不需要以 ‘-‘开头。

示例:

UE4Editor.exe -silent LOG=MyLog.txt

开发者

渲染

网络

用户

服务器开关

游戏状态/数据库

INI/设置文件

可以使用另一个命令行参数来临时地覆盖游戏或编辑器加载的INI文件。比如,如果使用了一个自定义的'MyGame.ini' 文件而不是'UDKGame.ini',那么该参数将为(也就是-GAMEINI=MyGame.ini )。这个表格列出了UE4中用于覆盖不同的INI文件的参数。

命令行参数 INI覆盖
DEFEDITORINI= Default Editor
EDITORINI= Editor
DEFEDITORUSERSETTINGSINI= Default EditorUserSettings
EDITORUSERSETTINGSINI= EditorUserSettings
DEFCOMPATINI= Default Compat
COMPATINI= Compat
DEFLIGHTMASSINI= Default Lightmass
LIGHTMASSINI= Lightmass
DEFENGINEINI= Default Engine
ENGINEINI= Engine
DEFGAMEINI= Default Game
GAMEINI= Game
DEFINPUTINI= Default Input
INPUTINI= Input
DEFUIINI= Default UI
UIINI= UI

调试

其它