详细讲解一下给BUFF、物品对象（包括装备位）和其他对象（如怪物、宝宝、NPC、虚拟体）添加自定义数据流程、接口定义、参数以及参数是否的限制，使用添加自定义接口后服务器是否会给客户端发送事件或事件通知？给出示例代码

根据服务端接口文档，给不同对象添加自定义数据的流程和接口如下： ## 一、自定义数据接口概述 ### 1. 保存型变量（支持玩家、物品、门派对象） - **设置接口**：`setint`、`setstr` - **获取接口**：`getint`、`getstr` - **特点**：支持设置限时时间，使用`setvarlimittime`接口设置 ### 2. 临时型变量（支持玩家、怪物、物品、npc、门派对象） - **设置接口**：`settempint`、`settempstr` - **获取接口**：`gettempint`、`gettempstr` - **特点**：临时存储，不持久化 ## 二、BUFF对象自定义数据 ### 设置BUFF自定义字符串值 ```lua setbuffcustdata(actor, buffid, str) ``` **参数**： - `actor`：玩家对象（必选） - `buffid`：BUFFID（必选，整数） - `str`：字符串值（可选） ### 获取BUFF自定义字符串值 ```lua local data = getbuffcustdata(actor, buffid) ``` ## 三、物品对象（包括装备位）自定义数据 ### 1. 物品标记值操作 ```lua -- 修改物品标记值 changeitemaddvalue(actor, itemKey, markID, operator, value) -- 获取物品标记值 local value = itematt(actor, itemKey.."_"..markID) ``` **说明**： - `itemKey`格式：物品对象_标记ID 或 装备位_标记ID - 标记ID范围：0-39 ### 2. 自定义属性操作 ```lua -- 设置装备自定义属性 changecustomitemabil(actor, itemKey, group, attrPos, attrID, attrValue) -- 设置自定义属性显示 changecustomitemcaption(actor, itemKey, group, attrPos, captionId, pos) -- 设置自定义属性标题 changecustomitemtext(actor, itemKey, group, text) ``` **参数限制**： - `group`：分组位置，范围0-5 - `attrPos`：属性位置，范围0-9（每组支持10个属性） - `attrID`：属性ID，绑定AttScore属性表里的ID - `captionId`：ItemTipsCaption ID ### 3. 获取自定义属性信息 ```lua -- 获取自定义属性信息 local info = custitemattinfo(actor, "物品对象_分组_属性位_字段") -- 获取自定义属性标题 local title = custitemattgroupinfo(actor, "物品对象_分组_TITLE") -- 获取自定义属性的值 local value = custitemattidvalue(actor, "物品对象_分组_属性id") -- 获取全身自定义属性的值 local allValues = custitemattidallvalue(actor, "分组_属性ID") ``` ## 四、玩家对象自定义数据 ### 1. JSON格式自定义数据 ```lua -- 设置 setplayercustjosndata(actor, key, value) -- 客户端获取方法： -- 1. 查看目标玩家信息：SL:RequestLookPlayer -- 2. 监听事件：LUA_EVENT_RESPONSE_LOOK_PLAYER_INFO -- 3. 获取数据：SL:GetValue("L.M.CUSTOM_DATA", "key") ``` **注意**：key禁止大写 ### 2. 字符串格式自定义数据 ```lua -- 设置 setplayercustdata(actor, value) -- 客户端获取方法： -- 监听LUA_EVENT_RESPONSE_LOOK_PLAYER_INFO事件 -- 获取SL:GetValue(L.M.CUSTOM_DATA) ``` ## 五、其他对象自定义数据 ### 设置对象相关信息 ```lua settargetinfo(actor, strParam, param) ``` **支持对象**：玩家、怪物、宝宝、npc、虚拟体 **示例**： ```lua -- 设置转职等级 settargetinfo(actor, "RELEVEL", 8) ``` ## 六、事件通知机制 ### 1. 物品更新通知 使用`updateitemtoclient`接口刷新物品信息到前端后，客户端会自动更新显示。 ### 2. 玩家自定义数据通知 客户端通过以下方式获取： - 触发`LUA_EVENT_RESPONSE_LOOK_PLAYER_INFO`事件 - 从事件回调中获取自定义数据 ### 3. 其他事件 - `LUA_EVENT_PLAYER_CUSTOMDATA`：其他玩家自定义数据事件 - `LUA_EVENT_AVATAR_CHANGE`：自身头像数据改变 - `LUA_EVENT_AVATARFRAME_CHANGE`：自身头像框数据改变 ## 七、完整示例代码 ### 示例1：BUFF自定义数据 ```lua -- 设置BUFF自定义数据 setbuffcustdata(actor, 10001, "S1") -- 获取BUFF自定义数据 local buffData = getbuffcustdata(actor, 10001) print("BUFF自定义数据：" .. buffData) ``` ### 示例2：物品标记值操作 ```lua -- 获取身上衣服对象 local itemObj = bodyiteminfo(actor, "1_OBJ") -- 修改身上衣服对象标记值 changeitemaddvalue(actor, itemObj, 10, "+", 1) -- 打印身上衣服对象标记值 print(itematt(actor, itemObj.."_10")) -- 刷新到客户端 updateitemtoclient(actor, itemObj) ``` ### 示例3：玩家自定义数据 ```lua -- 服务端设置 setplayercustjosndata(actor, "测试1", "abc") -- 客户端获取 function MainBtnPanel:CallBack1() local userId = SL:GetValue("USER_ID") SL:RequestLookPlayer(userId, false, 66, {"测试1","测试2"}) end function MainBtnPanel:OnLookPlayerInfo(...) print("自定义数据：", SL:GetValue("L.M.CUSTOM_DATA", "测试1")) end function MainBtnPanel:RegisterEvent() SL:RegisterLUAEvent(LUA_EVENT_RESPONSE_LOOK_PLAYER_INFO, "MainBtnPanel", handler(self, self.OnLookPlayerInfo)) end ``` ### 示例4：物品自定义属性 ```lua function addCustomAttributes(actor, itemObj) -- 设置分组标题 changecustomitemtext(actor, itemObj, 0, "[size=22][color=#ff0000]分组0[/color][/size]") -- 设置自定义属性 changecustomitemabil(actor, itemObj, 0, 0, 50, 100) -- 属性ID=50，值=100 changecustomitemabil(actor, itemObj, 0, 1, 51, 200) -- 属性ID=51，值=200 -- 设置属性显示 changecustomitemcaption(actor, itemObj, 0, 0, 15, 11) -- 刷新到客户端 updateitemtoclient(actor, itemObj) end ``` ## 八、注意事项 1. **物品对象获取**： - 通过`bodyiteminfo`获取装备位物品对象 - 通过`bagiteminfo`获取背包物品对象 - 通过`itemobjbymakeindex`根据物品唯一ID获取物品对象 2. **数据持久化**： - 保存型变量：离线保存，支持限时 - 临时型变量：仅在线有效，下线消失 3. **客户端同步**： - 物品数据修改后需调用`updateitemtoclient`同步到客户端 - 玩家自定义数据通过查看玩家面板机制同步 4. **参数验证**： - 所有对象ID需通过`valid`接口验证有效性 - 属性ID需在AttScore.xls表中存在 - 分组和位置参数需在指定范围内