UE4 配置文件

最新推荐文章于 2024-07-27 15:30:42 发布
最新推荐文章于 2024-07-27 15:30:42 发布
阅读量4.8k 收藏 2
点赞数 1
分类专栏： 游戏引擎 Unreal 开发工具 引擎工具 游戏开发 图形引擎 手机游戏
游戏引擎 同时被 3 个专栏收录
1659 篇文章 22 订阅
订阅专栏
游戏开发
1649 篇文章 12 订阅
订阅专栏
图形引擎
1623 篇文章 23 订阅
订阅专栏


Programming Basics

版本: 4.9

On this page:

配置文件可以用于设置加载时要初始化的属性的值。配置是由成对的键值来决定的，按部分排列。 一个特定的键可以和一个或多个值相关联。

引擎配置文件用来作为对象和变量的默认值。用户输入配置可用于按键绑定。默认情况下，当您使用 项目向导 新建空白项目时， 将会创建DefaultEngine.ini和DefaultGame.ini 文件。如果需要，使用模板来创建的新项目也可以生成DefaultEditor.ini和 DefaultInput.ini 配置文件。

SaveConfig()函数可以在使用配置类修饰符的类上进行调用。这可以保存使用Config属性修饰符 标记的任意属性到适当的配置文件中。一般来说，由SaveConfig()保存的变量位于按照格式 [(package).(classname)] 命名的部分标题中。例如，DefaultEngine.ini 中的[/Script/Engine.Engine] 部分指向存储在 Engine包内部的 Engine 类。 硬编码的部分名称将会有一些例外。

之前仅通过编辑配置文件可用的一些设置现在可以在Project Settings编辑器的虚幻编辑器中使用。

定义可配置变量

为指出应该从配置文件中读取哪个变量，那么在包含这些变量的类在其UCLASS宏中应赋予Config标识符。

UCLASS(Config=Game)
class AExampleClass : public AActor

请注意必须为 Config 标识符提供类别（比如Game（游戏））。这确定了从哪个配置文件中读取类的变量及将其保存到哪个配置文件中。所有可能的分类都在FConfigCacheIni中进行定义。 如需获得所有配置文件分类的列表，请参阅配置分类。

使用Config标识符来修饰类表明此类可以从配置文件中读取变量，并指出了从哪个文件中读取配置信息。要想 指定读取和保存到配置文件中的某个变量，也必须为UPROPERTY()宏提供Config标识符。

UCLASS(Config=Game)
class AExampleClass : public AActor
{
GENERATED_UCLASS_BODY()

UPROPERTY(Config)
float ExampleVariable;

};

对属性的Config标识符不提供任何分类。ExampleVariable属性现在可以从配置文件结构的任意Game配置文件中读取， 只要信息由以下语法所指定：

[/Script/ModuleName.ExampleClass]
ExampleVariable=0.0f

配置文件和继承

Config UCLASS和UPROPERTY标识符都将被子类继承。这表示子类可以读取或保存父类中指定为Config的所有变量，并且它们 将会位于相同的配置文件分类中。变量都会位于具有子类名称的部分下。例如，继承 ExampleClass 的 ChildExampleClass 的配置文件信息 看起来如下方的代码行，并且将被保存在同一个Game配置文件中。

[/Script/ModuleName.ChildExampleClass]
ExampleVariable=0.0f

基于每个实例的配置

虚幻引擎 4 可以把一个对象的配置文件保存到任何所需的配置文件中。如果 PerObjectConfig 标识符用于 UCLASS 宏， 那么这个类的配置信息将会基于每个实例进行存储，其中每个实例在 .ini 文件中都有一部分，该文件以这个对象的名字命名，格式如下 [ObjectName ClassName]。 这个关键字会传递给子类。?

配置文件结构

每个配置分类都有文件层次结构，它指定了特定引擎、项目和平台的配置。

