Как добавить моды, машины и скрипты на FiveM-сервер (для gtacraft.cc)

05.11.2025 admin FiveM 0 комментариев

После того как ты установил и запустил сервер FiveM — самое интересное только начинается 😎
В этой части разберём, как добавлять свои моды, карты, транспорт и скрипты, чтобы сервер стал по-настоящему уникальным.

🗂️ 1. Структура папок сервера

Все дополнения хранятся в папке resources.
Каждый мод, скрипт или карта — это ресурс (resource).

Пример структуры:

server-data/
 ├── resources/
 │    ├── [maps]/
 │    │     └── sandy_shores/
 │    ├── [vehicles]/
 │    │     └── supra/
 │    ├── [scripts]/
 │    │     ├── jobs/
 │    │     └── money_system/
 │    └── [others]/
 └── server.cfg

📦 Всё, что находится в resources/, можно включить или выключить через конфиг server.cfg.

⚙️ 2. Как работает система ресурсов

Каждый ресурс — это мини-папка с минимум одним файлом fxmanifest.lua (или старым __resource.lua), который описывает, что делает мод и какие файлы он использует.

Пример простого ресурса:

resources/myscript/
 ├── fxmanifest.lua
 └── client.lua

fxmanifest.lua:

fx_version 'cerulean'
game 'gta5'

client_script 'client.lua'

client.lua:

RegisterCommand("hello", function()
    TriggerEvent('chat:addMessage', {
        args = { "^2[GTACraft]", "Привет, игрок!" }
    })
end)

💡 Теперь в игре ты можешь набрать /hello — и в чате появится сообщение.

🔧 3. Подключаем ресурс в server.cfg

Чтобы сервер понял, что нужно запустить ресурс —
в конфиге server.cfg пропиши:

ensure myscript

После перезапуска сервера этот скрипт будет активен.
Можно включить сразу несколько:

ensure myscript
ensure jobs
ensure supra

🚗 4. Добавляем машину (addon car)

Пример — добавим Toyota Supra.

🔹 Шаг 1. Скачай мод машины

Например с сайтов:

В архиве обычно лежат файлы вида:

dlc.rpf
data/
vehicles.meta
carvariations.meta
handling.meta
carcols.meta
stream/

🔹 Шаг 2. Создай папку ресурса

Например:

resources/[vehicles]/supra/

Внутрь положи все нужные .meta и stream файлы.

🔹 Шаг 3. Создай fxmanifest.lua

fx_version 'cerulean'
game 'gta5'

files {
    'vehicles.meta',
    'carvariations.meta',
    'carcols.meta',
    'handling.meta'
}

data_file 'VEHICLE_METADATA_FILE' 'vehicles.meta'
data_file 'CARCOLS_FILE' 'carcols.meta'
data_file 'HANDLING_FILE' 'handling.meta'
data_file 'VEHICLE_VARIATION_FILE' 'carvariations.meta'

🔹 Шаг 4. Подключи ресурс

Добавь в server.cfg:

ensure supra

После рестарта — можно заспаунить машину:

/car supra

(если установлен скрипт vMenu или аналогичный спаунер).

🌍 5. Добавляем карту (map mod)

🔹 Шаг 1. Найди карту

Подойдут карты с метками FiveM ready или YMAP.
Например — новая больница, аэропорт, остров, и т.д.

🔹 Шаг 2. Создай ресурс

resources/[maps]/newhospital/

🔹 Шаг 3. Положи туда .ymap и fxmanifest.lua

fxmanifest.lua:

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

Папка:

resources/[maps]/newhospital/
 ├── fxmanifest.lua
 └── newhospital.ymap

🔹 Шаг 4. Добавь в конфиг:

ensure newhospital

При загрузке сервера карта автоматически появится в мире.

💬 6. Добавляем готовые скрипты

На официальном форуме forum.cfx.re и на GitHub есть тысячи готовых скриптов:

  • RP-системы (работа, деньги, экономика)
  • Сервисы (такси, полиция, механики)
  • Админ-панели (EasyAdmin, vMenu)
  • HUD и меню

Пример: установка vMenu

  1. Скачай vMenu с GitHub.
  2. Распакуй папку vMenu в resources.
  3. В server.cfg добавь: ensure vMenu
  4. Запусти сервер — в игре нажми M или F1, откроется меню.

⚙️ 7. Настраиваем порядок загрузки

Ресурсы загружаются в том порядке, как указаны в server.cfg.
Важно, чтобы зависимости шли первыми.
Пример:

ensure mapmanager
ensure spawnmanager
ensure chat
ensure mycore       # базовые функции
ensure economy
ensure jobs
ensure cars

💡 Если мод требует другой — всегда читай README автора.

💾 8. Горячая перезагрузка модов

Во время разработки не обязательно перезапускать сервер.
В консоли можно использовать:

refresh       # обновить список ресурсов
start myscript
stop myscript
restart myscript

Это сильно ускоряет тестирование.

🛡️ 9. Частые проблемы

ОшибкаПричинаРешение
“No fxmanifest.lua found”В папке нет манифестаДобавь fxmanifest.lua
“Could not load resource …”Ошибка пути или зависимостейПроверь структуру и имена
Машина не появляетсяНет метаданных или неправильный spawnerПроверь .meta и спаун-команду
Карта не грузитсяНет this_is_a_map 'yes'Добавь в fxmanifest.lua

🧠 10. Советы по организации

  • Группируй ресурсы по типам: [maps], [scripts], [vehicles].
  • Не используй русские буквы и пробелы в именах папок.
  • Храни resources под Git — удобно делать откаты.
  • Делай бэкап server-data перед обновлением FiveM.
  • Не ставь десятки ресурсов сразу — тестируй по одному.

🔄 11. Обновление и чистка

Чтобы сервер не лагал:

  1. Удаляй неиспользуемые ресурсы.
  2. Следи за обновлениями FiveM (новые билды выходят часто).
  3. Периодически перезапускай сервер (txAdmin это умеет автоматически).

🎨 12. Пример живого проекта (структура gtacraft.cc)

server-data/
 ├── resources/
 │    ├── [core]/            # базовые системные скрипты
 │    │     ├── chat/
 │    │     └── spawnmanager/
 │    ├── [maps]/            # локации
 │    │     └── gtacity/
 │    ├── [vehicles]/        # машины
 │    │     ├── supra/
 │    │     └── skyline/
 │    ├── [jobs]/            # работы, экономика
 │    │     ├── taxi/
 │    │     └── police/
 │    ├── [scripts]/         # разное
 │    │     ├── weather/
 │    │     └── admin_menu/
 │    └── [fun]/             # развлечения
 │          └── fireworks/
 └── server.cfg

Такой порядок легко читается, а конфиг остаётся чистым.

🧩 13. Полезные ресурсы

Теги: , , , ,

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *