2026 论坛插件日志 2026年3月9日

一、网站后期通用插件

适配的版本自带以下接口

二、功能模块总览

模块	功能数量	说明
外观系统	10项	时装、坐骑、头饰、背饰等外观展示
装备系统	12项	装备品质、强化、外观、制造者、属性条、洗练
宝石系统	6项	宝石镶嵌、摘除、信息查询、BUG修复
背包系统	5项	背包扩展、材料背包、物品等级、叠加修复
任务系统	2项	2048个自定义任务数据字段
属性系统	5项	属性同步、上限判断、穿刺伤害、基础属性
经济系统	4项	元宝上限、摆摊价格、商店修复、交易修复
技能系统	5项	技能回调、技能使用、冷却控制、经验加成
场景系统	1项	天空盒昼夜切换、场景资源动态替换
门派系统	6项	20个门派初始化、技能扩展、连击点、治疗、陷阱
暗器系统	2项	暗器经验表、暗器经验获取
宠物系统	5项	宠物数据设置、成长率、昵称修改
传送系统	1项	传送点进入/离开事件回调
宝石叠加	1项	宝石可叠加功能
角色数据	1项	角色数据拓展初始化
Lua错误	1项	Lua脚本错误处理
系统修复	14项	各种原版BUG修复、功能扩展

总计：17个模块，80项功能，56个Lua接口函数

---

三、Lua 接口列表

3.1 装备系统接口

函数名	功能说明
LuaFnSetEquipItemCreatorEx	设置装备制造者
LuaFnGetEquipVisual	获取装备外观
LuaFnSetEquipVisual	设置装备外观
LuaFnGetItemQual	获取装备品质
LuaFnSetItemQual	设置装备品质
LuaFnGetEquipEnhanceLevel	获取装备强化等级
LuaFnSetEquipEnhanceLevel	设置装备强化等级
LuaFnGetEquipAttrCount	获取装备属性条数量
LuaFnGetEquipAttrDataByIndex	获取装备属性数据
LuaFnRewashEquipAttr	重洗装备属性
LuaFnResetEquipQualAndAttr	重置装备品质和属性
LuaFnEquipTransToNew	装备转移升级
LuaFnSetEquipSlot	设置装备宝石槽数量
LuaFnSetEquipGemInfo	设置装备宝石信息
LuaFnNotifyEquipAttr	通知装备属性变化
LuaFnUpdateHumanEquipDataToTarget	同步装备数据给目标

3.2 宝石系统接口

函数名	功能说明
LuaFnGetGemInfoInEquip	获取装备宝石信息
LuaFnAddNewGemToItem	镶嵌宝石
LuaFnRemoveGemFromItem	摘除宝石
LuaFnGemTypeByGemTableID	获取宝石类型

3.3 属性系统接口

函数名	功能说明
LuaFnGetHumanAttrData	获取角色属性数据
LuaFnGetHumanBaseValue	获取角色基础属性
LuaFnGetEquipChuanCi	获取角色穿刺伤害
LuaFnSetChuanCiDamage	设置穿刺伤害
LuaFnRefreshHumanData	刷新角色数据

3.4 技能系统接口

函数名	功能说明
LuaFnHumanUseSkill	角色使用技能
LuaFnResetSkillCooldowns	重置技能冷却
LuaFnGetSkillCoolDownByCoolDwonId	获取技能冷却时间
LuaFnSetSkillCoolDownByCoolDwonId	设置技能冷却

3.5 宠物系统接口

函数名	功能说明
LuaFnSetPetData	设置宠物数据
LuaFnGetPetGrowRateData	获取宠物成长率
LuaFnGetPetNickName	获取宠物昵称
LuaFnSetPetNickName	设置宠物昵称
LuaFnRefreshPetObject	刷新宠物对象

3.6 任务系统接口

函数名	功能说明
LuaFnGetMissionData	获取任务数据
LuaFnSetMissionData	设置任务数据
LuaFnUpdateMissionDataToClient	同步任务数据到客户端

3.7 外观系统接口

函数名	功能说明
LuaFnSetExteriorInfo	设置外观信息

3.8 物品系统接口

函数名	功能说明
LuaFnGetItemLayNum	获取物品叠加数量
LuaFnGetItemRuleByItemIndex	获取物品规则ID
LuaFnMtl_CostMaterial	消耗材料
LuaFnMtl_GetCostNum	获取材料数量

3.9 怪物系统接口

函数名	功能说明
LuaFnCreateMonsterEx	创建怪物
LuaFnDeleteMonsterEx	删除怪物

3.10 地图系统接口

函数名	功能说明
LuaFnIsMapMove	判断是否可以移动
LuaFnGetMapSize	获取地图大小

3.11 其他接口

函数名	功能说明
LuaFnGetAccountName	获取账号名
LuaFnBanPlayer	封禁玩家
LuaFnReLoadLua	重新加载Lua脚本
LuaFnReloadTxtFileTable	重新加载配置文件
LuaFnLoadAllowableScriptFunc	加载允许的脚本函数
LuaFnGetSceneIdAndSelfIdByGUID	通过GUID获取场景和对象ID

---

四、详细功能说明

4.1 外观系统（易容阁）

插件扩展了角色外观展示功能，支持10种外观元素：

外观元素	说明
时装	角色时装外观ID
坐骑	角色坐骑外观ID
脸型	角色脸型样式ID
发型	角色发型样式ID
头像框	角色头像框ID
幻饰武器	武器幻化外观ID
头饰	头部装饰外观ID
背饰	背部装饰外观ID
魂录	宠物魂录外观ID
武魂	武魂外观ID

功能特点：

• 外观数据实时同步
• 支持数据库持久化
• 外观设置上限提升至65535
• 重楼装备外观写死问题修复

4.2 装备系统

装备基础属性

• 制造者设置：支持设置装备制造者名字
• 外观读写：获取/设置装备外观ID
• 品质读写：获取/设置装备品质等级
• 隐藏属性：获取/设置装备隐藏属性值

装备强化系统

• 强化等级读写：获取/设置装备强化等级
• 强化上限提升：强化等级上限提升至255级
• 位置支持扩展：装备位置支持扩展到118个
• 穿刺伤害：根据强化等级计算穿刺伤害和减免

装备属性条系统

• 属性条数量：获取装备的属性条数量
• 属性条数据：获取指定索引的属性类型和值
• 重洗属性：重新随机生成属性条
• 重置品质属性：重置装备品质和所有属性
• 添加属性类型：添加指定类型的属性条
• 移除属性类型：移除指定类型的属性条

装备宝石系统

• 宝石信息查询：获取装备上所有宝石信息
• 宝石镶嵌：为装备镶嵌宝石
• 宝石摘除：从装备移除宝石
• 宝石槽设置：设置装备的宝石槽数量
• 宝石信息设置：直接设置装备的宝石信息

4.3 宝石系统修复

• 镶嵌扣除修复：修复镶嵌宝石时扣除全部道具的BUG
• 摘除扣除修复：修复摘除宝石时扣除全部摘除符的BUG
• 绑定状态修复：修复宝石摘除后绑定状态异常问题
• 叠加修复：修复绑定与非绑定宝石叠加问题
• 摘除绑定：宝石摘除后自动变为绑定状态

4.4 背包系统

• 物品等级查询：获取背包中指定位置物品的等级
• 背包格子扩展：扩展背包格子数量支持到118个
• 材料背包起始：获取材料背包起始位置索引
• 材料背包结束：获取材料背包结束位置索引
• 叠加修复：修复绑定与非绑定物品叠加问题

4.5 任务系统（MDEX）

任务扩展数据系统：

• 支持2048个自定义任务数据字段
• 数据类型：整数（INT）
• 索引范围：0-2047
• 系统保留：0-500（建议自定义数据使用500以上）
• 应用场景：自定义任务进度、活动数据、玩家状态等

4.6 属性系统

• 属性同步：修复角色属性同步上限判断问题
• 上限提升：属性值上限提升至21亿
• 详细属性：修复详细属性面板显示问题
• 穿刺伤害：计算装备提供的穿刺伤害
• 基础属性：获取角色的基础属性值
• 属性刷新：重新计算角色所有属性

4.7 经济系统

• 元宝上限：元宝和赠点上限提升至21亿
• 摆摊价格：摆摊商品价格上限提升至21亿
• 商店修复：修复NPC商店售卖物品问题
• 交易修复：修复交易时元宝扣除问题

4.8 场景系统（天空盒）

• 天空盒昼夜切换：根据时间自动切换场景天空盒资源
• 场景资源动态替换：支持白天/黑夜两种场景资源自动切换
• 时间配置：通过场景配置设置切换时间段

4.9 技能系统

• 技能使用：让角色使用指定技能
• 技能回调：技能使用成功回调
• 冷却重置：重置角色所有技能冷却
• 冷却查询：获取技能剩余冷却时间
• 冷却设置：设置技能冷却时间
• 经验加成：修复经验加成计算问题
• 经验上限：经验值上限提升

4.9 门派系统扩展

门派数量扩展：

• 原版支持10个门派
• 插件扩展支持20个门派

功能列表：

• 门派初始化扩展：支持20个门派的扩展初始化
• 门派技能扩展：技能模板数据管理扩展
• 连击点消耗：门派连击点消耗回调
• 治疗目标：门派治疗目标回调
• 陷阱激活：门派陷阱激活回调
• 门派经验加成：获取经验额外加成率

4.10 暗器系统

• 暗器经验表：暗器等级经验表扩展
• 暗器经验获取：暗器经验计算和存储

4.11 传送系统

• 传送点事件：角色进入/离开传送点时触发Lua回调
• OnEnterArea：进入传送点区域时调用
• OnLeaveArea：离开传送点区域时调用

4.12 宝石叠加系统

• 宝石可叠加：支持宝石物品叠加存放
• 叠加数量：根据配置决定最大叠加数

4.13 角色数据拓展

• 数据初始化：角色登录时初始化扩展数据
• 数据同步：外观数据和任务数据同步到客户端

4.14 Lua错误处理

• 错误捕获：捕获Lua脚本执行错误
• 错误日志：记录详细的错误信息便于调试

4.15 宠物系统

• 宠物数据设置：设置宠物各项属性
• 成长率获取：获取宠物成长率
• 昵称获取：获取宠物昵称
• 昵称设置：设置宠物昵称
• 宠物刷新：刷新宠物对象数据

宠物数据类型：

• 基础属性：力量、灵力、体力、定力、身法
• 资质百分比：各项资质的百分比加成
• 特殊属性：根骨、剩余点数、成长率、外观ID

4.16 系统修复（14项）

序号	修复项	说明
1	转蛋加载优化	删除zhuandan.txt加载，加速服务器启动
2	任务日志优化	移除任务日志记录，减少磁盘IO
3	仓库断线修复	修复野外打开仓库导致断线的问题
4	挂机验证修复	修复挂机验证问题，单纯挂经验不出验证
5	衣服强化修复	修复衣服无法强化的问题
6	Buff上限提升	Buff数量上限提升至60个
7	心跳检测修复	修复角色心跳检测问题
8	场景关闭修复	修复场景关闭问题
9	世界变量扩展	世界变量上限提升至100个
10	非法解散修复	修复队伍非法解散问题
11	非法踢人修复	修复队伍非法踢人问题
12	物品时间修复	修复物品有效时间问题
13	宝石绑定修复	宝石摘除后给绑定宝石
14	聊天GM命令	添加聊天式GM命令支持

---

五、注意事项

1. 数据兼容性：修改数据结构后需同步更新数据库表结构
2. 索引范围：任务数据索引范围为 0-2047，超出范围会导致错误
3. 背包索引：装备相关接口的 BagIndex 范围为 0-118
4. 门派数量：插件支持20个门派，需同步修改客户端配置
5. 强化上限：装备强化上限提升至255级
6. 属性上限：角色属性值上限提升至21亿

---