重要前提
安装AI Skills的关键前提是:必须科学上网,且开启TUN模式,这一点至关重要,直接决定安装能否顺利完成,在此郑重提醒三遍:科学上网,科学上网,科学上网。查看完整安装教程 →
fivem-dev by melihbozkurt10/fivem-dev-plugin
npx skills add https://github.com/melihbozkurt10/fivem-dev-plugin --skill fivem-dev用于 FiveM 资源开发的动态文档编排器。支持 QBox、QBCore、ESX 框架,以及 Lua 和 NUI (JS/TS)。
严禁编造或猜测原生函数、框架 API 或参数。
"I'm not 100% certain about this native/API. Let me fetch the documentation..."
[Use WebFetch to get accurate info]
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
| 类型 | 来源 | 操作 |
|---|---|---|
| 原生函数 | https://docs.fivem.net/natives/ | WebFetch 或告知用户自行检查 |
| QBox API | https://docs.qbox.re/ | WebFetch |
| QBCore API | https://docs.qbcore.org/ | WebFetch |
| ESX API | https://docs.esx-framework.org/ | WebFetch |
| ox_lib | https://overextended.dev/ox_lib | WebFetch |
| 道具/载具 | https://forge.plebmasters.de/ | 引导用户搜索 |
-- DON'T: Inventing a native that might not exist
SetPlayerInvincible(playerId, true) -- Is this real? What are the params?
-- DO: Use verified native with correct params
SetEntityInvincible(PlayerPedId(), true) -- Verified at docs.fivem.net
根据请求仅阅读相关文件:
| 文件 | 描述 | 何时阅读 |
|---|---|---|
frameworks/framework-detection.md | 检测活动框架 | 开始新任务时 |
frameworks/qbox.md | QBox 导出、模式 | QBox 项目 |
frameworks/qbcore.md | QBCore 事件、导出 | QBCore 项目 |
frameworks/esx.md | ESX xPlayer、事件 | ESX 项目 |
scripting/lua-patterns.md | FiveM 的 Lua 惯用法 | 编写 Lua 时 |
scripting/nui-guide.md | NUI HTML/CSS/JS 模式 | 构建 UI 时 |
scripting/client-server.md | 架构模式 | 新建资源时 |
scripting/thread-management.md | 性能模式 | 优化时 |
resources/manifest.md | fxmanifest.lua 参考 | 资源设置时 |
resources/ox-lib-guide.md | ox_lib 实用工具 | 使用 ox_lib 时 |
assets/asset-discovery.md | 查找 GTA V 资源 | 道具、载具、行人模型 |
| 如果用户询问关于... | 操作 |
|---|---|
| 原生函数 (GetPlayerPed, CreateVehicle 等) | 从原生函数文档获取 |
| 框架 API (QBCore.Functions, ESX.GetPlayerData) | 从框架文档获取 |
| ox_lib 功能 (lib.callback, lib.notify) | 从 ox_lib 文档获取 |
| GTA V 资源 (道具、载具、行人模型) | 引导至 PlebMasters |
| 资源结构、清单 | 阅读本地文件 |
| 最佳实践、模式 | 阅读本地文件 |
基础网址: https://docs.fivem.net/natives/
WebFetch(
url: "https://docs.fivem.net/natives/",
prompt: "Find documentation for the native function '{FUNCTION_NAME}'.
Include: parameters, return values, usage examples,
client/server availability."
)
原生函数分类:
| 分类 | 包含 |
|---|---|
| PLAYER | GetPlayerPed, GetPlayerServerId, PlayerId |
| VEHICLE | CreateVehicle, SetVehicleMod, GetVehicleClass |
| PED | CreatePed, SetPedComponentVariation, IsPedInVehicle |
| ENTITY | GetEntityCoords, SetEntityHeading, DeleteEntity |
| GRAPHICS | DrawRect, DrawText3D, DrawMarker |
| UI | SetTextEntry, BeginTextCommandDisplayText |
| CAM | CreateCam, SetCamActive, RenderScriptCams |
| AUDIO | PlaySoundFrontend, PlayAmbientSpeech1 |
| WEAPON | GiveWeaponToPed, GetSelectedPedWeapon |
| CFX | 状态袋、服务端特定原生函数 |
QBox:
WebFetch(
url: "https://docs.qbox.re/",
prompt: "Find documentation for QBox '{FEATURE}'.
Include exports, events, and usage examples."
)
QBCore:
WebFetch(
url: "https://docs.qbcore.org/qbcore-documentation/",
prompt: "Find documentation for QBCore '{FEATURE}'.
Include: function signature, parameters, examples."
)
ESX Legacy:
WebFetch(
url: "https://docs.esx-framework.org/",
prompt: "Find documentation for ESX '{FEATURE}'.
Include: xPlayer methods, events, server/client functions."
)
ox_lib:
WebFetch(
url: "https://overextended.dev/ox_lib",
prompt: "Find documentation for ox_lib '{MODULE}'.
Include: function signatures, options, examples."
)
PlebMasters Forge:
WebFetch(
url: "https://forge.plebmasters.de/",
prompt: "Search for GTA V {ASSET_TYPE} matching '{SEARCH_TERM}'.
Return model names/hashes that can be used in FiveM."
)
资源类型: 物体、载具、行人、武器、服装、动画
触发条件:
GetPlayerPed, CreateVehicle)0x...)操作: 从 https://docs.fivem.net/natives/ 获取
触发条件:
QBCore.Functions.*, QBCore.Player.*exports.qbx_core:*, exports['qb-core']:*ESX.Get*, xPlayer:*, ESX.RegisterServerCallbackexports.es_extended:*操作: 检测框架 → 从相应文档获取
触发条件:
lib.* 函数exports.ox_lib:*操作: 从 https://overextended.dev/ox_lib 获取
触发条件:
操作: 引导至 PlebMasters Forge + 提供使用示例
触发条件:
操作: 阅读相关的本地 Markdown 文件
开始任务时,从项目文件中检测活动框架:
-- QBox 指示器
dependency 'qbx_core'
dependency 'ox_lib'
-- QBCore 指示器
dependency 'qb-core'
-- ESX 指示器
dependency 'es_extended'
dependency 'esx_core'
-- QBox
local QBX = exports.qbx_core:GetCoreObject()
-- QBCore
local QBCore = exports['qb-core']:GetCoreObject()
-- ESX
local ESX = exports.es_extended:getSharedObject()
| 规则 | 原因 |
|---|---|
避免在循环中使用 Wait(0) | 消耗 CPU,导致延迟 |
| 缓存玩家行人模型 | local ped = cache.ped or PlayerPedId() |
| 使用 ox_lib target | 优于距离检查 |
| 状态袋优于事件 | 状态同步更高效 |
| 规则 | 原因 |
|---|---|
| 服务端验证 | 客户端可能被篡改 |
| 清理玩家输入 | 防止注入攻击 |
| 使用回调 | 防止事件利用 |
| 限制操作频率 | 防止滥用/刷屏 |
resource_name/
├── fxmanifest.lua
├── config.lua
├── client/
│ └── main.lua
├── server/
│ └── main.lua
├── shared/
│ └── config.lua
└── html/ # NUI
├── index.html
├── style.css
└── script.js
local Framework = {}
if GetResourceState('qbx_core') ~= 'missing' then
Framework.Core = exports.qbx_core:GetCoreObject()
Framework.Type = 'qbox'
elseif GetResourceState('qb-core') ~= 'missing' then
Framework.Core = exports['qb-core']:GetCoreObject()
Framework.Type = 'qbcore'
elseif GetResourceState('es_extended') ~= 'missing' then
Framework.Core = exports.es_extended:getSharedObject()
Framework.Type = 'esx'
end
return Framework
| 不要 | 应该 |
|---|---|
while true do Wait(0) | 使用适当的等待或事件 |
| 信任客户端数据 | 始终在服务端验证 |
| 硬编码框架 | 动态检测 |
| 每帧获取数据 | 使用缓存并设置刷新间隔 |
| 全局变量 | 使用局部变量,进行封装 |
| 需求 | 技能 |
|---|---|
| NUI 设计 | frontend-design |
| 数据库设计 | database-design |
| 安全审计 | vulnerability-scanner |
| 性能 | performance-profiling |
每周安装量
60
仓库
GitHub 星标数
3
首次出现
Jan 26, 2026
安全审计
安装于
codex58
gemini-cli56
opencode56
amp55
github-copilot55
kimi-cli55
Dynamic documentation orchestrator for FiveM resource development. Supports QBox, QBCore, ESX frameworks with Lua and NUI (JS/TS).
NEVER invent or guess native functions, framework APIs, or parameters.
"I'm not 100% certain about this native/API. Let me fetch the documentation..."
[Use WebFetch to get accurate info]
| Type | Source | Action |
|---|---|---|
| Native functions | https://docs.fivem.net/natives/ | WebFetch or tell user to check |
| QBox API | https://docs.qbox.re/ | WebFetch |
| QBCore API | https://docs.qbcore.org/ | WebFetch |
| ESX API | https://docs.esx-framework.org/ | WebFetch |
| ox_lib | https://overextended.dev/ox_lib | WebFetch |
| Props/Vehicles | https://forge.plebmasters.de/ | Guide user to search |
-- DON'T: Inventing a native that might not exist
SetPlayerInvincible(playerId, true) -- Is this real? What are the params?
-- DO: Use verified native with correct params
SetEntityInvincible(PlayerPedId(), true) -- Verified at docs.fivem.net
Read ONLY relevant files based on the request:
| File | Description | When to Read |
|---|---|---|
frameworks/framework-detection.md | Detect active framework | Starting new task |
frameworks/qbox.md | QBox exports, patterns | QBox project |
frameworks/qbcore.md | QBCore events, exports | QBCore project |
frameworks/esx.md | ESX xPlayer, events | ESX project |
scripting/lua-patterns.md |
| If user asks about... | Action |
|---|---|
| Native function (GetPlayerPed, CreateVehicle, etc.) | FETCH from natives |
| Framework API (QBCore.Functions, ESX.GetPlayerData) | FETCH from framework docs |
| ox_lib feature (lib.callback, lib.notify) | FETCH from ox_lib docs |
| GTA V asset (prop, vehicle, ped model) | GUIDE to PlebMasters |
| Resource structure, manifest | READ local files |
| Best practices, patterns | READ local files |
Base URL: https://docs.fivem.net/natives/
WebFetch(
url: "https://docs.fivem.net/natives/",
prompt: "Find documentation for the native function '{FUNCTION_NAME}'.
Include: parameters, return values, usage examples,
client/server availability."
)
Native Categories:
| Category | Contains |
|---|---|
| PLAYER | GetPlayerPed, GetPlayerServerId, PlayerId |
| VEHICLE | CreateVehicle, SetVehicleMod, GetVehicleClass |
| PED | CreatePed, SetPedComponentVariation, IsPedInVehicle |
| ENTITY | GetEntityCoords, SetEntityHeading, DeleteEntity |
| GRAPHICS | DrawRect, DrawText3D, DrawMarker |
| UI | SetTextEntry, BeginTextCommandDisplayText |
| CAM | CreateCam, SetCamActive, RenderScriptCams |
| AUDIO | PlaySoundFrontend, PlayAmbientSpeech1 |
| WEAPON | GiveWeaponToPed, GetSelectedPedWeapon |
| CFX | Statebags, server-specific natives |
QBox:
WebFetch(
url: "https://docs.qbox.re/",
prompt: "Find documentation for QBox '{FEATURE}'.
Include exports, events, and usage examples."
)
QBCore:
WebFetch(
url: "https://docs.qbcore.org/qbcore-documentation/",
prompt: "Find documentation for QBCore '{FEATURE}'.
Include: function signature, parameters, examples."
)
ESX Legacy:
WebFetch(
url: "https://docs.esx-framework.org/",
prompt: "Find documentation for ESX '{FEATURE}'.
Include: xPlayer methods, events, server/client functions."
)
ox_lib:
WebFetch(
url: "https://overextended.dev/ox_lib",
prompt: "Find documentation for ox_lib '{MODULE}'.
Include: function signatures, options, examples."
)
PlebMasters Forge:
WebFetch(
url: "https://forge.plebmasters.de/",
prompt: "Search for GTA V {ASSET_TYPE} matching '{SEARCH_TERM}'.
Return model names/hashes that can be used in FiveM."
)
Asset Types: objects, vehicles, peds, weapons, clothes, animations
Triggers when:
GetPlayerPed, CreateVehicle)0x...)Action: Fetch from https://docs.fivem.net/natives/
Triggers when:
QBCore.Functions.*, QBCore.Player.*exports.qbx_core:*, exports['qb-core']:*ESX.Get*, xPlayer:*, ESX.RegisterServerCallbackexports.es_extended:*Action: Detect framework → Fetch from appropriate docs
Triggers when:
lib.* functionsexports.ox_lib:*Action: Fetch from https://overextended.dev/ox_lib
Triggers when:
Action: Guide to PlebMasters Forge + provide usage example
Triggers when:
Action: Read relevant local markdown file
When starting a task, detect the active framework from project files:
-- QBox indicators
dependency 'qbx_core'
dependency 'ox_lib'
-- QBCore indicators
dependency 'qb-core'
-- ESX indicators
dependency 'es_extended'
dependency 'esx_core'
-- QBox
local QBX = exports.qbx_core:GetCoreObject()
-- QBCore
local QBCore = exports['qb-core']:GetCoreObject()
-- ESX
local ESX = exports.es_extended:getSharedObject()
| Rule | Why |
|---|---|
Avoid Wait(0) in loops | Burns CPU, causes lag |
| Cache player ped | local ped = cache.ped or PlayerPedId() |
| Use ox_lib target | Better than distance checks |
| Statebags over events | More efficient state sync |
| Rule | Reason |
|---|---|
| Server-side validation | Client can be tampered |
| Sanitize player input | Prevent injection |
| Use callbacks | Prevent event exploitation |
| Rate limit operations | Prevent spam/abuse |
resource_name/
├── fxmanifest.lua
├── config.lua
├── client/
│ └── main.lua
├── server/
│ └── main.lua
├── shared/
│ └── config.lua
└── html/ # NUI
├── index.html
├── style.css
└── script.js
local Framework = {}
if GetResourceState('qbx_core') ~= 'missing' then
Framework.Core = exports.qbx_core:GetCoreObject()
Framework.Type = 'qbox'
elseif GetResourceState('qb-core') ~= 'missing' then
Framework.Core = exports['qb-core']:GetCoreObject()
Framework.Type = 'qbcore'
elseif GetResourceState('es_extended') ~= 'missing' then
Framework.Core = exports.es_extended:getSharedObject()
Framework.Type = 'esx'
end
return Framework
| Don't | Do |
|---|---|
while true do Wait(0) | Use appropriate wait or events |
| Trust client data | Always validate on server |
| Hardcode framework | Detect dynamically |
| Fetch data every frame | Cache with refresh interval |
| Global variables | Use local, encapsulate |
| Need | Skill |
|---|---|
| NUI design | frontend-design |
| Database design | database-design |
| Security audit | vulnerability-scanner |
| Performance | performance-profiling |
Weekly Installs
60
Repository
GitHub Stars
3
First Seen
Jan 26, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykWarn
Installed on
codex58
gemini-cli56
opencode56
amp55
github-copilot55
kimi-cli55
React 组合模式指南:Vercel 组件架构最佳实践,提升代码可维护性
123,700 周安装
资深前端开发工程师AI助手 - 精通React/NextJS/TypeScript/TailwindCSS
224 周安装
Web性能加载优化审计工具集 - 测量FCP、TTFB、渲染阻塞资源与脚本性能
55 周安装
Encore.ts 声明式基础设施:PostgreSQL、Redis、Pub/Sub、定时任务、对象存储
220 周安装
Rams 设计审查工具 - AI 驱动的代码可访问性与视觉设计自动化审查专家
222 周安装
Web Artifacts Builder:React+TypeScript前端工件构建工具,一键打包HTML文件
220 周安装
TransformerLens 可解释性工具:GPT 模型机制分析与激活修补指南
220 周安装
| Lua idioms for FiveM |
| Writing Lua |
scripting/nui-guide.md | NUI HTML/CSS/JS patterns | Building UI |
scripting/client-server.md | Architecture patterns | New resource |
scripting/thread-management.md | Performance patterns | Optimization |
resources/manifest.md | fxmanifest.lua reference | Resource setup |
resources/ox-lib-guide.md | ox_lib utilities | Using ox_lib |
assets/asset-discovery.md | Finding GTA V assets | Props, vehicles, peds |