配置分类

  • Compat（兼容性）

  • DeviceProfiles（设备概述文件）

  • Editor（编辑器）

  • EditorGameAgnostic（编辑器游戏不可知论）

  • EditorKeyBindings（编辑器按键绑定）

  • EditorUserSettings（编辑器用户设置）

  • Engine(引擎)

  • Game(游戏)

  • Input（输入）

  • Lightmass

  • Scalability（可扩展性）

文件层次结构

配置文件读入时从Base.ini开始，文件结构中后面文件内的值覆盖之前的值。Engine文件夹中的文件将应用于 所有项目，而针对特定项目的文件应该位于项目目录中的文件内。最后，所有特定项目和特定平台的差异都被保存到 [ProjectDirectory]/Saved/Config/[Platform]/[Category].ini文件中。

以下是配置文件的Engine类目的文件层次结构示例。

  1. Engine/Config/Base.ini

    Base.ini通常是空的。

  2. Engine/Config/BaseEngine.ini

  3. Engine/Config/[Platform]/[Platform]Engine.ini

  4. [ProjectDirectory]/Config/DefaultEngine.ini

  5. [ProjectDirectory]/Config/[Platform]/[Platform]Engine.ini

  6. [ProjectDirectory]/Saved/Config/[Platform]/Engine.ini

    Saved 目录中的配置文件仅仅将特定项目和特定平台的差异存储到配置文件堆栈中。

应用配置文件

文件格式

部分和键-值对

一般的配置文件由成块的 键-值 对组成，如下所示：

[Section]
Key=Value
特殊字符

  • + - 如果该属性还不存在则添加一行（从前一个 .ini 文件或者同一个 .ini 文件的前面的部分）。

  • - - 删除一行（但是它必须是精确匹配）。

  • . - 添加一个新属性。

  • ! - 删除一个属性；但是不必是精确匹配，仅需要匹配属性的名称即可。

注意 ： . . 和 + 类似的，只是 . 可以添加一个重复的行。这对绑定是有用的（正如在 DefaultInput.ini 中所看到的），比如，其中最底部的绑定生效，所以如果您添加了类似于以下的东西：

[/Script/Engine.PlayerInput]
Bindings=(Name="Q",Command="Foo")
.Bindings=(Name="Q",Command="Bar")
.Bindings=(Name="Q",Command="Foo")

它将可以正确地工作。但是如果使用 + 则不能添加最后一行，且您的绑定将是错误的。由于配置文件组合，所以将会发生上面的应用形式。

注释

