fivem-natives-skill

FiveM 原生函数技能

FiveM 原生函数的完整参考，数据从 cfxnatives.dev 自动更新，并按命名空间整理。开发 FiveM 资源时，可使用此技能获取准确的原生函数签名、参数、返回类型和示例。

此技能提供的内容

• 按命名空间分类的原生函数参考 — PED、VEHICLE、NETWORK、CFX、HUD、GRAPHICS 及另外 40 多个命名空间，每个命名空间各有一个文件
• 类型参考 — 说明所有原生类型：Ped、Vehicle、Entity、Vector3、Hash、Player 等
• 最佳实践 — FiveM 专属的性能、线程、事件、安全和实体管理模式

文件

文件	描述
docs/index.md	所有命名空间的索引及原生函数数量
docs/{namespace}.md	该命名空间下的所有原生函数（例如 docs/ped.md）
docs/types-reference.md	原生类型定义和用法
docs/best-practices.md	FiveM 开发最佳实践

版本控制

版本格式：{generator-semver}+natives.{YYYYMMDD}

标签模式	含义
v1.0.0	生成器代码发生变更（手动发布）
natives-20260324	原生函数数据已更新（自动更新，每 3 天一次）

在 Claude Code 中使用

将以下内容添加到项目的 CLAUDE.md 中：

## FiveM Natives Reference
See the files in @docs/ for the complete FiveM native function reference.
- @docs/index.md — namespace index
- @docs/ped.md — PED natives
- @docs/vehicle.md — VEHICLE natives
- @docs/best-practices.md — development guidelines

或者使用 @docs/ 目录引用一次性导入所有文档。

更新

bun run build         # rebuild only if natives changed
bun run build:force   # always rebuild

GitHub Actions 工作流每 3 天自动运行一次，并提交和标记所有变更。