ox-inventory — скилл для Claude Code: функции и установка
Скилл для Claude Code помогает писать Lua-код для ox_inventory: управлять предметами, тайниками, магазинами и реакциями на действия игроков.
MIT 104 установок ★ 20 обновлён 2026-10-17
npx skills add germanfndez/fiveai-skills --skill ox-inventory -a claude-codeЧто делает ox-inventory
Скилл подсказывает, как вызывать серверные и клиентские экспорты ox_inventory и разделять операции между сторонами. Для выдачи и удаления предметов он использует серверные функции; клиентские оставляет для отображения и решений интерфейса. Если добавляется новый предмет, скилл включает запись для data/items.lua.
Для обмена порядок такой: сначала CanCarryItem, затем списание оплаты, вызов AddItem и проверка результата. AddItem может завершиться неудачей, если превышен вес или закончились слоты. Вызовы идут через exports.ox_inventory, глобальной таблицы нет.
Перед запуском ox_inventory должны стартовать ox_lib и ядро выбранного фреймворка. Поддерживаются ox_core, esx и qbx_core; для реакции на перемещения, открытия и покупки скилл предлагает хуки вместо опроса.
Какие задачи решает
- выдать или забрать предмет на сервере
- проверить количество предмета и свободное место
- зарегистрировать тайник или магазин
- описать новый предмет в
data/items.lua - обрабатывать действия через хуки
Примеры запросов агенту
- Добавь игроку предмет и проверь, удалось ли его выдать.
- Создай тайник для этой точки и настрой его регистрацию.
- Перенеси обработку инвентаря с
qb-inventoryнаox_inventory.
Как установить ox-inventory
1Через Skills CLI (Vercel)
npx skills add germanfndez/fiveai-skills --skill ox-inventory -a claude-code2Вручную: положить файлы
~/.claude/skills/ox-inventory/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/ox-inventory/
1Через Skills CLI (Vercel)
npx skills add germanfndez/fiveai-skills --skill ox-inventory -a codex2Вручную: положить файлы
.agents/skills/ox-inventory/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add germanfndez/fiveai-skills --skill ox-inventory -a cursor2Вручную: положить файлы
.cursor/skills/ox-inventory/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install germanfndez/fiveai-skills skills/ox-inventory2Вручную: положить файлы
.github/skills/ox-inventory/SKILL.md1Через Skills CLI (Vercel)
npx skills add germanfndez/fiveai-skills --skill ox-inventory -a gemini-cli2Командой платформы
gemini skills install https://github.com/germanfndez/fiveai-skills --path skills/ox-inventoryВручную: положить файлы
.devin/skills/ox-inventory/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add germanfndez/fiveai-skills --skill ox-inventory -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об ox-inventory
Как установить ox-inventory в Claude Code?
Выполни npx skills add germanfndez/fiveai-skills --skill ox-inventory -a claude-code. Файл скилла находится по пути ~/.claude/skills/ox-inventory/SKILL.md.
Что делает ox-inventory?
Скилл помогает писать Lua-код для работы с предметами, тайниками, магазинами и хуками ox_inventory. Он также задаёт разделение серверных операций и клиентского отображения.
С какими фреймворками работает ox-inventory?
Поддерживаются ox_core, esx и qbx_core. Перед запуском ox_inventory должны стартовать ox_lib и ядро фреймворка.
Исходный текст
SKILL.md · MIT
--- name: ox-inventory description: "Trigger: ox_inventory, items, stash, AddItem, RemoveItem, metadata, item registration, inventory hooks, shops. Server and client exports for ox_inventory." license: MIT metadata: author: germanfndez version: "1.0.0" --- # ox_inventory Slot-based inventory with weight, metadata, stashes, shops and hooks. Supports ox_core, esx and qbx_core. ## Activation Contract Load this skill when the user asks to give, take, count or check items, register a stash or shop, define a new item, react to inventory actions, or migrate from qb-inventory or esx inventory. ## Hard Rules - Call everything through `exports.ox_inventory:<fn>(...)`. There is no global table. - Grant, remove and count items on the SERVER only. Client exports are for display and UI decisions. - `AddItem` can fail. Always check the return value: the player may be over weight or out of slots. - Check `CanCarryItem` BEFORE taking payment or removing the traded item, never after. - Never invent item names. An item must exist in `data/items.lua` or it silently fails. - `inv` is a player source, an identifier, or a stash id. Passing the wrong one returns nil, not an error. - Metadata makes items non-stackable when it differs. Do not put volatile data in metadata. ## Decision Gates | Goal | Call | |---|---| | Give an item | `AddItem(inv, item, count, metadata, slot)` | | Take an item | `RemoveItem(inv, item, count, metadata, slot)` | | Check space first | `CanCarryItem(inv, item, count, metadata)` | | How many does the player have | `GetItemCount(inv, item, metadata, strict)` | | Read one slot | `GetSlot(inv, slot)` | | Find items across slots | `Search(inv, 'slots'\|'count', item, metadata)` | | Persistent storage | `RegisterStash(...)` | | Short-lived storage | `CreateTemporaryStash(properties)` | | React to a player action | `registerHook(event, cb, options)` | ## Execution Steps 1. Confirm `ox_inventory` starts after `ox_lib` and the framework core. 2. Decide the side: mutation is server, display is client. 3. For a trade or reward, order the calls: `CanCarryItem` -> take payment -> `AddItem` -> verify the return. 4. Define any new item in `data/items.lua` before referencing it. Read rules/items.md. 5. Use hooks instead of polling when reacting to moves, opens or purchases. ## Output Contract Return runnable Lua using `exports.ox_inventory`, with the server/client split explicit. Include the `data/items.lua` entry whenever a new item is introduced. ## References - rules/server-exports.md — item and inventory functions on the server. - rules/client-exports.md — weight, current weapon, opening inventories. - rules/items.md — defining items in data/items.lua. - rules/stashes.md — stashes, shops and temporary storage. - rules/hooks.md — registerHook and cancelling actions. Upstream docs: https://overextended.dev/ox_inventory
© germanfndez · MIT · germanfndez/fiveai-skills