大多数人似乎都会觉得配置文件中的分号表示注释，但是实际上不是 (FConfigFile::ProcessInputFileContents 并不会真正地处理它们，或者任何其它作为注释分界符的字符串）。这种行为是故意设计的。从技术上讲，任何字符都可以代表任何一种不同的键值对。通常，会在新的一行的行首放置一个分号。它的功能像是注释，但事实上它不是。

; This is a Comment
; So is this!
Programming Basics

版本: 4.9

On this page:

配置文件可以用于设置加载时要初始化的属性的值。配置是由成对的键值来决定的，按部分排列。 一个特定的键可以和一个或多个值相关联。

引擎配置文件用来作为对象和变量的默认值。用户输入配置可用于按键绑定。默认情况下，当您使用 项目向导 新建空白项目时， 将会创建DefaultEngine.ini和DefaultGame.ini 文件。如果需要，使用模板来创建的新项目也可以生成DefaultEditor.ini和 DefaultInput.ini 配置文件。

SaveConfig()函数可以在使用配置类修饰符的类上进行调用。这可以保存使用Config属性修饰符 标记的任意属性到适当的配置文件中。一般来说，由SaveConfig()保存的变量位于按照格式 [(package).(classname)] 命名的部分标题中。例如，DefaultEngine.ini 中的[/Script/Engine.Engine] 部分指向存储在 Engine包内部的 Engine 类。 硬编码的部分名称将会有一些例外。

之前仅通过编辑配置文件可用的一些设置现在可以在Project Settings编辑器的虚幻编辑器中使用。

定义可配置变量

为指出应该从配置文件中读取哪个变量，那么在包含这些变量的类在其UCLASS宏中应赋予Config标识符。

UCLASS(Config=Game)
class AExampleClass : public AActor

请注意必须为 Config 标识符提供类别（比如Game（游戏））。这确定了从哪个配置文件中读取类的变量及将其保存到哪个配置文件中。所有可能的分类都在FConfigCacheIni中进行定义。 如需获得所有配置文件分类的列表，请参阅配置分类。

使用Config标识符来修饰类表明此类可以从配置文件中读取变量，并指出了从哪个文件中读取配置信息。要想 指定读取和保存到配置文件中的某个变量，也必须为UPROPERTY()宏提供Config标识符。

UCLASS(Config=Game)
class AExampleClass : public AActor
{
GENERATED_UCLASS_BODY()

UPROPERTY(Config)
float ExampleVariable;

};

对属性的Config标识符不提供任何分类。ExampleVariable属性现在可以从配置文件结构的任意Game配置文件中读取， 只要信息由以下语法所指定：

[/Script/ModuleName.ExampleClass]
ExampleVariable=0.0f

配置文件和继承

Config UCLASS和UPROPERTY标识符都将被子类继承。这表示子类可以读取或保存父类中指定为Config的所有变量，并且它们 将会位于相同的配置文件分类中。变量都会位于具有子类名称的部分下。例如，继承 ExampleClass 的 ChildExampleClass 的配置文件信息 看起来如下方的代码行，并且将被保存在同一个Game配置文件中。

[/Script/ModuleName.ChildExampleClass]
ExampleVariable=0.0f

基于每个实例的配置

虚幻引擎 4 可以把一个对象的配置文件保存到任何所需的配置文件中。如果 PerObjectConfig 标识符用于 UCLASS 宏， 那么这个类的配置信息将会基于每个实例进行存储，其中每个实例在 .ini 文件中都有一部分，该文件以这个对象的名字命名，格式如下 [ObjectName ClassName]。 这个关键字会传递给子类。?

配置文件结构

每个配置分类都有文件层次结构，它指定了特定引擎、项目和平台的配置。

配置分类

  • Compat（兼容性）

  • DeviceProfiles（设备概述文件）

  • Editor（编辑器）

  • EditorGameAgnostic（编辑器游戏不可知论）

  • EditorKeyBindings（编辑器按键绑定）

  • EditorUserSettings（编辑器用户设置）

  • Engine(引擎)

  • Game(游戏)

  • Input（输入）

  • Lightmass

  • Scalability（可扩展性）

文件层次结构

配置文件读入时从Base.ini开始，文件结构中后面文件内的值覆盖之前的值。Engine文件夹中的文件将应用于 所有项目，而针对特定项目的文件应该位于项目目录中的文件内。最后，所有特定项目和特定平台的差异都被保存到 [ProjectDirectory]/Saved/Config/[Platform]/[Category].ini文件中。

以下是配置文件的Engine类目的文件层次结构示例。

  1. Engine/Config/Base.ini

    Base.ini通常是空的。

  2. Engine/Config/BaseEngine.ini

  3. Engine/Config/[Platform]/[Platform]Engine.ini

  4. [ProjectDirectory]/Config/DefaultEngine.ini

  5. [ProjectDirectory]/Config/[Platform]/[Platform]Engine.ini

  6. [ProjectDirectory]/Saved/Config/[Platform]/Engine.ini

    Saved 目录中的配置文件仅仅将特定项目和特定平台的差异存储到配置文件堆栈中。

应用配置文件

文件格式

部分和键-值对

一般的配置文件由成块的 键-值 对组成，如下所示：

[Section]
Key=Value
特殊字符

  • + - 如果该属性还不存在则添加一行（从前一个 .ini 文件或者同一个 .ini 文件的前面的部分）。

  • - - 删除一行（但是它必须是精确匹配）。

  • . - 添加一个新属性。

  • ! - 删除一个属性；但是不必是精确匹配，仅需要匹配属性的名称即可。

注意 ： . . 和 + 类似的，只是 . 可以添加一个重复的行。这对绑定是有用的（正如在 DefaultInput.ini 中所看到的），比如，其中最底部的绑定生效，所以如果您添加了类似于以下的东西：

[/Script/Engine.PlayerInput]
Bindings=(Name="Q",Command="Foo")
.Bindings=(Name="Q",Command="Bar")
.Bindings=(Name="Q",Command="Foo")

它将可以正确地工作。但是如果使用 + 则不能添加最后一行，且您的绑定将是错误的。由于配置文件组合，所以将会发生上面的应用形式。

注释

大多数人似乎都会觉得配置文件中的分号表示注释，但是实际上不是 (FConfigFile::ProcessInputFileContents 并不会真正地处理它们，或者任何其它作为注释分界符的字符串）。这种行为是故意设计的。从技术上讲，任何字符都可以代表任何一种不同的键值对。通常，会在新的一行的行首放置一个分号。它的功能像是注释，但事实上它不是。

; This is a Comment
; So is this!
pizi0475
关注
专栏目录
UE4 Config配置文件详解（2017.4.1更新）
Jerish的博客
10-13 3万+
之前文档中的错误已经更正，欢迎大家随时指出文章的不足。 （如果只是想了解如何使用，直接看第三章节就可以了） 一 配置总体概述 UE4中，配置文件（Config）其实就是.ini文件。可以用于设置加载时要初始化的属性的值，配置信息按照键值对的格式来实现。虚幻4官方文档只有简单的使用规则，要想深入了解还需要查看源代码才行，所以这里我把自己的学习成果分享给大家。一个完整的配置文件格式如下图1-1所...
ue4读取配置文件_UE4中的配置文件
weixin_29698641的博客
01-30 3314
UE4中的配置文件包含用于配置游戏进程或引擎行为的属性设置的文本文件。配置文件可用于为加载项目时将初始化的属性设置值。配置由按分段排列的键-值对决定。 单个给定键可以与一个或多个值相关联。引擎配置文件用于对象和变量的默认值。用户输入配置可用于键绑定。默认情况下，当您使用 项目向导（Project Wizard） 创建新的空白项目时， 将创建DefaultEngine.ini和DefaultGame...
UE4添加配置文件
u012789157的博客
08-19 1034
记性越来越差了还是要记录一下 在DefaultGame.ini中添加 [Staging] +WhitelistConfigFiles=[ProjectName]/Config/[ConfigFileName].ini
【UE4】引擎配置文件原理学习笔记
Talk is cheap. So look at my blog.
12-09 1284
为什么saved同级目录下面有一个config，saved里面还有一个config：saved/config？它们有什么区别吗？为什么虚幻加载配置文件的以后还要写文件？记录虚幻配置文件层级和读取流程
UE4 Ini配置文件的层级
最新发布
sinat_23135151的博客
07-27 1221
UE4采用“Ini层级”的概念，让引擎、项目具有默认的配置值、逐项目的配置值、逐实际运行的实例的配置值（Saved下）、甚至是和本地环境相关的配置值。本文还找到了相关代码与运行结果进行学习。
UE4添加自定义配置文件信息
qq_43034470的博客
02-25 2397
创建一个UObject子类，将需要配置的变量实现在其中，UClass中的两个设置可以自己更改，变量宏需添加config #pragma once #include "CoreMinimal.h" #include "UObject/Object.h" #include "CrashToolRuntimeSetting.generated.h" /** * */ UCLASS(Config = Engine , defaultconfig) class CRASHTOOL_API UCrashToo
UE4 nDisplay配置文件（裸眼3D效果）
05-27
“帧顺序”模式实现裸眼3D效果
UE4 C++（18）：配置文件
weixin_44200074的博客
12-06 1478
配置文件的读写
UE4变量Config设置
weixin_44840850的博客
06-17 765
UE4Config设置变量
【待续】【UE4笔记】 L1创建并配置项目
lee2813的博客
02-10 292
Unreal中Input的设定
茶向
09-02 1885
首先在编辑器中，Settting->ProjectSettings->Input中设置 然后代码的 // Called to bind functionality to input void AAvatar::SetupPlayerInputComponent(class UInputComponent* InputComponent) { Super::SetupPlayerInp
UE4基础篇001——最低配置要求
qq_17230607的博客
10-13 6991
UE4基础篇001——最低配置要求
关于UE4创建自定义配置文件/配置项的记录
J.Shaw's Blog
04-10 3845
声明 本文不做过多深入的解释，以使用为目的。 使用方法 声明定义一个继承自UObject的配置类，类中需声明宏UCLASS(config = ConfigFileName, configdonotcheckdefaults); 声明定义配置参数，需带上宏UPROPERTY(Config, EditAnywhere, Category = Custom)，如果需要设置默认值，可在类的构造函数中对变...
UE4 学习之路(一) 变量设置面板可见
我知道你很急,但是路要一步步走
05-19 2498
Unity里需要将一个变量设置为面板可见只需要将这个变量设置为 public,如果是私有变量可以添加序列化私有字段 [Serializefield] UE4中如果是蓝图: 点击新增一个 Variable ,再点击 右下角的小眼睛,注意编译保存一下你的蓝图,拖拽到关卡中,即可在面板上看到和修改这个变量 UE4中如果是C++类变量: 在变量上方添加如下字段就行,公有变量和私有变量都一...
UE4 中可全局获取的变量（例如游戏实例、玩家控制器等） 详解
hhw_hhw的博客
10-25 3328
游戏实例，它负责保存和共享游戏的全局数据和状态。可以在项目中创建自定义的UGameInstance子类，通过GetGameInstance函数获取当前的游戏实例，并使用其中的变量来存储和访问全局数据。GameInstance是UE4中的全局类，只有一个实例（就像是单例设计模式，只有一个对象）GameInstance常用的函数与用法Event Init（事件初始）与（事件关闭），引擎初始化与关闭时执行的逻辑。!
UE3 的Config文件夹
u012138730的专栏
07-23 1188
工作中需要用到UE3，看官方文档中文版翻译有些偷懒和翻译不妥当，故看着英文自己翻译理解了一下，以供后续参考。 目录 基础内容 0.概述 1.uc脚本中的类定义关联配置文件和保存 2.保存配置文件API SaveConfig() StaticSaveConfig() 3.ucc 编译的时候使用 4.配置文件类型 Default 配置文件 和 XXX 配置文件 Base 配置...
UE4 打包 Config文件配置
DuGuYiZhao的博客
11-02 2520
UE4 打包 Config文件配置： 1.黑名单：防止打包Config文件到*.pak中 （1）Default.ini 追加要排除的文件： [Staging] +BlacklistConfigFiles=UE_JiangYinYanJiang/Config/DefaultEngine.ini +BlacklistConfigFiles=UE_JiangYinYanJiang/Config/DefaultGame.ini +BlacklistConfigFiles=UE_JiangYinYanJiang/
Unreal Engine 4：学习笔记（十二）Configuration
netyeaxi的专栏
01-25 455
如何使用UE4中的配置信息。
ue c++ 配置文件
07-29
UE4中的配置文件是用来设置和调整游戏或项目的各种参数和选项的重要文件。它们帮助开发者在不改变源代码的情况下进行游戏或项目的自定义设定。UE4中有很多不同的配置文件，其中一个重要的配置文件是UE.ini文件。 UE...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值