主题
Tool
工具单位,代表玩家可装备、使用和丢弃的物品。它提供激活与停用方法,并通过事件通知装备、卸下、激活和停用等状态变化。
概览
工具单位,代表玩家可装备、使用和丢弃的物品。它提供激活与停用方法,并通过事件通知装备、卸下、激活和停用等状态变化。
继承自
BackpackItem;可通过World:CreateUnit("Tool", ...)创建;返回单个单位
函数
Activate
签名:Activate()
激活工具,使其进入可用状态。
创建工具并触发激活语义
lua
-- @runtime server
local World = game:GetService("World")
local tool = World:CreateUnit("Tool", { Name = "MyTool", Enabled = true })
tool:Activate()
print("工具已激活:", tool.Name)Deactivate
签名:Deactivate()
停用工具,使其进入不可用状态。
停用已创建的工具
lua
-- @runtime server
local World = game:GetService("World")
local tool = World:CreateUnit("Tool", { Name = "MyTool", Enabled = true })
tool:Activate()
tool:Deactivate()
print("工具已停用:", tool.Name)属性
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
RequiresHandle | Bool | true | 控制工具是否需要 Handle 部件才能装备。 |
CanBeDropped | Bool | true | 控制工具是否可以被丢弃。 |
Enabled | Bool | true | 控制工具是否可用。 |
ToolTip | String | "" | 设置工具的提示文本。 |
事件
Equipped
签名:Equipped()
工具装备时触发
Unequipped
签名:Unequipped()
工具卸下时触发
Activated
签名:Activated()
工具激活时触发
Deactivated
签名:Deactivated()
工具停用时触发
