数据库安装与配置（phpStudy 小皮面板）

FiveM 服务器的玩家数据、车辆、物品全部存在数据库里。数据库装不好，是新手开服路上第二大坑（第一大是 GitHub 连不上）。

一、为什么推荐小皮面板

对新手来说，单独安装 MySQL 要配环境变量、写 my.ini，容易出错。phpStudy（小皮面板）把 MySQL + phpMyAdmin 打包好，点两下就能用，也是国内 FiveM 社区最常见的方案。

二、安装步骤

1. 下载安装 phpStudy（注意官网是 xp.cn，别下到假站）
2. 打开面板 → 软件管理 → 安装 MySQL 5.7 或 MariaDB 10.x（二者任选，推荐 MariaDB）
3. 启动 MySQL，默认账号 root，默认密码 root（装完立刻改密码）

三、创建数据库

用 phpMyAdmin（小皮面板自带）或命令行创建：

CREATE DATABASE fivem CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

必须用 utf8mb4，否则玩家名字里有中文/emoji 会直接报错或变问号。

单独给服务器建一个账号（不要用 root 跑服务器）：

CREATE USER 'fivem'@'localhost' IDENTIFIED BY '你的强密码';
GRANT ALL PRIVILEGES ON fivem.* TO 'fivem'@'localhost';
FLUSH PRIVILEGES;

四、连接到 FiveM 服务器

txAdmin 部署时会要求数据库信息，按下面填：

部分框架资源使用连接字符串格式：

set mysql_connection_string "mysql://fivem:密码@localhost/fivem?charset=utf8mb4"

五、导入框架 SQL

QBCore / ESX 的配方会自动导入表结构；手动部署时，在 phpMyAdmin 里选中数据库 → 导入 → 选择框架 sql 目录下的 .sql 文件即可。

六、报错速查