FiveM Native 数据库 搜索
通过名称、哈希或类别搜索200+常用FiveM natives。获取参数、返回类型、描述和Lua示例。
此工具的用途
FiveM暴露了数千个游戏native函数，它们的名称描述的是引擎而非任务，因此找到正确的通常意味着你已经知道它。此搜索仅限于服务器开发中实际使用的native函数，按区域分组，每条目旁边有参数、返回类型和使用示例。
如何使用
- 步骤 1:
如果你知道名称就按名称搜索，或者浏览与你任务匹配的类别，例如车辆或行人。
- 步骤 2:
阅读参数。参数顺序很重要，Lua中没有命名参数。
- 步骤 3:
检查返回类型。许多native函数返回一个句柄，你必须保留它以便后续修改实体。
- 步骤 4:
复制示例并进行调整，而不是凭记忆编写调用。
常见问题
客户端native和服务器native有什么区别？
大多数游戏 natives 只存在于客户端，因为只有客户端渲染世界。服务器拥有的 natives 集合要小得多，主要围绕玩家、实体和标识符。服务器上调用客户端 native 会导致该 native 不存在并抛出错误。
为什么 native 返回空？
通常是实体尚不存在或不属于该客户端。模型需要先调用 RequestModel 并等待 HasModelLoaded，实体 natives 对于玩家范围外的任何实体都会返回零。
我可以通过 hash 调用 natives 吗？
可以，使用 Citizen.InvokeNative 传入 hash 可行，有时这是没有 Lua 包装器的 natives 唯一调用方式。它可读性较差，因此如果有命名形式，优先使用命名形式。
我怎么知道一个 native 是否开销大？
每次 native 调用都会从 Lua 进入游戏引擎，因此开销取决于调用次数，而非单次调用。一个 native 在 0 毫秒循环中每秒调用六十次。缓存每帧不变的结果。