qbcore-framework — скилл для Claude Code: что делает и как установить
Скилл qbcore-framework помогает создавать ресурсы FiveM для qb-core, генерируя серверный и клиентский код на Lua с проверками аргументов и правильной работой с объектом Player.
MIT 272 установок ★ 20 обновлён 2026-10-17
npx skills add germanfndez/fiveai-skills --skill qbcore-framework -a claude-codeЧто делает qbcore-framework
Скилл настраивает работу ассистента с ресурсами FiveM на базе qb-core. Он задаёт разделение между клиентом и сервером: мутации баланса, предметов, банд и работ выполняются только через серверный объект Player, а клиент получает актуальные данные через структуру QBCore.PlayerData после загрузки персонажа.
В логику заложены обязательные правила надёжности: проверка полученного Player на nil, указание причины при вызовах AddMoney или RemoveMoney, а также строгая валидация входящих клиентских аргументов. Передачу данных на клиент скилл реализует через колбэки QBCore.Functions.CreateCallback вместо парных событий, а для диалогов и меню ориентируется на библиотеку ox_lib.
Если проект написан под qbx_core, инструкции скилла неприменимы из-за расхождений в экспортах и методах ядра.
Какие задачи решает
- Написать серверный обработчик для списания средств и начисления предметов через методы
Player.Functionsс обязательным указанием причины - Организовать передачу данных между клиентом и сервером с помощью колбэков
QBCore.Functions.CreateCallbackвместо спаренных сетевых событий - Добавить предварительную проверку существования объекта
Playerи валидацию переданных клиентом аргументов перед изменением состояния - Настроить корректное изменение фракций, банд и постоянных метаданных персонажа в серверной части ресурса
Примеры запросов агенту
- Напиши серверную часть магазина для qb-core: проверь баланс, спиши деньги через RemoveMoney с понятной причиной и выдай предмет в инвентарь.
- Создай серверный колбэк QBCore.Functions.CreateCallback для проверки банковского счёта перед открытием банкомата.
- Сделай клиентский скрипт меню через ox_lib, который запрашивает статус дежурства персонажа из QBCore.PlayerData.
Как установить qbcore-framework
1Через Skills CLI (Vercel)
npx skills add germanfndez/fiveai-skills --skill qbcore-framework -a claude-code2Вручную: положить файлы
~/.claude/skills/qbcore-framework/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/qbcore-framework/
1Через Skills CLI (Vercel)
npx skills add germanfndez/fiveai-skills --skill qbcore-framework -a codex2Вручную: положить файлы
.agents/skills/qbcore-framework/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add germanfndez/fiveai-skills --skill qbcore-framework -a cursor2Вручную: положить файлы
.cursor/skills/qbcore-framework/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install germanfndez/fiveai-skills skills/qbcore-framework2Вручную: положить файлы
.github/skills/qbcore-framework/SKILL.md1Через Skills CLI (Vercel)
npx skills add germanfndez/fiveai-skills --skill qbcore-framework -a gemini-cli2Командой платформы
gemini skills install https://github.com/germanfndez/fiveai-skills --path skills/qbcore-frameworkВручную: положить файлы
.devin/skills/qbcore-framework/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add germanfndez/fiveai-skills --skill qbcore-framework -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о qbcore-framework
Как установить qbcore-framework в Claude Code?
Выполните команду npx skills add germanfndez/fiveai-skills --skill qbcore-framework -a claude-code. Конфигурация сохранится в файле ~/.claude/skills/qbcore-framework/SKILL.md.
Можно ли применять этот скилл для серверов на Qbox?
Нет, скилл написан строго под оригинальный qb-core. В qbx_core отличаются имена экспортов и сигнатуры функций, поэтому применять эти правила напрямую нельзя.
Где выполняются операции с деньгами и инвентарём?
Методы Player.Functions вызываются только на стороне сервера после получения игрока через QBCore.Functions.GetPlayer(source). Клиентский код менять баланс и выдавать предметы не должен.
Исходный текст
SKILL.md · MIT
--- name: qbcore-framework description: "Trigger: QBCore, qb-core, Player object, PlayerData, QBCore.Functions.GetPlayer, Player.Functions, QBCore callbacks, jobs, gangs, economy. Build qb-core resources with player methods, callbacks and events." license: MIT metadata: author: germanfndez version: "1.0.0" --- # QBCore Framework Server/client API for qb-core: Player object, PlayerData, callbacks, jobs, gangs, money and metadata. ## Activation Contract Load this skill when the user creates or edits a qb-core resource, touches `Player` / `QBCore.PlayerData`, needs jobs, gangs, money, items or metadata through QBCore, or asks about QBCore callbacks, events or best practices. This skill targets qb-core (qbcore-framework). If the user is on Qbox (`qbx_core`, `exports.qbx_core`), the APIs diverge: state it and do not apply this skill blindly. ## Hard Rules - Acquire the core once with `local QBCore = exports['qb-core']:GetCoreObject()`; never call it inside every function. - `Player` exists on the SERVER only (`QBCore.Functions.GetPlayer(source)`). `QBCore.PlayerData` exists on the CLIENT only, populated after `QBCore:Client:OnPlayerLoaded`. - Always nil-check: `if not Player then return end` before calling any method. - Money, jobs, gangs, items and metadata are mutated on the server through `Player.Functions.*`, never from the client. - Pass a `reason` to `AddMoney`, `RemoveMoney`, `SetMoney`. - Use state bags OR events for a given piece of state, never both. - Validate every client-supplied argument on the server; never trust amounts, prices or item names sent by the client. - Prefer ox_lib for notifications, menus, dialogs and progress bars. - Use dynamic `Wait()` values in loops; avoid `Wait(0)` unless per-frame work is required. ## Decision Gates | Need | Use | |---|---| | Client asks server for data | `QBCore.Functions.CreateCallback` + `QBCore.Functions.TriggerCallback` | | Money | `Player.Functions.AddMoney/RemoveMoney/SetMoney/GetMoney(moneyType, ...)` | | Job / duty / gang | `Player.Functions.SetJob`, `SetJobDuty`, `SetGang` | | Persistent per-player flags | `Player.Functions.SetMetaData` / `GetMetaData` | | Items (qb-inventory) | `Player.Functions.AddItem/RemoveItem/GetItemByName/GetItemBySlot` | | Shared runtime state | state bags (see rules/core-concepts.md) | ## Execution Steps 1. Confirm `qb-core` starts before the resource; cache `QBCore` per side. 2. Decide the side: mutation and validation on server, display on client. 3. Fetch `Player`, nil-check, then validate every client-supplied argument. 4. Pick the call from Decision Gates; read the matching rules file for signatures. 5. Return data via callbacks, not paired events. ## Output Contract Return runnable Lua with the client/server split explicit, `Player` nil-checked, and reasons on money operations. Use ox_lib for UI unless the user asks otherwise. ## References - rules/core-concepts.md — architecture, PlayerData, Player object, events, state bags. - rules/player-methods.md — Player.Functions money, job, gang, metadata, items. - rules/best-practices.md — naming, caching, waits, state management, security. - rules/reference-links.md — official QBCore documentation links. Upstream docs: https://docs.qbcore.org
© germanfndez · MIT · germanfndez/fiveai-skills