К основному содержанию
скилл CX Codex

fivem-nui — скилл для Claude Code: NUI-интерфейсы FiveM

Скилл fivem-nui для сборки HTML/CSS/JS-интерфейсов в FiveM-ресурсах: манифест, обмен сообщениями между Lua и браузером, коллбэки и фокус.

MIT 649 установок ★ 20 обновлён 2026-10-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add germanfndez/fiveai-skills --skill fivem-nui -a claude-code
Открыть на GitHub

Что делает fivem-nui

Агент собирает ui_page, декларирует файлы в fxmanifest.lua, связывает Lua-клиент с браузером через SendNUIMessage и RegisterNUICallback, управляет фокусом клавиатуры и мыши. Внутри скилла — правила по структуре манифеста, обработке коллбэков, валидации данных на сервере и отладке через F8 и Chrome DevTools.

Каждый коллбэк RegisterNUICallback обязан вызвать cb(...) на любом пути выполнения, иначе запрос браузера зависнет. Логику изменения состояния, суммы, цены и id агент переносит на сервер, а не оставляет в NUI: данные из браузера приходят на клиент, клиент пересылает их серверу, сервер валидирует заново. Скилл загружается, когда упомянут SendNUIMessage, SetNUIFocus или RegisterNUICallback.

Какие задачи решает

  • собрать HTML/CSS/JS-интерфейс для FiveM-ресурса
  • связать Lua-клиент с браузером через SendNUIMessage и RegisterNUICallback
  • объявить ui_page и файлы в fxmanifest.lua
  • управлять фокусом клавиатуры и мыши в NUI
  • валидировать данные из браузера на сервере

Примеры запросов агенту

  • Сделай NUI-меню для открытия магазина, кнопки слева, на закрытие по Escape
  • Добавь ui_page в манифест и зарегистрируй коллбэк buyItem
  • Покажи, как отправить сообщение из Lua в браузер через SendNUIMessage

Как установить fivem-nui

1Через Skills CLI (Vercel)

npx skills add germanfndez/fiveai-skills --skill fivem-nui -a claude-code

2Вручную: положить файлы

~/.claude/skills/fivem-nui/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/fivem-nui/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о fivem-nui

Как установить fivem-nui в Claude Code?

Запусти npx skills add germanfndez/fiveai-skills --skill fivem-nui -a claude-code, скилл окажется в ~/.claude/skills/fivem-nui/SKILL.md.

Что делает fivem-nui?

Скилл учит агента собирать NUI-интерфейсы для FiveM: объявлять ui_page в манифесте, связывать Lua и браузер через SendNUIMessage и RegisterNUICallback, управлять фокусом и валидировать данные на сервере.

Почему коллбэк NUI зависает?

Если RegisterNUICallback не вызывает cb(...) на каждом пути выполнения, запрос браузера зависает. Агент добавит вызов cb({}) даже в случае ошибки.

Исходный текст

SKILL.md · MIT
---
name: fivem-nui
description: "Trigger: NUI, ui_page, SendNUIMessage, SetNUIFocus, RegisterNUICallback, HTML/CSS/JS for FiveM, FiveM menu UI. Build FiveM NUI pages, wire Lua-browser messaging, callbacks and focus."
license: MIT
metadata:
  author: germanfndez
  version: "1.0.0"
---

# FiveM NUI

HTML/CSS/JS interfaces for FiveM: manifest setup, Lua-to-browser messages, NUI callbacks and focus handling.

## Activation Contract

Load this skill when the user asks to create or edit a FiveM UI, writes HTML/CSS/JS inside a resource, sets `ui_page`, or asks about `SendNUIMessage`, `SetNUIFocus` or `RegisterNUICallback`.

## Hard Rules

- Declare `ui_page` and include every UI file in `files` in `fxmanifest.lua`; a missing file silently fails to load.
- Reference assets with `https://cfx-nui-<resource>/path`; the `nui://` protocol is deprecated.
- `RegisterNUICallback` handlers must ALWAYS call `cb(...)` (at least `cb({})`), or the browser request hangs.
- Browser calls callbacks with `fetch('https://' + GetParentResourceName() + '/<name>', { method: 'POST', body: JSON.stringify(...) })`; the URL name must match the registered name exactly.
- `SetNUIFocus(keyboard, mouse)`: always call `SetNUIFocus(false, false)` when closing the UI.
- NUI callbacks run on the CLIENT. Validate their data client-side, then re-validate on the server before any state change; never trust UI-sent prices, amounts or ids.
- Minimize `SendNUIMessage` calls: batch updates rather than sending per frame.
- Debug with F8 and Chrome DevTools; test the page in a browser with a mock mode.

## Decision Gates

