Skip to content

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)

属性 ​

名称类型默认值说明
RequiresHandleBooltrue控制工具是否需要 Handle 部件才能装备。
CanBeDroppedBooltrue控制工具是否可以被丢弃。
EnabledBooltrue控制工具是否可用。
ToolTipString""设置工具的提示文本。

事件 ​

Equipped ​

签名:Equipped()

工具装备时触发

Unequipped ​

签名:Unequipped()

工具卸下时触发

Activated ​

签名:Activated()

工具激活时触发

Deactivated ​

签名:Deactivated()

工具停用时触发