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

qbcore-framework — скилл для Claude Code: что делает и как установить

Скилл qbcore-framework помогает создавать ресурсы FiveM для qb-core, генерируя серверный и клиентский код на Lua с проверками аргументов и правильной работой с объектом Player.

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

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

Что делает 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-code

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

~/.claude/skills/qbcore-framework/SKILL.md

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

По шагам, с командами для каждой платформы: Как установить скилл в 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

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

Все скиллы по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
fivem-dev melihbozkurt10 Скилл fivem-dev ведёт разработку ресурсов FiveM под QBox, QBCore и ESX: подтягивает нативы, API фреймворков и модели ассетов вместо догадок. CX Codex +1 521установок roblox-monetization TabooHarmony Скилл roblox-monetization для Claude Code: работа с покупками в Roblox (Game Passes, Developer Products, подписки, приватные серверы). Помогает отследить, почему покупка не выдала предмет. CX Codex +1 3 400установок msw-combat-system MSW-Git Скилл msw-combat-system для Claude Code описывает нативную боевую систему MSW для 2D-игр: расчёт атак, эффекты попадания и поведение врагов. CX Codex +1 11 000установок msw-scripting MSW-Git Скилл msw-scripting помогает писать скрипты .mlua для MapleStory Worlds, соблюдая архитектуру компонентов и пространств выполнения. Пригодится при разработке игровой логики и отладке в MSW. CX Codex +1 11 000установок love2d-core gamedev-skills Скилл love2d-core для Claude Code отлаживает игры на LÖVE 11.x в Lua, настраивает циклы и масштабирование графики. Подключается при работе с файлом main.lua и проверке рендеринга. CX Codex +1 10 200установок roblox-characters gamedev-skills Скилл roblox-characters для Claude Code помогает чинить скрипты персонажей Roblox, их анимации и управление движением. Активируется при сбоях после возрождения, проблемах с репликацией или конфликте спринта с Humanoid. CX Codex +1 9 300установок

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

Весь набор →
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установок oxmysql Помогает писать серверный SQL-код для FiveM через oxmysql. Включается при работе с запросами к базе данных и миграции с mysql-async. CX Codex +1 124установок oxlib Помогает писать Lua-код для ox_lib в ресурсах FiveM. Подключается при работе с интерфейсом, зонами, командами или обменом данными между клиентом и сервером. CX Codex +1 117установок fivem-deployment Скилл fivem-deployment для Claude Code подбирает и проверяет сборки FXServer. Включается при обновлении сервера, настройке server.cfg или поиске причины, по которой клиенты не подключаются. CX Codex +1 114установок ox-inventory Помогает писать Lua-код для ox_inventory: управлять предметами, тайниками, магазинами и реакциями на действия игроков. CX Codex +1 104установок

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

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