SuperAPI AI 工具集

oxlib

通用与其它

查看项目

更新于 10-15 21:51

技能介绍

用途:ox_lib 是 FiveM 的共享库,通过全局 lib 提供 UI(通知、对话框、菜单、进度条)、客户端/服务器回调、命令与区域等功能。当用户需要通知、警告或输入对话框、菜单、进度条、TextUI、跨网络请求响应、带类型的服务器命令、区域触发或依赖 ox_lib 的资源时使用。

主要能力与用法:在 fxmanifest.lua 添加 shared_scripts { '@ox_lib/init.lua' } 并确保 ox_lib 先于资源启动,否则 lib 为 nil。跨网络数据优先用 lib.callback / lib.callback.await,而非成对事件。服务器端 lib.callback.register(name, function(source, ...)) 首个参数为 source,需在此校验参数。回调名需唯一(resourcename:action)。UI 函数(lib.notify、lib.alertDialog、lib.inputDialog、lib.progress、lib.context、lib.menu、lib.showTextUI)在客户端渲染,需从服务器触发客户端调用。图标为 Font Awesome 6,默认 solid,品牌图标用 {'fab', 'name'}。lib.addCommand 为服务器端,可用 restricted 控制权限并支持类型化参数(number、playerId、string、longString)。区域 onEnter、onExit 与 inside 在服务器端不可用,需在客户端创建,并保留返回的 zone 以调用 zone:remove()。模块在首次使用时加载,或通过 ox_libs { ... } / lib.require。

选择:提示用 lib.notify({ title, description, type });确认/OK 对话框用 lib.alertDialog;表单输入用 lib.inputDialog(title, rows);客户端请求服务器用 lib.callback.await(name, false, ...) 配合服务器 register;服务器请求客户端用 lib.callback.await(name, source, ...) 配合客户端 register;带参数聊天命令用 lib.addCommand;区域触发用 lib.zones.poly / box / sphere。

限制:UI 仅在客户端渲染;区域方法不可在服务器端使用;缺少 init.lua 与启动顺序则 lib 为 nil;回调名必须唯一。