设置 fxmanifest.lua

设置资源清单对于每个 FiveM 资源都是必不可少的，包括地图、脚本和其他内容类型。该文件用作资源的配置文件，指定要加载的元数据、文件以及应在客户端或服务器端运行的脚本。本指南将帮助您从旧设置过渡到更现代、更灵活的系统，这现在是 FiveM 资源的标准。fxmanifest.lua__resource.luafxmanifest.lua

什么是 `fxmanifest.lua`？

fxmanifest.lua是 FiveM 资源的配置文件。它提供有关资源的信息，指定要加载的脚本，并定义资源在 FiveM 服务器中正常运行所需的各种设置。清单将旧文件替换为更结构化的方法，从而提供更好的组织和灵活性。__resource.lua

为什么使用 `fxmanifest.lua`？

该系统具有以下几个优点：fxmanifest.lua__resource.lua

更好的结构：更有条理，允许您使用不同的元数据字段。fxmanifest.lua
兼容性：它支持新的游戏版本，并包含向后兼容性选项。
灵活性：您可以定义其他数据和自定义元数据字段。

`fxmanifest.lua` 的基本结构

在深入研究设置之前，让我们了解文件的基本结构。下面是一个典型的示例：fxmanifest.lua

-- Resource Metadata
fx_version 'cerulean'
games { 'gta5' }

author 'Your Name <your.email@example.com>' -- optional
description 'A brief description of your resource' -- optional
version '1.0.0' -- optional

-- What to run
client_scripts {
'client.lua'
}
server_scripts {
'server.lua'
}

-- Additional data
files {
'data/file1.dat',
'data/file2.dat'
}
data_file 'DLC_ITYP_REQUEST' 'stream/resource_name.ytyp'

资源元数据：本节介绍您的资源的基本信息，例如 FX 版本和支持的游戏。

脚本：指定应在客户端或服务器上运行的脚本。
其他数据：用于指定其他文件或数据文件的可选部分。

让我们详细探讨每个组件。

设置 `fxmanifest.lua` 的分步指南

按照以下步骤为您的 FiveM 资源创建文件：fxmanifest.lua

第 1 步：定义 FX 版本

您的第一行应定义 FX 版本。这是必需的，并指定您的资源针对的 FiveM 框架版本。目前，最常见的版本是：fxmanifest.lua

bodacious
cerulean
adamant

使用以下行定义您的 FX 版本：

fx_version 'cerulean'

第 2 步：指定支持的游戏

该部分指定您的资源支持哪些游戏。通常，这将是：games

侠盗猎车手 V 的 gta5
rdr3 用于 Red Dead Redemption 2

如果需要，您可以指定多个游戏：

games { 'gta5' }

步骤 3：添加资源元数据（可选）

虽然是可选的，但添加作者、描述和版本等元数据是一种很好的做法，因为它可以帮助其他开发人员了解您的资源是关于什么的。以下是添加元数据的方法：

author 'Your Name <your.email@example.com>'
description 'A brief description of your resource'
version '1.0.0'

第 4 步：设置脚本

客户端脚本

定义应在客户端运行的脚本。用于列出这些内容：client_scripts

client_scripts {
    'client.lua',
    'client_additional.lua' -- Add more scripts if necessary
}

服务器脚本

定义应在服务器端运行的脚本。用于列出这些内容：server_scripts

server_scripts {
    'server.lua',
    'server_helper.lua' -- Additional server-side scripts
}

第 5 步：将文件添加到资源

如果您的资源包含其他文件，例如图像、数据文件或音频文件，请使用以下部分指定它们：files

files {
    'html/ui.html',
    'html/style.css',
    'html/script.js'
}

第 6 步：使用数据文件

某些资源需要数据文件来加载地图资产、动画或其他自定义数据。使用指令指定以下内容：data_file

data_file 'DLC_ITYP_REQUEST' 'stream/resource_name.ytyp'

步骤 7：指定其他元数据（可选）

您可以添加自定义元数据字段来存储有关资源的额外信息。这些字段可以任意命名，并且您可以根据需要添加任意数量的字段：

my_custom_data 'some_value'
another_custom_field 'another_value'

特殊情况和其他选项

在 `fxmanifest.lua` 中设置映射

对于 map，必须指定资源确实是 map。使用指令：this_is_a_map

this_is_a_map 'yes'

使用多个游戏版本

如果您的资源需要支持多个游戏（例如，GTA V 和 Red Dead Redemption 2），请在以下部分中指定它们：games

games { 'gta5', 'rdr3' }

设置依赖关系

如果您的资源依赖于其他资源，您可以使用字段指定这些依赖关系：dependencies

dependencies {
    'essentialmode',
    'another_required_resource'
}

`fxmanifest.lua` 的完整示例

下面是一个完整的文件示例，其中包含我们讨论的所有方面：fxmanifest.lua

-- Resource Metadata
fx_version 'cerulean'
games { 'gta5' }

author 'Your Name <your.email@example.com>'
description 'Example resource for a custom script'
version '1.0.0'

-- Resource Settings
this_is_a_map 'yes'

-- Client and Server Scripts
client_scripts {
'client/main.lua',
'client/helper.lua'
}
server_scripts {
'server/main.lua',
'server/database.lua'
}

-- UI Assets and Additional Files
files {
'html/ui.html',
'html/style.css',
'html/script.js',
'audio/soundtrack.mp3'
}

-- Data Files for Custom Map Assets
data_file 'DLC_ITYP_REQUEST' 'stream/my_custom_map.ytyp'

-- Custom Metadata Fields
custom_info 'Extra info about the resource'
random_setting 'random_value'

-- Dependency Resources
dependencies {
'essentialmode',
'mysql-async'
}