本指南介绍如何在您的 FiveM 服务器上安装资源（脚本）、为 ESX 或 QBCore 等框架设置 MySQL 数据库，以及了解资源加载顺序。如果您尚未完成初始服务器设置，请先阅读 FiveM 服务器设置指南。

安装资源和脚本

FiveM 服务器通过 资源（也称为脚本）进行扩展。资源可以添加汽车经销商、职业、HUD 元素、框架等功能。

如何安装资源

1. 从资源来源（GitHub、Cfx.re 论坛、Tebex 等）下载资源。
2. 如需要，从 ZIP/压缩包中解压资源文件夹。
3. 使用 GPanel 的 Files 标签页或通过 SFTP 将资源文件夹上传到服务器的 resources/ 目录。
4. 打开 server.cfg，为资源添加一行 ensure：

# Add your custom resources
ensure my-new-resource

5. 从 GPanel 或 TXAdmin 重启服务器以加载资源。

资源清单文件

每个有效的资源都必须包含一个清单文件。现代资源使用 fxmanifest.lua，较旧的资源使用 __resource.lua。如果下载的资源文件夹不包含这两个文件中的任何一个，资源将无法加载。某些下载的资源会将实际资源文件夹嵌套在外层文件夹中 — 请确保放入 resources/ 的文件夹是包含清单文件的那个。

资源加载顺序

资源按照在 server.cfg 中出现的顺序加载。如果某个资源依赖于另一个资源（例如，依赖 ESX 或 QBCore 框架的职业脚本），请确保依赖项列在需要它的资源 之前：

# Database resource first
ensure oxmysql

# Framework second
ensure es_extended

# Then resources that depend on the framework
ensure esx_basicneeds
ensure esx_jobs
ensure esx_vehicleshop

使用分类文件夹组织资源

您可以将资源整理到 resources/ 目录内的子文件夹中。在 server.cfg 中使用方括号表示法来 ensure 整个分类文件夹：

# Ensure all resources inside resources/[esx]/
ensure [esx]

# Ensure all resources inside resources/[standalone]/
ensure [standalone]

这将加载指定子文件夹中的所有资源。这是一种方便的方式来分组相关脚本，而无需逐个列出。

通过 TXAdmin 热加载资源

您不需要每次都完全重启服务器来加载新资源。TXAdmin 可以在其 Resources 页面上启动、停止和重启单个资源。上传新资源并添加其 ensure 行后，您可以在 TXAdmin 实时控制台中运行以下命令：

refresh
ensure my-new-resource

refresh 命令告诉服务器重新扫描 resources/ 目录以查找新条目。

数据库设置（MySQL / MariaDB）

许多 FiveM 框架和资源（如 ESX、QBCore 或 vRP）需要 MySQL 或 MariaDB 数据库。Legion Hosting 会随您的服务器提供数据库凭据。

查找您的数据库凭据

1. 在 GPanel 中，转到 Databases 标签页。
2. 如果还没有数据库，点击 New Database 创建一个。
3. 记下以下详细信息：
   • 数据库主机（地址和端口）
   • 数据库名称
   • 用户名
   • 密码（点击眼睛图标显示）

配置数据库连接

数据库连接详情在 server.cfg 中使用连接字符串设置。具体格式取决于您使用的 MySQL 资源，但最常见的格式是：

# MySQL connection string (oxmysql / mysql-async format)
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

将占位符替换为您在 Databases 标签页中的实际凭据。例如：

set mysql_connection_string "mysql://u123_fivem:[email protected]:3306/s123_fivem?charset=utf8mb4"

选择 MySQL 资源

无论您使用哪个 MySQL 资源，它都必须在 server.cfg 中任何依赖它的资源 之前 被 ensure：

# Database connection
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

# MySQL resource — must load before framework
ensure oxmysql

# Framework
ensure es_extended

框架基础

框架提供其他资源所依赖的核心游戏系统 — 如玩家身份、金钱、背包、职业和载具。FiveM 最受欢迎的两个框架是：

大多数框架通过 TXAdmin 的配方系统在初始设置期间安装。如果您在 TXAdmin 设置期间选择了"QBCore"或"ESX"等配方，框架及其核心依赖项已经安装完成。如果您需要手动安装框架，请参阅其官方文档：

• ESX 文档
• QBCore 文档

获取帮助

如果您在资源安装或数据库配置方面需要帮助：

1. 查看资源的文档或 GitHub 页面，了解安装说明和已知问题。
2. 检查 GPanel 控制台或 TXAdmin 日志中的错误信息。
3. 在 https://legionhosting.net/submitticket.php 提交工单，附上您的错误信息和您尝试安装的资源名称。

相关文章

• FiveM 服务器设置指南
• FiveM 故障排除
• 如何通过 SFTP 上传文件
• 如何查找您的服务器 IP 和端口