迷你世界UGC3.0脚本WikiMenuOn this pageSidebar Navigation快速入门欢迎MOD、组件介绍什么是Lua编程组件介绍组件说明组件互相操作组件函数组件属性事件触发器事件管理组件事件管理函数库服务模块世界模块管理接口 World对象模块管理接口 GameObject角色模块管理接口 Actor玩家模块管理接口 Player生物模块管理接口 Monster方块模块管理接口 Block道具模块管理接口 Item背包模块管理接口 Backpack界面模块管理接口 CustomUI图文信息模块管理接口 Graphics区域模块管理接口 Area容器模块管理接口 WorldContainer资源模块管理接口 Mod计时器模块管理接口 Timer状态模块管理接口 Buff消息模块管理接口 Chat普通变量数据管理接口 Data数组变量数据管理接口 Array二维表变量数据管理接口 TableKV表变量数据管理接口 Map全局函数全局函数枚举枚举库脚本常见问题开发者常见问题进阶指南全局函数触发器脚本交互对象介绍KV排行榜介绍二维表介绍道具实例更新日志更新日志道具实例介绍​什么是道具实例​道具实例是存在于格子上的道具数据它是从道具模板创建的。每个道具实例都有自己的属性这些属性可以在游戏中被修改或更新。目前暂时只有模型组件和枪械组件支持道具实例的相关功能。使用创建道具实例的接口来创建道具实例会带有模型组件相关属性使用创建枪械道具实例的接口来创建道具实例会带有模型组件和枪械组件的相关属性。使用道具实例功能可以制作出枪械修改等玩法。创建道具实例​序号 函数名 函数描述1 CreateItemInstInBackpack(...) 在玩家的背包内创建一个道具实例2 CreateGunInBackpack(...) 在玩家的背包内创建一把实例化的枪械3 CreateItemInstInWorld(...) 在位置上创建道具实例的掉落物4 CreateGunInWorld(...) 在位置上创建枪械道具实例的掉落物获取道具实例或ID​序号 函数名 函数描述1 GetDropItemInstanceId(...) 根据掉落物objid获取道具实例id2 GetItemIdByInstanceId(...) 根据道具实例ID获取道具ID3 GetResIdByInstanceId(...) 根据道具实例ID获取预制ID4 GetAllBackPackInstanceIds(...) 获取指定背包中所有道具实例5 GetInstIdByGridIndex(...) 根据背包索引获取道具实例id6 GetGunInstIdInBackpack(...) 获取背包所有实例化的枪械7 GetAllStorageItemInstanceIds(...) 获取储物箱里所有的道具实例只取通过接口创建的道具实例8 GetStorageItemInstanceId(...) 获取储物箱内指定格子的道具实例ID获取和修改道具实例属性​序号 函数名 函数描述1 ModifyGunAttribute(...) 修改枪械道具实例的属性2 GetGunAttribute(...) 获取枪械道具实例的属性3 GetGunPrefabAttribute(...) 获取枪预制的属性4 AddSubModelPart(...) 给道具实例添加一个模型子部件5 DeleteSubModelPart(...) 删除一个道具实例的模型子部件6 ReplaceSubModelPart(...) 修改一个道具实例的模型子部件7 SetStringCustomData(...) 设置道具实例的自定义数据string8 SetBoolCustomData(...) 设置道具实例的自定义数据bool9 SetNumberCustomData(...) 设置道具实例的自定义数据number10 SetObjCustomData(...) 设置道具实例的自定义数据Object11 SetArrayCustomData(...) 设置道具实例的自定义数据Array12 GetStringCustomData(...) 获取道具实例的自定义数据string13 GetBoolCustomData(...) 获取道具实例的自定义数据bool14 GetNumberCustomData(...) 获取道具实例的自定义数据number15 GetObjCustomData(...) 获取道具实例的自定义数据Object16 GetArrayCustomData(...) 获取道具实例的自定义数据Array在界面模型装载器上显示道具实例的模型​SetLoaderModel参数及类型playerid:number玩家IDuiid:string界面IDelementid:string元件IDmodleName:string模型名称返回值及类型ret:bool是否成功该方法的主要作用 设置装载器的模型调用道具实例的模型模型名称填ItemInstance_道具实例id具体使用案例如下local isSuccess CustomUI:SetLoaderModel(Player:GetHostUin(),7482986899365911542-22886,7482986899365911542-22886_5, ItemInstance_15864891562)注意​格子数据同步问题道具实例的数据是存在于背包格子上的修改了格子数据后会按照一定的时间间隔同步。如果修改格子数据后立刻通知客机刷新界面则会出现客机还没收到同步数据就刷新的情况会导致客机显示模型没变化。解决办法是修改格子数据后等待一小会例如0.5秒再通知客机刷新界面。Last updated: 2025/9/16 11:53PagerPrevious page二维表介绍Next page更新日志