Экономика, работа и база данных на FiveM (MySQL + ESX/QBCore)

После установки модов и скриптов наступает время создать основу ролевого сервера — экономику, систему аккаунтов и профессий.
Именно это делает сервер живым и удерживает игроков.

---

⚙️ 1. Что такое ESX и QBCore

Оба — это фреймворки для FiveM, которые дают готовую базу:

• учёт игроков (аккаунты, лицензии, деньги),
• магазины, работу, зарплату, имущество,
• инвентарь, полиция, банкоматы и прочее.

🧩 Разница:

Фреймворк	Особенности
ESX	Классическая система, самая известная. Тысячи модов. Простой старт.
QBCore	Более современный и оптимизированный. Меньше старого кода. Модули гибче.

Если ты делаешь проект вроде gtacraft.cc, можно начать с QBCore — он легче на настройку, но всё будет аналогично и для ESX.

---

🧰 2. Что понадобится

1. Установленный сервер FiveM (из части 1).
2. Панель txAdmin (она уже идёт в комплекте).
3. MySQL или MariaDB (можно на том же сервере).
4. Клиент для работы с БД: HeidiSQL, phpMyAdmin, или DBeaver.

---

🧱 3. Установка базы данных

Шаг 1. Устанавливаем MySQL

Для Linux:

sudo apt update
sudo apt install mariadb-server
sudo systemctl start mariadb
sudo systemctl enable mariadb

Для Windows — скачай MariaDB Installer.

Шаг 2. Настраиваем

Выполни:

sudo mysql_secure_installation

Создай базу:

CREATE DATABASE fivem;
CREATE USER 'fivem'@'localhost' IDENTIFIED BY 'gtacraftpass';
GRANT ALL PRIVILEGES ON fivem.* TO 'fivem'@'localhost';
FLUSH PRIVILEGES;

---

🧩 4. Подключаем базу к серверу

FiveM использует библиотеку oxmysql (новый стандарт вместо ghmattimysql).

Шаг 1. Скачай ресурс:

👉 https://github.com/overextended/oxmysql/releases

Распакуй в:

resources/[system]/oxmysql/

Шаг 2. Добавь в server.cfg

ensure oxmysql
set mysql_connection_string "mysql://fivem:gtacraftpass@localhost/fivem?charset=utf8mb4"

💡 Если база на другом сервере — замени localhost на IP.

---

🔌 5. Устанавливаем QBCore (или ESX)

Вариант A: QBCore

1. Скачай QBCore Framework.
2. Распакуй в resources/[qb]/qb-core/.
3. Добавь в server.cfg: ensure qb-core ensure oxmysql
4. Скачай дополнительные модули (jobs, hud, inventory):
   • qb-hud
   • qb-inventory
   • qb-banking
   • qb-policejob
   • qb-taxi
5. Все ресурсы — в resources/[qb]/.
6. В конце server.cfg: ensure qb-core ensure qb-hud ensure qb-inventory ensure qb-banking ensure qb-taxi ensure qb-policejob

Вариант B: ESX

Если хочешь ESX:

• Скачай https://github.com/esx-framework/esx_core
• Импортируй SQL-файл esx.sql в базу fivem.
• Пропиши в server.cfg: ensure es_extended set es_enableCustomData 1

---

💼 6. Добавляем работу

Каждая работа — это отдельный ресурс (например qb-taxi, qb-policejob).

Пример: qb-taxi

В конфиге можно задать:

Config = {}
Config.Payment = math.random(80, 150)
Config.Bonus = 50
Config.RequireUniform = true

Игроки могут устроиться через /job taxi,
или через меню в qb-menu.

---

💰 7. Добавляем экономику

QBCore уже содержит базовые системы:

• bank — банковский счёт
• cash — наличные
• black_money — нелегальные деньги (если нужно RP)

Ты можешь управлять балансом прямо из консоли или SQL:

local Player = QBCore.Functions.GetPlayer(source)
Player.Functions.AddMoney('bank', 500)

Или в MySQL:

UPDATE players SET money = money + 500 WHERE citizenid = 'XYZ123';

---

🏦 8. Подключаем магазины и банкоматы

Устанавливаются модули:

• qb-shops
• qb-atms

Добавь в server.cfg:

ensure qb-shops
ensure qb-atms

Теперь игроки могут покупать еду, оружие, аптечки и снимать наличку.

---

🏠 9. База игроков

QBCore автоматически создаёт таблицы при первом запуске:

players
players_vehicles
players_houses
players_jobs

Можно зайти в базу (fivem → players) и увидеть всех, кто заходил.

---

📦 10. Добавляем инвентарь и предметы

Установи:

• qb-inventory
• qb-items

Добавь в shared/items.lua:

["bread"] = {["name"] = "bread", ["label"] = "Хлеб", ["weight"] = 100, ["type"] = "item", ["image"] = "bread.png", ["unique"] = false, ["useable"] = true, ["shouldClose"] = true, ["combinable"] = nil, ["description"] = "Свежий хлеб"},

Теперь игрок может покупать хлеб в магазине и есть его 😋

---

🧠 11. Проверяем подключение и логи

В консоли сервера должно быть что-то вроде:

[oxmysql] Connected to database fivem
[QBCore] Player joined: steam:11000013CBAA

Если есть ошибка — проверь строку подключения:

set mysql_connection_string "mysql://fivem:gtacraftpass@localhost/fivem"

---

🧩 12. Пример структуры GTACraft RP-сервера

server-data/
 ├── resources/
 │    ├── [system]/
 │    │     └── oxmysql/
 │    ├── [qb]/
 │    │     ├── qb-core/
 │    │     ├── qb-hud/
 │    │     ├── qb-inventory/
 │    │     ├── qb-banking/
 │    │     ├── qb-taxi/
 │    │     └── qb-policejob/
 │    ├── [maps]/
 │    │     └── gtacity/
 │    └── [vehicles]/
 │          ├── supra/
 │          └── skyline/
 └── server.cfg

---

🧩 13. Полезные команды

Команда	Что делает
/setjob [id] [job] [grade]	Назначить работу
/addmoney [id] [тип] [сумма]	Выдать деньги
/inventory	Открыть инвентарь
/admin	Панель администратора
/giveitem	Выдать предмет

---

🧠 14. Советы по продакшн-настройке

• ⚡ Используй MariaDB, а не SQLite — она стабильнее.
• 🔐 Не храни пароли от БД в публичных репозиториях.
• 💾 Делаай регулярные дампы: mysqldump -u fivem -p fivem > backup.sql
• 🧹 Не ставь 50 модов сразу — тестируй по 2–3 за раз.
• 📈 Настрой автосохранение в txAdmin.

---

🧩 15. Дальше можно добавить:

• 🏢 Систему домов и недвижимости (qb-houses)
• 🚗 Гаражи (qb-garages)
• 🧾 Налоги и счета (qb-billing)
• 👕 Магазины одежды (qb-clothing)
• 📋 Регистрацию персонажа (qb-multicharacter)

---

🏁 ИТОГ

Теперь у тебя есть:
✅ полноценная база данных,
✅ экономика, деньги, магазины,
✅ система работ, профессий и инвентаря,
✅ подключение через QBCore.