Руководства FiveM: Основа, Интеграция и Проверки Установки
Сравните ресурсы и данные QBCore, ESX, Standalone, vRP, OX/Qbox. Время зависит от собственных скриптов и тестов.
Коротко: Определите core и инвентарь, затем режим AC и тесты.
Установка и совместимость
| Основа | Поле framework AC | Доступные данные | Руководство |
|---|---|---|---|
| QBCore | qb | players / citizenid; поддерживаемые индексы | Руководство по установке → |
| ESX | esx | users / identifier; поддерживаемые индексы | Руководство по установке → |
| Standalone | standalone | Собственные данные не поддерживаются мостом | Руководство по установке → |
| vRP / vRPex | standalone: общие проверки | Свои vRP-экономика/персонажи не поддерживаются | Руководство по установке → |
| Qbox / ox_core | qbox / standalone | Поддерживаемый Qbox; чистый ox_core не поддерживается | Руководство по установке → |
Выбор реальной установки
qb-core → qb; es_extended → esx; qbx_core → qbox. Общий standalone для custom/vRP. ox_inventory не core; ox_core отдельно. auto подтвердить в консоли.
Профиль не пишет правила событий
Обнаружение события/core не проверяет цену, количество, место и право. Свои магазины, работы, награды и инвентарь требуют серверной проверки. Обычная операция не обязана давать detection-лог. Чтение, отказ прав и обнаружение тестируйте отдельно.
Разделяйте фреймворк и инвентарь
Определите ресурс состояния игрока: qb-core, qbx_core или es_extended. Отдельно проверьте инвентарь и изменения API. Название фреймворка не гарантирует любой сторонний банковский скрипт. Сохраняйте порядок зависимостей, не запускайте конкурирующие cores для диагностики.
Измените существующее поле: qb для QBCore, qbox для Qbox — это значения, не имена папок. auto включает определение. Проверьте результат запуска и GetStatus в серверном коде. Мост отдельно определяет запущенные cores и может сообщить незапущенную зависимость.
-- Измените существующее поле, не всю таблицу.
ts.Framework.framework = "qb"
-- Другие поддерживаемые значения: "esx", "qbox", "auto", "standalone"
Проверяйте данные персонажа
Чтение использует citizenid в QBCore/Qbox и identifier в ESX. Временный ID сервера не заменяет постоянный ID персонажа. Нужны поддерживаемые столбцы и индексы; собственная схема может быть отклонена.
- Сравните тестового персонажа с известными наличными, банком, работой и машиной.
- С ox_inventory сравните небольшой онлайн-инвентарь. Учитывайте усечение, не ожидайте stash или произвольные метаданные.
- При ошибке API проверьте запуск и версию. Недоступность API означает неизвестное владение оружием, а не доказанное отсутствие.
Тестируйте реальные игровые действия
Определение не знает права, место, цену или награду каждого события. Ваш скрипт обязан проверять их на сервере. Профиль не исправляет небезопасные денежные/item-события. Проверяйте source и действующую сессию.
Standalone/vRP могут применять общие проверки, но мост не обещает их собственные схемы. Объясняйте ограничения, не подставляйте чужие таблицы. Повторяйте проверку после обновления core, инвентаря или работ.
Записывайте версии core и инвентаря. После перезапуска core переподключите персонажа до оценки online API. Не меняйте схему и наказание одновременно: разделение позволяет найти причину и откатить.
- Смена персонажа и реанимация не оставляют постоянное исключение.
- Телепорты домов, гаражей и тюрьмы вызывают MarkTeleport непосредственно до перемещения.
- Оружие арены без инвентаря получает короткий AllowWeapon из доверенного серверного ресурса.
- Полицию, инструменты, магазины и большие награды проверьте по логам до усиления наказаний.
Измерение воспроизводимой нагрузки
До изменения снимите профиль типичной сессии. Запишите игроков, artifact, версии и действия. Спокойная игра, заполненные гаражи и бой различаются. После одного изменения сравните тот же сценарий. CPU, hitch и запросы полезнее обещаний постоянного FPS.
Команды записывают ограниченную выборку. Дождитесь завершения и найдите ресурс и поток пика. Не связывайте каждый hitch с AC. Сохраните значения и сравнение приватно; короткая запись не охватывает все пики.
profiler record 500
profiler status
profiler view
tosunac_doctor
Обновление, восстановление и поддержка
Повторяйте тесты после изменения core, инвентаря, работ или AC. Не меняйте схему, наказание и версию вместе. При сбое нового изменения восстановите ресурс и настройки при обслуживании; до восстановления БД оцените потерю данных. Поддержке нужны версии artifact/core/инвентаря/AC, ресурс, шаги, время и первая очищенная ошибка. Не публикуйте данные игроков, лицензии, пароли и токены.
Дополнительные инструкции
Документация установки · Мост базы данных · Server exports
Частые вопросы
При смене core хватит настройки панели?
Нет. Меняются API, инвентарь, ID, схема и события; сохраните копию и повторите тесты.
Нет данных — AC отключена?
Нет. Права/схема моста и общие проверки различаются.
Несколько серверов?
Проверьте квоту тарифа и каждую лицензию, тестируйте отдельно.