| Direction | Mechanism |
|---|---|
| Lua to browser | `SendNUIMessage({ type = ..., data = ... })` + `window.addEventListener('message')` |
| Browser to Lua | `fetch` POST to `https://<resource>/<callback>` + `RegisterNUICallback` |
| Browser wants server data | callback to Lua client, then a server callback |
| Show / hide cursor | `SetNUIFocus(true, true)` / `SetNUIFocus(false, false)` |
| Keyboard only | `SetNUIFocus(true, false)` |

## Execution Steps

1. Add `ui_page` and `files` to the manifest (read rules/setup.md).
2. Build `index.html`, CSS and JS; listen for `message` events keyed by `type`.
3. Register Lua callbacks for every action the UI can request; call `cb` on every path.
4. Manage focus on open/close; handle `Escape` to close.
5. Forward any state-changing action to the server and validate there.

## Output Contract

Return the manifest entries, the HTML/CSS/JS files, and the Lua client script with callbacks and focus handling. Keep security-relevant logic on the server.

## References

- rules/setup.md — folder layout, manifest, build tools, common mistakes.
- rules/fullscreen-nui.md — SendNUIMessage, SetNUIFocus, focus stack, assets, devtools.
- rules/nui-callbacks.md — RegisterNUICallback, fetch, async, errors, security.
- rules/best-practices.md — performance, security, state, error handling, testing.
- rules/reference-links.md — official docs and natives reference.

Upstream docs: https://docs.fivem.net/docs/scripting-manual/nui-development/

© germanfndez · MIT · germanfndez/fiveai-skills

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
fivem-dev melihbozkurt10 Скилл fivem-dev ведёт разработку ресурсов FiveM под QBox, QBCore и ESX: подтягивает нативы, API фреймворков и модели ассетов вместо догадок. CX Codex +1 521установок FiveM MCP ziyacivan MCP-сервер даёт ИИ-агенту доступ к FXServer и запущенному FiveM-клиенту: команды, логи и live-проверки игрового сервера. CX Codex +1 ★ 20звёзд репо modern-web-guidance GoogleChrome Скилл modern-web-guidance для Claude Code ищет актуальные рекомендации по HTML, CSS и клиентскому JavaScript. Он подключается перед работой над веб-интерфейсом, стилями или логикой в браузере. CX Codex +1 62 500установок frontend-slides affaan-m Скилл frontend-slides для Claude Code собирает автономные HTML-презентации без зависимостей или переносит файлы PowerPoint в веб. Включается при подготовке докладов, питч-деков и разборе PPTX. CX Codex +1 7 300установок bootstrap-v5-v6-migration twbs Скилл bootstrap-v5-v6-migration для Claude Code пошагово переводит проект с Bootstrap 5 на Bootstrap 6. Запускается при обновлении зависимостей, верстки, Sass-токенов и скриптов. CX Codex +1 667установок generic-static-code-reviewer travisjneuman Скилл generic-static-code-reviewer проверяет HTML, CSS и JS статического сайта: баги, безопасность, вес, доступность. Сборку вроде Sass или бандлера считает нарушением. CX Codex +1 149установок

Из того же набора12

Весь набор →
fivem-security Скилл fivem-security для Claude Code и Codex: проверяет серверные обработчики FiveM — убирает доверие к клиенту, добавляет проверки дистанции, ACE и лимиты. Закрывает векторы, через которые читеры шлют поддельные события. CX Codex +1 566установок fivem-basics Скилл fivem-basics для FiveM Lua: раскладывает ресурс по client/server/shared, пишет манифест и связывает стороны событиями и экспортами. CX Codex +1 509установок lua-basics Скилл lua-basics задаёт ИИ-агенту стиль Lua-кода для ресурсов FiveM: именование, локальные переменные, таблицы и обработка ошибок. CX Codex +1 436установок fivemanage Скилл учит агента работать с SDK Fivemanage: снимать скриншоты игроков, загружать картинки и отправлять логи в дашборд через exports.fmsdk. CX Codex +1 367установок esx-framework Скилл esx-framework ведёт агента по API ESX Legacy для ресурсов FiveM: сервер и клиент, xPlayer, PlayerData, колбэки, работы и деньги. CX Codex +1 319установок qbcore-framework Скилл qbcore-framework помогает создавать ресурсы FiveM для qb-core, генерируя серверный и клиентский код на Lua с проверками аргументов и правильной работой с объектом Player. CX Codex +1 272установок oxmysql Помогает писать серверный SQL-код для FiveM через oxmysql. Включается при работе с запросами к базе данных и миграции с mysql-async. CX Codex +1 124установок oxlib Помогает писать Lua-код для ox_lib в ресурсах FiveM. Подключается при работе с интерфейсом, зонами, командами или обменом данными между клиентом и сервером. CX Codex +1 117установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой