函数与事件：制作会响应玩家触碰的互动方块

Learning route

先准备，再动手；看到结果后，记得保存。

每完成一小步，就测试一次。先说出你预计会看到什么，再用 Play 和 Output 检查，不用急着一次写完所有代码。

Function & event

函数定义动作；事件在需要时调用动作。

函数是有名称的动作盒子。定义函数时说明它叫什么、接收什么数据、内部做什么；调用函数时才会运行。只有定义 local function sayHello(...) 和 end 不会产生输出，sayHello("Alex") 才是调用。

事件是游戏中发生的通知。Touched 发生时，会把另一个发生接触的 BasePart 作为 otherPart 参数传入。我们不需要每一帧反复检查，而是先把函数连接给事件。

local touchPad = script.Parent

local function onPartTouched(otherPart)
    print("Touched by:", otherPart:GetFullName())
end

touchPad.Touched:Connect(onPartTouched)

• 事件连接写 onPartTouched，不要写 onPartTouched()。
• 带括号会立即调用函数；Connect 需要的是函数本身。
• 触碰由物理运动产生，CanTouch 必须允许触碰事件。

TouchPad setup

把 Script 放在 TouchPad 内，让 script.Parent 指向正确对象。

在 Workspace 插入 Part，用 Scale 制作为约 12×1×12 studs 的扁平方块。把 Anchored、CanCollide、CanTouch 都设为 true，命名为 TouchPad，并放在 SpawnLocation 前方的安全位置。

点击 TouchPad 的加号创建普通 Script，命名 TouchHandler。因为脚本是 TouchPad 的子对象，所以 script.Parent 就是要控制的方块，不必另外按名称寻找。

local touchPad = script.Parent
print(touchPad.Name)

• 选择 Script，不要选择 LocalScript。
• Play 后 Output 应显示 TouchPad。
• 如果 Output 显示 ServerScriptService，说明脚本放错位置。
• 测试期间不要直接改写脚本，先 Stop 再修改。

Player filter

Touched 会响应所有接触；Humanoid 才能确认是玩家角色。

角色并不是一个单独的 Part。脚、腿、躯干和配件都可能触碰 TouchPad，所以一次走上方块可能出现多条消息。普通方块滚过来也会触发事件。我们需要从 otherPart.Parent 查找 Humanoid，只让真正的玩家角色产生反馈。

找不到 Humanoid 时会得到 nil，它在条件中视为 false。使用提前 return 能让后续有效逻辑更清楚。

local function onPartTouched(otherPart)
    local humanoid = otherPart.Parent:FindFirstChildOfClass("Humanoid")
    if not humanoid then
        return
    end

    print("Confirmed player character")
end

• 单个 = 是赋值；两个 == 才是比较。
• if humanoid 直接检查对象是否存在，不需要写 humanoid == true。
• 第一个 end 结束 if，第二个 end 结束 function。

Feedback & debounce

变色给玩家反馈；busy 让一次连续接触只算一次。

颜色反馈是最直观也最安全的结果。把 READY_COLOR 与 ACTIVE_COLOR 放在脚本顶部，之后修改主题时不必在函数中寻找多个颜色数字。运行中的颜色变化只属于 Playtest 副本，Stop 后会恢复。

多个身体部件会在很短时间内连续触发 Touched。busy 为 true 时立刻 return；确认玩家后再设为 true、变色、等待、恢复颜色，最后把 busy 设回 false。这个防重复触发思路叫 debounce。

local touchPad = script.Parent
local READY_COLOR = Color3.fromRGB(46, 116, 181)
local ACTIVE_COLOR = Color3.fromRGB(242, 184, 75)
local busy = false

local function onPartTouched(otherPart)
    if busy then return end

    local humanoid = otherPart.Parent:FindFirstChildOfClass("Humanoid")
    if not humanoid then return end

    busy = true
    touchPad.Color = ACTIVE_COLOR
    print(otherPart.Parent.Name, "activated TouchPad")
    task.wait(1.5)
    touchPad.Color = READY_COLOR
    busy = false
end

touchPad.Touched:Connect(onPartTouched)

• 先检查 busy，再检查 Humanoid，然后才改变颜色。
• task.wait(1.5) 期间的新触碰仍会调用函数，但会被 busy 挡住。
• 不要写没有 task.wait() 的无限 while true do 循环。

Exit questions

先自己回答，再展开看看。