SuperAPI AI 工具集

vrp-framework

数据与分析

查看项目

更新于 10-16 08:07

技能介绍

用途:为 FiveM 服务器开发基于 vRP Creative Network 的资源,使用 Lua 5.4,通过 Proxy(服务端到服务端)与 Tunnel(客户端到服务端)通信。同时兼容 Creative v5 与旧版 vRPEX,两者逻辑一致但函数与文件名不同(v5 用 camelCase、modules/group.lua、config/.lua;vRPEX 用 getUserId 等经典命名、cfg/.lua)。

主要能力:身份体系以 Passport(角色唯一 ID)、Source(连接 ID)、Datatable(角色内存数据)为核心,提供 vRP.Passport、vRP.Source、vRP.Datatable、vRP.Inventory、vRP.Identity 等接口;金钱支持银行、现金、脏钱、宝石、硬币的存取与支付;库存支持 GiveItem、GenerateItem、TakeItem、重量与上限校验;权限组支持 HasPermission、HasGroup、HasService、服务开关与在线人数统计;另有生存状态(饥饿、口渴、感染、复活)、数据库 Prepare/Query(内部使用 oxmysql,参数用 @name)以及服务端/玩家持久数据。

使用方式:服务端资源通过 local Proxy = module("vrp", "lib/Proxy") 与 vRP = Proxy.getInterface("vRP") 获取接口;客户端通过 Tunnel.getInterface("vRP") 调用服务端函数,并用 Proxy.addInterface 与 Tunnel.bindInterface 暴露自身函数。Tunnel 调用加 _ 前缀表示不等待返回(fire-and-forget)。通知可用 TriggerClientEvent("Notify", ...) 与 "NotifyItens"。

适用场景:FiveM 角色扮演服务器的资源开发与维护。限制:应始终使用 Creative Network 原生函数名而非 vRPEX 别名;完整 API、示例、模板与约定见 reference.md、examples.md、templates.md、patterns.md;性能与安全参考 fivem-development,NUI 界面参考 fivem-react-nui。具体收费、平台与效果资料暂未提供。