Free server.cfg checker for FiveM. Finds resource conflicts, broken load order, leaked keys and leftovers from the default template — before your players find them.
This matters, because you are about to paste a file that contains your license key and your database password.
There is no backend. There is no analytics call carrying your data, no upload, no storage. The page is a single HTML file that parses text locally and renders a report. You can disconnect from the internet after loading the page and it still works.
Don't take that on faith — the whole thing is one readable file in this repository. Read it, or save it and run it offline.
- Open the tool
- Paste your
server.cfg, or drag the file onto the left field - Optionally paste your
resourcesfolder listing into the right field — that catches resources sitting on disk with noensure, and resources ensured but missing - Press Check server
You get a verdict — Ready to launch / Needs attention / Do not launch — and every finding with an explanation of what breaks and how to fix it. Secrets are masked in the output, so the report is safe to screenshot and share.
Interface is available in English and Russian.
35 rules across three severity levels.
| Area | Checks |
|---|---|
| Framework | no core while qb-*/esx_* resources run · two cores at once · core loaded after its own resources |
| Database | no MySQL driver · oxmysql loaded after the core · missing connection string · database password in plain text |
| Libraries | ox_lib missing · ox_lib loaded after its dependents |
| Secrets | no license key · license key in plain text |
| Security | sv_scriptHookAllowed 1 |
| Capacity | more than 32 slots without OneSync · invalid sv_maxclients |
| Integrity | duplicate MySQL drivers · resource ensured but not present on disk |
Duplicate systems (inventory, targeting, voice, fuel, phone, dispatch, garages, appearance, HUD, connection queue) · resource ensured twice · resource both started and stopped · rcon_password set · OneSync off or legacy · sv_maxclients not set · demo resources from cfx-server-data · deprecated resources (mysql-async, PolyZone, qtarget, NativeUI) · start used instead of ensure · convar set twice · sv_endpointprivacy off · inventory that does not match the framework
Placeholder server name · game build not pinned · no steam_webApiKey · broad add_ace permissions · parts of the config living in exec · resources on disk that are never started · high resource count · txAdmin apparently unused
The full rule list with explanations is also on the page itself, at the bottom.
git clone https://github.com/PapsTeam/fivem-config-check.git
cd fivem-config-check
# open index.html in a browser — that's itNo build step, no dependencies, no server. One file.
The rules come from common ESX / QBCore / Qbox build mistakes. The FiveM ecosystem moves fast — new resources appear, old ones die, and this list needs to keep up.
Two things are especially useful:
- A false positive. If the tool flagged something that is fine on your server, that is the most valuable report there is. Open an issue with the rule code and why it is wrong.
- A missing resource name. New inventory, new phone, new fuel script? Add it to the relevant list in
GROUPSand open a pull request. One line.
Rules live in the T object (text) and the audit() function (logic), both inside index.html. The rule count on the page updates itself.
Next tool in the works: ticket and report triage — automatic deduplication of the same bug reported forty times, priority assignment, and a reply drafted for staff.
Want early access, or just want to talk about server tooling?
- Telegram: @Paps1011
- Discord:
georgiy05375
MIT — see LICENSE. Use it, fork it, put it on your own domain.
Independent project. Not affiliated with, endorsed by, or connected to Cfx.re, FiveM, Rockstar Games or Take-Two Interactive. FiveM is a trademark of Take-Two Interactive Software, Inc. The name is used here descriptively, to say what this tool checks.
Бесплатная проверка server.cfg для FiveM. Находит конфликты ресурсов, сломанный порядок загрузки, утёкшие ключи и мусор из дефолтной сборки — раньше, чем это найдут игроки.
Это важно, потому что вы собираетесь вставить файл, в котором лежит ваш лицензионный ключ и пароль от базы.
Здесь нет бэкенда. Нет отправки данных, нет загрузки на сервер, нет хранения. Страница — один HTML-файл, который разбирает текст локально и рисует отчёт. Можете отключить интернет после загрузки страницы — всё продолжит работать.
И не верьте на слово: весь код — один читаемый файл в этом репозитории. Откройте и посмотрите. Или сохраните и запустите офлайн.
- Откройте инструмент
- Вставьте
server.cfgили перетащите файл в левое поле - По желанию добавьте список папок из
resourcesво второе поле — тогда найдутся ресурсы, лежащие на диске безensure, и наоборот - Нажмите Проверить сборку
На выходе — вердикт (К запуску готов / Требует внимания / Не запускать) и каждая находка с объяснением, что именно ломается и как чинить. Секреты в отчёте замаскированы, так что его можно спокойно скринить и пересылать.
Интерфейс переключается между русским и английским.
35 правил в трёх уровнях.
Критично — фреймворк не найден или запущено два сразу · ядро стартует после своих ресурсов · нет MySQL-слоя или он стартует после ядра · не задана строка подключения · пароль от базы в открытом виде · нет ox_lib или он позже зависимых · нет лицензионного ключа или он в открытом виде · включён sv_scriptHookAllowed · больше 32 слотов без OneSync · недопустимое значение sv_maxclients · ресурс запускается, но отсутствует на диске
Внимание — дубликаты систем (инвентарь, таргет, голос, топливо, телефон, диспетчер, гаражи, внешность, HUD, очередь) · двойной ensure · ресурс и запускается, и останавливается · задан rcon_password · OneSync выключен или legacy · не задан sv_maxclients · демо-ресурсы из cfx-server-data · устаревшие ресурсы · start вместо ensure · переменная задана дважды · выключен sv_endpointprivacy · инвентарь не соответствует фреймворку
Заметки — незаполненное имя сервера · не зафиксирован билд игры · нет steam_webApiKey · широкие права в add_ace · часть конфига вынесена в exec · ресурсы на диске без запуска · слишком много ресурсов · txAdmin, похоже, не используется
Полный список с пояснениями есть и на самой странице, внизу.
git clone https://github.com/PapsTeam/fivem-config-check.git
cd fivem-config-check
# откройте index.html в браузереНи сборки, ни зависимостей, ни сервера. Один файл.
Правила собраны из типовых ошибок сборок ESX / QBCore / Qbox. Экосистема живая: появляются новые ресурсы, умирают старые — списку нужно поспевать.
Особенно полезны две вещи:
- Ложное срабатывание. Если инструмент отметил то, что у вас сделано намеренно — это самый ценный отчёт из возможных. Заведите issue с кодом правила и объяснением.
- Недостающее имя ресурса. Новый инвентарь, телефон, скрипт топлива? Допишите в нужный список в
GROUPSи откройте pull request. Одна строка.
Правила живут в объекте T (тексты) и функции audit() (логика), обе внутри index.html. Счётчик правил на странице обновляется сам.
В работе следующий инструмент: разбор очереди тикетов и репортов — автоматическая склейка одного бага, о котором сообщили сорок раз, расстановка приоритетов и черновик ответа для админа.
Хотите в ранний доступ или просто обсудить инструменты для серверов:
- Telegram: @Paps1011
- Discord:
georgiy05375
MIT — см. LICENSE. Пользуйтесь, форкайте, ставьте на свой домен.
Независимый проект. Не связан с Cfx.re, FiveM, Rockstar Games и Take-Two Interactive, не является их официальным продуктом и не одобрен ими. FiveM — товарный знак Take-Two Interactive Software, Inc. Название использовано описательно, чтобы обозначить, что именно проверяет инструмент.