SuperAPI AI 工具集

esx-framework

编程与开发

查看项目

更新于 10-16 03:48

技能介绍

用途:为 FiveM 服务器开发基于 ESX Framework(Legacy)的资源,提供开发规范与代码模式参考。

主要能力:涵盖核心对象获取、服务端玩家数据、回调、物品与数据库、标准资源结构及最佳实践。

核心对象获取:ESX Legacy 新方式为 local ESX = exports["es_extended"]:getSharedObject();兼容旧方式为 local ESX = nil 配合 TriggerEvent('esx:getSharedObject', function(obj) ESX = obj end)。

关键概念:服务端通过 ESX.GetPlayerFromId(source) 获取 xPlayer 对象,常用方法包括 xPlayer.addMoney、xPlayer.setJob、xPlayer.addInventoryItem。回调方面,服务端用 ESX.RegisterServerCallback 响应客户端请求,客户端用 ESX.TriggerServerCallback 请求数据。物品定义在数据库 items 表或 ox_inventory 中,数据库通常使用 oxmysql。

标准资源结构:my-resource/ 下含 fxmanifest.lua、config.lua、client/main.lua、server/main.lua、locales/en.lua。

最佳实践:优先使用新导出 exports["es_extended"]:getSharedObject();使用 xPlayer 前先校验是否存在;使用 ESX.SecureNetEvent(若可用)或手动检查保护事件;以 OneSync Infinity 为前提开发,实体在服务端创建。

文档:官方文档 https://documentation.esx-framework.org/ ,GitHub 仓库 https://github.com/esx-framework/esx_core 。

限制:资料未提供具体版本兼容范围、安装步骤、收费与授权信息,暂未提供。