This translation is community contributed and may not be up to date. We only maintain the English version of the documentation. Read this manual in English
文件 game.project 包含所有项目级别的设置。它必须保存在项目的根文件夹中,并且必须命名为 game.project。引擎在启动和运行您的游戏时做的第一件事就是查找这个文件。
文件中的每个设置都属于一个类别。当您打开文件时,Defold 会将所有设置按类别分组展示。

game.project 中的设置通常在 Defold 内部修改,但该文件也可以在任何标准文本编辑器中编辑。该文件遵循 INI 文件格式标准,如下所示:
[category1]
setting1 = value
setting2 = value
[category2]
...
一个真实的例子是:
[bootstrap]
main_collection = /main/main.collectionc
这意味着设置 main_collection 属于 bootstrap 类别。每当使用文件引用时(如上面的例子),路径需要附加一个 ‘c’ 字符,这意味着您引用的是文件的编译版本。还要注意,包含 game.project 的文件夹将成为项目根目录,这就是为什么在设置路径中有一个初始 ‘/’。
可以在运行时使用 sys.get_config_string(key)、sys.get_config_number(key)、sys.get_config_int(key) 和 sys.get_config_boolean(key) 从 game.project 中读取值。例如:
local title = sys.get_config_string("project.title")
local gravity_y = sys.get_config_number("physics.gravity_y")
local fullscreen = sys.get_config_boolean("display.fullscreen", false)
键是类别和设置名称的组合,用点分隔,并用小写字母书写,任何空格字符用下划线替换。例子:“Project”类别中的“Title”字段变成 project.title,“Physics”类别中的“Gravity Y”字段变成 physics.gravity_y。
下面是所有可用的设置,按类别排列。
应用程序的标题。
应用程序的版本。
发布商名称。
开发商名称。
控制引擎何时写入日志文件。选项:
如果从编辑器运行多个实例,文件将被命名为 instance_2_log.txt,其中 2 是实例索引。如果运行单个实例或从打包运行,文件将被命名为 log.txt。日志文件的位置将是以下路径之一(按顺序尝试):
NSDocumentDirectoryContext.getExternalFilesDir()NSApplicationSupportDirectoryCSIDL_APPDATA (例如 C:\Users\<username>\AppData\Roaming)Context.getFilesDir()HOME 环境变量指定日志系统的最低日志级别。只有在此级别或以上的日志才会显示。
在打包时启用存档压缩。请注意,这目前适用于除 Android 以外的所有平台,因为 apk 已经包含所有压缩数据。
项目 库 URL 的 URL 列表。有关更多信息,请参阅库手册。
project.dependencies_metadata 在运行时包中包含库依赖项的元数据。默认禁用。可以在运行时使用 sys.load_resource("/.internal/dependencies.json") 读取这些元数据。
custom_resources
自定义资源通过 game.project 中的自定义资源字段捆绑到主游戏存档中。
自定义资源字段应包含将包含在主游戏存档中的以逗号分隔的资源列表。如果指定了目录,则该目录中的所有文件和目录都将被递归包含。您可以使用sys.load_resource()读取这些文件。
加载自定义资源在文件访问手册中有更详细的介绍。
扩展通过 ext.properties 中的 custom_resources.default 提供的路径会与此设置合并。示例请参阅扩展的自定义资源。
bundle_resources
捆绑资源是使用 game.project 文件中的Bundle Resources 字段作为应用程序包一部分存放的附加文件和文件夹。
Bundle Resources 字段应包含一个以逗号分隔的目录列表,这些目录包含资源文件和文件夹,在打包时应原样复制到最终包中。目录必须使用从项目根目录开始的绝对路径指定,例如 /res。资源目录必须包含以 platform 或 architecture-platform 命名的子文件夹。
支持的平台有 ios、android、osx、win32、linux、web、switch。还允许使用名为 common 的子文件夹,其中包含所有平台通用的资源文件。示例:
res
├── win32
│ └── mywin32file.txt
├── common
│ └── mycommonfile.txt
└── android
├── myandroidfile.txt
└── res
└── xml
└── filepaths.xml
您可以使用 sys.get_application_path() 来获取应用程序存储的路径。使用此应用程序基本路径来创建您需要访问的文件的最终绝对路径。一旦获得这些文件的绝对路径,您就可以使用 io.* 和 os.* 函数来访问这些文件。
加载打包资源在文件访问手册中有更详细的介绍。
bundle_exclude_resources
一个逗号分隔的资源列表,这些资源不应包含在打包中。即,它们从 bundle_resources 步骤的集合结果中被删除。
用于启动应用程序的集合文件引用,默认为 /logic/main.collection。
要使用的渲染设置文件,它定义了渲染管道,默认为 /builtins/render/default.render。
应通过库共享从您的项目中共享的目录的空格分隔列表。有关更多信息,请参阅库手册。
library.defold_min_version 指定将此项目用作库所需的最低 Defold/Bob 版本,例如 1.11.2。留空表示不限制最低版本。
允许引擎在应用程序窗口最小化时继续运行(仅限桌面平台)。
fixed_update(self, dt) 生命周期函数的更新频率。以赫兹为单位。
如果单帧期间时间步长变得太大,它将被限制为此最大值。以秒为单位。
在桌面平台上,从编辑器打开的引擎窗口可以恢复此前运行时保存的大小。选择 Debug ▸ Reset Simulated Resolution 可清除记住的大小并恢复配置尺寸,同时保留保存的窗口位置。详见引擎窗口位置与重置。
应用程序窗口的宽度(以像素为单位)。
应用程序窗口的高度(以像素为单位)。
在支持的显示器上创建高 dpi 后缓冲区。通常游戏将以比宽度和高度设置中设置的分辨率高一倍的分辨率渲染,这仍然是脚本和属性中使用的逻辑分辨率。
在 HTML5 上,启用此设置时,可使用 Min Pixel Ratio 和 Max Pixel Ratio 限制渲染比例。
用于超级采样抗锯齿的样本数量。它设置 GLFW_FSAA_SAMPLES 窗口提示。值为 0 表示关闭抗锯齿。
此设置控制窗口的抗锯齿。离屏的多重采样渲染目标有自己的采样数。
勾选应用程序是否应全屏启动。如果未勾选,应用程序将在窗口模式下运行。
所需的帧率(以赫兹为单位)。设置为 0 表示可变帧率。大于 0 的值将导致固定帧率,在运行时上限为实际帧率(这意味着您不能在引擎帧中更新游戏循环两次)。使用 sys.set_update_frequency(hz) 在运行时更改此值。此设置也适用于无头构建。
此整数值控制应用程序如何处理垂直同步。0 禁用垂直同步,默认值为 1。使用 OpenGL 适配器时,此值设置窗口应在缓冲区交换之间更新的帧数。对于 Vulkan,没有内置的交换间隔概念,该值控制是否应启用垂直同步。
旧版兼容性设置。此设置已弃用;新项目请使用 Swap Interval。如果禁用,它会强制有效交换间隔为 0。如果启用,则由 Swap Interval 决定有效值。
指定要使用的显示配置文件,默认为 /builtins/render/default.display_profilesc。在GUI 布局手册中了解更多信息。
勾选应用程序是否应在设备旋转时动态切换纵向和横向。请注意,开发应用程序目前不遵守此设置。
在启动时将 GPU 信息输出到控制台。
清除颜色红色通道,由渲染脚本和创建窗口时使用。
清除颜色绿色通道,由渲染脚本和创建窗口时使用。
清除颜色蓝色通道,由渲染脚本和创建窗口时使用。
清除颜色 Alpha 通道,由渲染脚本和创建窗口时使用。
碰撞对象的最大数量。
要使用的物理类型,2D 或 3D。
沿 x 轴的世界重力。以米每秒为单位。
沿 y 轴的世界重力。以米每秒为单位。
沿 z 轴的世界重力。以米每秒为单位。
勾选是否应可视化物理以进行调试。
可视化物理的 Alpha 分量值,0–1。
并发物理世界的最大数量,默认为 4。如果您通过集合代理同时加载超过 4 个世界,则需要增加此值。请注意,每个物理世界都会分配相当多的内存。
告诉物理引擎如何相对于游戏世界缩放物理世界以获得数值精度,0.01–1.0。如果值设置为 0.02,这意味着物理引擎将把 50 个单位视为 1 米($1 / 0.02$)。
勾选物理引擎是否应将游戏对象的变换应用于任何附加的碰撞对象组件。这可用于移动、缩放和旋转碰撞形状,即使是动态的。
勾选物理引擎是否应使用固定和与帧率无关的更新。将此设置与 fixed_update(self, dt) 生命周期函数和 engine.fixed_update_frequency 项目设置结合使用,以定期与物理引擎交互。对于新项目,推荐的设置是 true。
在物理中绘制单位对象的大小,如三元组和法线。
将报告回脚本的碰撞数量。
将报告回脚本的接触点数量。
忽略值小于此设置的接触冲量。
每帧 2d 射线投射请求的最大数量。
每帧 3d 射线投射请求的最大数量。
重叠物理触发器的最大数量。
将导致弹性碰撞的最小速度。
使用固定时间步长时模拟中的最大步数(仅限 3D)。
指定用于缩小过滤的过滤方式。
指定用于放大过滤的过滤方式。
渲染调用的最大数量。
文本渲染缓冲区中预分配的字符数,即每帧可以显示的字符数。
每帧可以显示的文本批次的最大数量。
调试顶点的最大数量。用于物理形状渲染等。
用于此项目的纹理配置文件,默认为 /builtins/graphics/default.texture_profiles。
验证每次图形调用后的返回值并在日志中报告任何错误。
graphics.webgl_version_hint 选择 HTML5 要请求的 WebGL 上下文版本。有效值为 1(WebGL 1)和 2(WebGL 2,默认值)。设为 1,即使浏览器支持 WebGL 2,也可以针对 WebGL 1 开发或测试。面向 WebGL 1 时,请禁用 Exclude GLES 2.0,以包含所需着色器。
OpenGL 上下文版本提示。如果选择了特定版本,这将用作所需的最低版本(不适用于 OpenGL ES)。
创建上下文时设置 ‘core’ OpenGL 配置文件提示。核心配置文件删除了 OpenGL 的所有已弃用功能,例如立即模式渲染。不适用于 OpenGL ES。
graphics.vulkan_version_major 是 Vulkan 上下文/API 主版本提示。仅在选择 Vulkan 图形后端时适用。默认值为 1。
graphics.vulkan_version_minor 是 Vulkan 上下文/API 次版本提示。仅在选择 Vulkan 图形后端时适用。默认值为 0。
shader.exclude_gles_sm100 排除 OpenGLES 2.0 和 WebGL 1.0 着色器。默认启用(1)。
要支持这些图形 API 或允许回退到它们,请在 game.project 中取消勾选 Shader ▸ Exclude GLES 2.0,或设置:
[shader]
exclude_gles_sm100 = 0
未显式设置此选项的项目会使用默认值。如果项目需要 OpenGLES 2.0 或 WebGL 1.0 支持,请显式设为 0。
shader.glsl_es_default_precision_float 设置交叉编译的 GLSL ES 着色器中浮点值的默认全局精度限定符。有效值为 mediump 和 highp;默认为 mediump。
shader.glsl_es_default_precision_int 设置交叉编译的 GLSL ES 着色器中整数值的默认全局精度限定符。有效值为 mediump 和 highp;默认为 highp。
等待按住输入开始重复的秒数。
按住输入的每次重复之间等待的秒数。
游戏手柄配置文件的文件引用,它将游戏手柄信号映射到操作系统,默认为 /builtins/input/default.gamepads。
input.gamepad_database 选择 SDL 格式的游戏手柄映射数据库(.txt)。默认为 /builtins/input/gamecontrollerdb.txt。构建项目时,其中的映射会与 Gamepads 文件中的映射合并。
input.gamepad_deadzone 设置在运行时应用于 SDL 游戏手柄数据库映射的死区。默认值为 0.2。
输入配置文件的文件引用,它将硬件输入映射到操作,默认为 /input/game.input_binding。
勾选以使引擎每帧接收加速计输入事件。禁用加速计输入可能会带来一些性能好处。
如果勾选,将为通过网络更快地加载资源到设备上运行的引擎启用 HTTP 缓存。
在哪里找到项目构建数据,采用 URI 格式。
可以同时加载的资源的最大数量。
resource.profile 启用资源加载计时,并为每次完成或失败的加载输出 INFO 级别日志。默认禁用(0)。请在启动游戏前启用(1),以测量启动加载。资源分析器显示当前已加载资源保留的首次加载测量值;点击 Capture,再点击 Show load times 进行检查。各耗时列及其解读请参阅资源加载耗时。
HTTP 超时(以秒为单位)。设置为 0 以禁用超时。
HTTP 服务的工作线程数。
勾选以启用网络请求的 HTTP 缓存(使用 http.request())。HTTP 缓存将存储与请求关联的响应,并为后续请求重用存储的响应。HTTP 缓存支持 ETag 和 Cache-Control: max-age HTTP 响应头。
包含在 SSL 握手期间验证证书链时要使用的 SSL 根证书的文件。
集合中游戏对象实例的最大数量,默认为 1024。(参见组件最大数量优化的信息)。
输入堆栈中游戏对象的最大数量。
全局增益(音量),0–1。
如果启用,增益是线性的。如果禁用,使用指数曲线。
声音资源的最大数量,即运行时唯一声音文件的数量。
(当前未使用)并发声音缓冲区的最大数量。
(当前未使用)并发播放声音的最大数量。
并发声音实例的最大数量,即同时播放的实际声音。
每个集合的声音组件的最大数量。
每次音频更新使用的样本数。0 表示自动(48 kHz 为 1024,44.1 kHz 为 768)。
如果勾选,声音系统将使用线程进行声音播放,以减少主线程负载过重时的卡顿风险。
如果勾选,声音系统将使用流式传输来加载源文件。
包含_所有_块的声音块缓存的最大大小。默认为 2097152 字节。
此数字应该大于加载的声音文件数乘以流块大小。
否则,您就有风险每帧都要逐出新块。
流音频的块大小(以字节为单位)。
流音频的预加载大小(以字节为单位)。
精灵组件的最大数量。(参见组件最大数量优化的信息)。
允许精灵子像素定位。
瓦片地图组件的最大数量。(参见组件最大数量优化的信息)。
瓦片的最大数量。
Spine 模型组件的最大数量。(参见组件最大数量优化的信息)。
网格组件的最大数量。(参见组件最大数量优化的信息)。
模型组件的最大数量。(参见组件最大数量优化的信息)。
将具有多个材质的网格拆分为多个网格。启用时,拥有多个材质的模型将被分解为每个材质一个网格。禁用时,整个模型将使用单个材质进行渲染。
骨骼矩阵纹理的最大宽度。
骨骼矩阵纹理的最大高度。
model.max_morph_target_texture_width 设置为每个网格生成的变形目标纹理的最大宽度,以像素为单位。该纹理存储位置、法线和切线的增量。默认值为 1024。
model.max_morph_target_texture_height 设置为每个网格生成的变形目标纹理的最大高度,以像素为单位。该纹理存储位置、法线和切线的增量。默认值为 1024。
light.max_count 设置光源组件的最大数量,默认为 64。(参见组件最大数量优化的信息)。
GUI 组件的最大数量。(参见组件最大数量优化的信息)。
GUI 粒子效果的最大粒子数量。
gui.max_particlefx_count 设置每个集合中粒子 FX 节点的最大数量。默认值为 64。
GUI 动画的最大数量。
gui.safe_area_mode 选择哪些安全区域内边距会影响 GUI 调整:
none(默认):忽略内边距。long:横屏时应用左/右边距,竖屏时应用上/下边距。short:横屏时应用上/下边距,竖屏时应用左/右边距。both:应用所有四个内边距。GUI 脚本可以使用 gui.set_safe_area_mode() 为其场景覆盖此模式。有关平台支持和自定义布局,请参阅安全区域指南。
标签组件的最大数量。(参见组件最大数量优化的信息)。
允许标签子像素定位。
particle_fx.max_count 设置粒子 FX 组件的最大数量,默认为 64。(参见组件最大数量优化的信息)。
particle_fx.max_emitter_count 设置同时运行的粒子 FX 发射器的最大数量。默认值为 64。
同时存在的粒子的最大数量。此设置限制 GPU 顶点缓冲区的大小,默认为 1024 个粒子。
particle_fx.max_particle_buffer_count 设置每次上传到 GPU 的粒子数量上限。此设置限制用于生成粒子顶点的 CPU 缓冲区大小。默认值为 1024。
Box2D 求解器速度迭代。
Box2D 求解器位置迭代。
Box2D 步骤计数。
集合代理的最大数量。(有关组件最大数量优化的信息)。
集合工厂的最大数量。(有关组件最大数量优化的信息)。
游戏对象工厂的最大数量。(有关组件最大数量优化的信息)。
ios.home_indicator_mode 控制屏幕边缘的系统手势,以及游戏是否请求自动隐藏 Home Indicator。
| 值 | 系统手势 | 请求自动隐藏 |
|---|---|---|
deferred(默认值) |
通过延迟系统手势保护所有屏幕边缘。返回主屏幕需要滑动两次。 | 否 |
system |
使用正常系统手势,允许一次滑动返回主屏幕。 | 否 |
auto_hide |
使用正常系统手势,允许一次滑动返回主屏幕。 | 是 |
iOS 控制指示条的实际可见性。自动隐藏只是一项请求;在 iOS 26 及更高版本上,系统可能在 system 和 auto_hide 模式下都隐藏指示条。配置示例请参阅 Home Indicator 行为。
用作给定宽度和高度尺寸 W × H 的应用图标的图像文件 (.png)。
Storyboard 文件 (.storyboard)。了解如何在 iOS 手册 中创建一个。
包含应用图标的图标资源文件 (.car)。
(iOS 6 及更早版本)如果您的图标是预渲染的,请勾选此项。如果未勾选,图标将自动添加光泽高亮。
捆绑标识符让 iOS 识别您应用的任何更新。您的捆绑 ID 必须在 Apple 注册,并且对您的应用是唯一的。您不能对 iOS 和 macOS 应用使用相同的标识符。必须由两个或多个用点分隔的段组成。每个段必须以字母开头。每个段只能包含字母数字字母、下划线或连字符 (-) 字符(参见 CFBundleIdentifier)。
捆绑短名称(15 个字符)(参见 CFBundleName)。
捆绑版本,可以是数字或 x.y.z(参见 CFBundleVersion)。
指定后,打包应用时将使用此 Info.plist 文件,替代内置 iOS 基础清单 /builtins/manifests/ios/Info.plist。使用内置模板的项目会自动获得清单更新;自定义文件则需要显式更新。
应用的 Apple 隐私清单。该字段将默认为 /builtins/manifests/ios/PrivacyInfo.xcprivacy。
如果指定,提供的配置文件(.entitlements、.xcent、.plist)中的权限将与打包应用时提供的配置文件中的权限合并。
如果应用在 Localizations 列表中没有用户的首选语言时使用的语言(参见 CFBundleDevelopmentRegion)。如果首选语言在那里可用,请使用两字母 ISO 639-1 标准或三字母 ISO 639-2。
此字段包含逗号分隔的字符串,标识支持本地化的语言名称或 ISO 语言指示符(参见 CFBundleLocalizations)。
用作给定宽度和高度尺寸 W × H 的应用图标的图像文件 (.png)。
用作 Android 上自定义推送通知图标的图像文件 (.png)。图标将自动用于本地或远程推送通知。如果未设置,默认将使用应用图标。
指定应使用哪个有效负载 JSON 字段作为通知标题。将此设置留空会使推送默认使用应用名称作为标题。
指定应使用哪个有效负载 JSON 字段作为通知文本。如果留空,将使用 alert 字段中的文本,就像在 iOS 上一样。
指示应用版本的整数值。为每个后续更新增加该值。
应用运行所需的最低 API 级别(android:minSdkVersion)。
应用针对的 API 级别(android:targetSdkVersion)。
包标识符。必须由两个或多个用点分隔的段组成。每个段必须以字母开头。每个段只能包含字母数字字母或下划线字符。
Google Cloud Messaging 发送者 ID。将其设置为 Google 分配的字符串以启用推送通知。
Firebase Cloud Messaging 应用 ID。
设置后,打包时会使用指定的 Android 清单 XML 文件。自定义清单会替换 Defold 的内置基础清单。原生扩展的清单片段仍会合并进去,但不会自动继承内置基础清单的后续变化,因此升级时请将自定义清单与当前内置清单比较。对于游戏,请在 <application> 元素上设置 android:appCategory="game"。对于非游戏应用,仅当 Android 定义的应用类别能准确描述应用时,才设置 android:appCategory。
指定要使用的商店。有效选项是 Amazon 和 GooglePlay。有关更多信息,请参考 extension-iap。
指定在 Android 设备上获取键盘输入的方法。有效选项是 KeyEvent(旧方法)和 HiddenInputField(新方法)。
如果设置,隐藏导航和状态栏,并让您的应用捕获屏幕上的所有触摸事件。
扩展到显示屏切口。
应用是否可以使用诸如 GAPID 或 Android Studio 之类的工具进行调试。这将在 Android 清单中设置 android:debuggable 标志(官方文档)。
android.r8_keep_rules 选择一个 .keep 文件,以在 Android 构建中启用 R8 对 Java 代码的缩减、优化和混淆。将该设置留空会使用 D8,不执行缩减。
使用兼容的 Extender 构建服务器时,此设置还会移除未使用的 Android 资源。动态加载的资源可能需要单独的 XML 保留规则。
选择 /builtins/manifests/android/dmengine.keep 可直接使用 Defold 的默认规则。扩展提供自己的保留规则,这些规则会与此文件合并。
仅当需要添加项目特定规则时,才将内置文件复制到项目中。请在副本中保留内置规则:选择自定义文件会替换完整的项目规则集。
有关如何启用 R8 并在发布包中保留其混淆映射,请参阅 Android 手册。
指定包安装程序是否将原生库从 APK 提取到文件系统。如果设置为 false,您的原生库将以未压缩的形式存储在 APK 中。虽然您的 APK 可能更大,但您的应用程序加载速度更快,因为库在运行时直接从 APK 加载。这将在 Android 清单中设置 android:extractNativeLibs 标志(官方文档)。
用作 macOS 应用图标的捆绑图标文件 (.icns)。
如果设置,在打包时使用指定的 info.plist 文件。
应用的 Apple 隐私清单。该字段将默认为 /builtins/manifests/osx/PrivacyInfo.xcprivacy。
捆绑标识符让 macOS 识别您应用的更新。您的捆绑 ID 必须在 Apple 注册,并且对您的应用是唯一的。您不能对 iOS 和 macOS 应用使用相同的标识符。必须由两个或多个用点分隔的段组成。每个段必须以字母开头。每个段只能包含字母数字字母、下划线或连字符 (-) 字符。
osx.bundle_name 指定捆绑短名称(CFBundleName),长度限制为 15 个字符。
osx.bundle_version 指定构建编号(CFBundleVersion),可以是一个数字或 x.y.z。默认值为 1。
如果应用在 Localizations 列表中没有用户的首选语言时使用的语言(参见 CFBundleDevelopmentRegion)。如果首选语言在那里可用,请使用两字母 ISO 639-1 标准或三字母 ISO 639-2。
此字段包含逗号分隔的字符串,标识支持本地化的语言名称或 ISO 语言指示符(参见 CFBundleLocalizations)。
用作 Windows 应用图标的图像文件 (.ico)。有关如何创建 .ico 文件的更多信息,请参阅 Windows 手册。
有关这些选项的更多信息,请参阅 HTML5 平台手册。
Emscripten 要使用的堆大小(以兆字节为单位)。
在打包时使用指定的模板 HTML 文件。默认为 /builtins/manifests/web/engine_template.html。
在打包时使用指定的主题 CSS 文件。默认为 /builtins/manifests/web/light_theme.css。
如果设置,在打包时使用指定的启动图像代替 Defold 徽标。
为 HTML5 打包时,游戏数据被拆分为一个或多个存档数据文件。当引擎启动游戏时,这些存档文件被读入内存。使用此设置指定数据的位置。
要附加到存档文件的后缀。例如,对于强制来自 CDN 的非缓存内容(例如 ?version2)很有用。
将传递给引擎的参数列表。
启用 wasm 文件的流式传输(更快且使用更少的内存,但需要 application/wasm MIME 类型)。
在 index.html 文件中启用全屏按钮。
在 index.html 文件中启用 Made With Defold 链接。
启用此选项将在引擎启动时在浏览器控制台中打印有关引擎和引擎版本的信息(使用 console.log())。
指定用于缩放游戏画布的方法。
html5.min_pixel_ratio 设置启用 High Dpi 时,每个 CSS 像素对应的最少画布渲染像素数。默认为 0,表示禁用下限。支持正的小数值,包括小于 1 的值。
html5.max_pixel_ratio 设置启用 High Dpi 时,每个 CSS 像素对应的最多画布渲染像素数。默认为 0,表示禁用上限。支持正的小数值,包括小于 1 的值。
两项限制必须为有限的非负数。两项边界都启用时,最小值不能超过最大值。禁用 High Dpi 时,比例为 1,两项边界都不应用。这些限制影响渲染分辨率,同时保留画布的 CSS 显示尺寸。配置示例请参阅像素比限制。
启动期间下载失败后的重试次数,包括网络错误、失败的 HTTP 状态,以及引擎 JavaScript 或 WebAssembly 文件的大小不匹配。初次请求不计入重试次数。归档文件验证有自己的重试上限;请参阅下载验证和 Retry Time。
下载失败时尝试下载文件之间等待的秒数(参见 Retry Count)。
html5.verify_downloaded_file_size 检查下载的引擎和归档文件是否符合预期大小。默认启用(true)。仅当服务器、代理或 CDN 有意重写文件并改变其大小时,才将其设置为 false。验证失败会触发下载重试,耗尽重试后启动失败。引擎下载与归档文件验证的重试上限不同;请参阅下载验证。
如果您希望图形上下文具有透明背景,请勾选此项。
勾选以自动完成 IAP 交易。如果未勾选,您需要在成功交易后显式调用 iap.finish()。
liveupdate.enabled 在运行时启用实时更新系统。默认启用。有关如何排除、下载和挂载资源,请参阅实时更新手册。
在打包期间要使用的实时更新设置资源文件。
如果设置,使用应用清单自定义引擎构建。这允许您从引擎中删除未使用的部分以减少最终二进制文件的大小。了解如何在 应用清单手册 中排除未使用的功能。
这些设置控制原生调试和无头构建中的调试器连接。发布和 Web 构建不支持附加调试器。请以文本方式编辑 game.project 来添加这些设置,或使用引擎启动配置覆盖项。它们不显示在项目设置表单中。使用 Debug ▸ Start/Attach 时,编辑器会自动配置连接。
例如,启动本地监听器,并等待客户端在启动脚本运行前配置断点:
[debugger]
enabled = 1
address = 127.0.0.1
port = 8172
wait = 1
将 debugger.enabled 设为 1,会在引擎启动时启动监听器。默认禁用(0)。运行中的游戏也可以通过 debugger.start() 启动监听器。
debugger.address 是监听器接受连接的 IPv4 地址。默认值 127.0.0.1 仅接受本地连接。远程连接请使用设备接口地址或 0.0.0.0。
debugger.port 是 TCP 监听端口,范围为 0 到 65535。默认为 8172。设为 0 会选择可用端口,引擎会在日志中报告该端口。
debugger.wait 使引擎在运行启动脚本前,等待客户端完成调试会话配置(包括断点)。默认禁用(0)。将其设为 1 并同时设置 debugger.enabled=1,即可调试启动代码。稍后使用 debugger.start() 启动监听器不会等待或暂停游戏。请参阅启动和附加指南。
App Manifest 的 Profiler 设置控制是否将分析器代码链接到 Debug 和 Release 构建中。以下设置控制所选构建中已存在的分析器代码的运行时行为。详情请参阅性能分析手册。
启用游戏内性能分析器。
Debug 构建默认启用 CPU 使用率采样。当通过 App Manifest 包含了分析器支持的 Release 构建也需要 CPU 采样时,请启用此设置。
profiler.track_detailed_memory 启用性能分析器中的详细内存采样。默认禁用。在 HTML5 上可能会产生较大的性能开销。
服务器更新之间休眠的毫秒数。
启用浏览器内性能时间线(仅限 HTML5)。
profiler.max_sample_count 是每个线程每帧记录的分析器样本数上限。默认值为 4096,最小值为 128。仅当正常性能分析确实超出限制时才提高此值;请先检查原生扩展性能分析代码中是否存在不匹配的 scope begin/end 调用。
当引擎启动时,可以从命令行提供配置值,以覆盖 game.project 设置:
# Specify a bootstrap collection
$ dmengine --config=bootstrap.main_collection=/my.collectionc
# Set two custom config values
$ dmengine --config=test.my_value=4711 --config=test2.my_value2=foobar
与其他配置值一样,自定义值也可使用运行时访问中介绍的相应函数读取:
local my_value = sys.get_config_number("test.my_value")
local my_value2 = sys.get_config_string("test.my_value2")
local my_flag = sys.get_config_boolean("test.my_flag", false)
配置文件 game.project 包含许多值,用于指定可以同时存在的特定资源的最大数量,通常按每个加载的集合(也称为世界)计算。Defold 引擎将使用这些最大值来预分配相应数量的内存,以避免游戏运行时的动态分配和内存碎片。
用于表示组件和其他资源的 Defold 数据结构经过优化,以使用尽可能少的内存,但在设置这些值时仍应小心,以避免分配超过实际需要的内存。
为了进一步优化内存使用,Defold 构建过程将分析游戏内容,并在可以确定确切数量时覆盖最大计数:
可以为主项目或原生扩展定义自定义设置。主项目的自定义设置必须在项目根目录的 game.properties 文件中定义。项目和获取的库依赖项中任何位置名为 ext.properties 的文件都会被发现,不要求旁边存在 ext.manifest。所有发现的扩展元数据会先合并,然后应用根目录的 game.properties 文件,并可覆盖这些元数据。
设置文件使用与 game.project 相同的 INI 格式,属性属性使用带后缀的点符号定义:
[my_category]
my_property.private = 1
...
始终应用的默认元文件可在此处获得
以下属性当前可用:
[my_extension]
// `type` - used for the value string parsing
my_property.type = string // one of the following values: bool, string, number, integer, string_array, resource
// `help` - displayed as a help tooltip in the editor
my_property.help = string
// `default` - value used as default if user didn't set value manually
my_property.default = string
// `private` - private value used during the bundle process but will be removed from the bundle itself
my_property.private = 1 // boolean value 1 or 0
// `label` - editor input label
my_property.label = My Awesome Property
// `minimum` and/or `maximum` - valid range for numeric properties, validated in the editor UI
my_property.minimum = 0
my_property.maximum = 255
// `options` - drop-down choices for the editor UI, comma-separated value[:label] pairs
my_property.options = android: Android, ios: iOS
// `resource` type only:
my_property.filter = jpg,png // allowed file extensions for resource selector dialog
my_property.preserve-extension = 1 // use original resource extension instead of a built one
// deprecation
my_property.deprecated = 1 // mark property as deprecated
my_property.severity-default = warning // if deprecated property is specified, but set to a default value
my_property.severity-override = error // if deprecated property is specified and set to a non-default value
此外,您可以在设置类别上设置以下属性:
[my_extension]
// `group` - game.project category group, e.g. Main, Platforms, Components, Runtime, Distribution
group = Runtime
// `title` - displayed category title
title = My Awesome Extension
// `help` - displayed category help
help = Settings for My Awesome Extension
Bob 和编辑器都会解析这些元数据文件。编辑器使用它们在 game.project 查看器中创建相应字段、选项、验证和帮助工具提示。