BackpackItem

概览

字段	值
Kind	Unit · 单位 Unit
Realm	common

继承关系

• Unit（4 属性 / 25 函数 / 6 事件）
  • [BackpackItem]（1 属性）
    • Tool（4 属性 / 2 函数 / 4 事件）

继承成员

1 个来源 / 4 属性 / 25 函数 / 6 事件

• 来自 Unit（4 属性 / 25 函数 / 6 事件）
  • 属性：AssetId、Name、Desc、Parent
  • 函数：ClearAllChildren、GetChildren、GetDescendants、IsAncestorOf、IsDescendantOf、FindFirstAncestor、FindFirstAncestorWhichIsA、FindFirstAncestorOfClass、FindFirstChild、FindFirstChildWhichIsA、FindFirstChildOfClass、HasChildren、GetChildCount、GetChildAtIndex、SetAttribute、GetAttribute、GetAllProps、Clone、IsA、Destroy、GetPropertyChangedSignal、GetAttributeChangedSignal、FindFromPath、GetFullPath、GetDebugId
  • 事件：ChildAdded、ChildRemoved、DescendantAdded、DescendantRemoving、AncestryChanged、Destroying

BackpackItem 是可放入背包的物品基类，提供 Icon 等背包展示所需的基础属性。Tool 等具体物品类型继承自它。

适用场景

当需要定义背包系统中的基础物品数据，或验证 BackpackItem/Tool 继承链时，可创建 BackpackItem 并设置名称与图标。

使用要点

在服务端通过 World:CreateUnit("BackpackItem", config) 创建实例，Icon 使用有效图片资源 URI。具体交互、拾取和使用逻辑通常由 Tool 或业务脚本补充。

注意事项

BackpackItem 只是背包数据/图标基类，不自带场景实物、拾取交互、背包 UI 或官方预设资源。需要可视化和可使用行为时，应由 Tool 子类及业务模型、UI、事件共同实现。

代码示例

创建 BackpackItem 并设置图标

-- @runtime server
local World = game:GetService('World')

local item = World:CreateUnit('BackpackItem', {
    Name = 'TestItem',
    Icon = 'official://image/14896',
})
print('物品名称与图标:', item.Name, item.Icon)

属性 (1)

Name	类型	默认值	说明
Icon	String	official://image/14896	背包物品的图标资源标识，用于在 UI 中显示对应的图标。

关联类型

• Unit