Lua弹射地垫：踩上去弹飞到空中

【语法算法】

单行代码拆解：弹射初速=-420——弹射的全部动力就这一行的负初速。负号朝上、四百二十是弹射的初速大小——踩上地垫的那一拍，角色领到一笔向上的初速，之后重力接管，抛物线自然回落。这篇把弹射地垫整套写法拆开：配置表、地垫放置、弹射触发、重力回落、定时器、调试按钮，一段一段照抄能跑。

一、效果演示：踩上去弹飞到空中

演示场一段平地。点「放置」：一块绿色的弹射垫落在地上。点「踩上去」：角色被弹飞到空中——高度一路涨、速度一路减，到顶后掉头下落，落回地面稳稳站住。演示里试两笔账：弹射的到达高度和自由落体的落地速度——弹得多高落得就多重，能量守恒在这套机制里写得明明白白。弹射地垫教的是弹射：不是传送，是用初速和重力算出来的抛物线。

flowchart TD
A[踩上地垫] --> B[领取向上初速]
B --> C[高度加速度推进]
C --> D[重力减速度]
D --> E{回到地面了吗}
E -- 否 --> C
E -- 是 --> F[落地 站定]

 fx-bouncepad

二、底层原理：一笔初速注入加一阶重力回落

模块的机关是一对搭档。初速注入：踩垫的那一拍领到一笔向上的初速——负四百二十是朝上的方向加四百二十的大小，这一笔是弹射的全部动力。重力回落：每一拍高度加速度推进、速度加重力衰减——速度从负四百二十渐渐变正，高度从最高点渐渐回落，落回地面算弹射结束。和传送类机制的分野在"弹射有完整的抛物线"：传送是从 A 到 B 没有中间态，弹射是先升后降的完整弧线——弧线的顶点就是弹射的高度峰值。

三、核心代码：完整模块（上·骨架）

-- @file BouncePad.lua
-- 弹射地垫 —— 踩上去弹飞到空中

local BouncePad = {}

local 参数配置 = {
    PAD_X         = 330,
    JUMP_SPEED    = -420,
    GRAVITY       = 15,
    GROUND_Y      = 0,

    AUTOINC_BASE  = 1171000,
}

local _padOn     = false
local _弹射初速     = 0
local _jumpY     = 0
local _scheduler = nil
local _autoInc   = 0

local function ShowTip(msg)
    if msg and msg ~= "" then SL:ShowSystemTips(msg) end
end

function BouncePad.InAir()
    return _jumpY < 0 or _弹射初速 < 0
end

function BouncePad.Height()
    return -_jumpY
end

四、核心代码：完整模块（下·弹射触发与重力回落）

-- 放置地垫
function BouncePad.Place()
    _padOn = true
    ShowTip("地垫放好了——踩上去弹到空中")
end

-- 弹射触发：踩上地垫领初速
function BouncePad.Bounce()
    if not _padOn then
        ShowTip("先放地垫")
        return
    end
    _弹射初速 = 参数配置.JUMP_SPEED
    ShowTip("弹起来了!")
end

-- 重力回落：速度加重力、高度加速度
if not _scheduler then
    _scheduler = SL:Schedule(function(dt)
        if not BouncePad.InAir() then return end
        _jumpY = _jumpY + _弹射初速 * dt * 60
        _弹射初速 = _弹射初速 + 参数配置.GRAVITY * dt * 60
        if _jumpY >= 0 then
            _jumpY = 0
            _弹射初速 = 0
            ShowTip("落地了")
        end
    end, 0.02)
end

SL:ScheduleOnce(function()
    SL:BindDebugButton("放置", function()
        BouncePad.Place()
    end)
    SL:BindDebugButton("踩上去", function()
        BouncePad.Bounce()
    end)
    ShowTip("技能已加载: 弹射地垫 (调试按钮触发)")
end, 1.0)

function BouncePad.卸载()
    if _scheduler then SL:Unschedule(_scheduler) end
    _padOn = false
    _弹射初速 = 0
    _jumpY = 0
end

return BouncePad

五、机制问答

问：弹射的高度和初速是什么关系？
答：平方关系——初速翻倍高度翻四倍，这就是为什么初速四百二只弹一百多步而初速八百能弹四百多步。

问：空中还能操控方向吗？
答：看设计——默认不能，弹射的弧线是纯物理的；要加空中操控就给横方向另加速度分量。

问：连踩两次地垫会弹更高吗？
答：会——第二踩的初速叠在残余速度上，如果落地和踩垫同帧就叠加，错开就各自独立。

问：弹射和跳跃的区别是什么？
答：来源不同——跳跃是角色自己的力，弹射是外部的力，弹射的初速通常比跳跃大很多。

问：落到地垫上会再弹吗？
答：看设计——默认落到地面不走地垫逻辑，要连续弹就在落地判定里加地垫碰撞检测。

六、调参与实战怎么用

弹射的初速负四百二十是"弹到可视区上方但不飞出屏"的高度——初速太大飞出屏外看不到落点，太小没有弹的感觉。重力十五是下落的速度——重力太大下落太突然像被吸回来，太小小像在月球。地垫的宽度七十步是"跑过去就能踩到"的宽度——太窄要精确走位，太宽变成区域触发。常见坑：初速和重力的单位不统一导致高度异常；落地判定用了高度大于零而不是大于等于零；弹射途中没有禁用跳跃键导致空中二段跳。

实战里弹射地垫是平台跳跃类玩法的通用件：弹射垫、弹簧床、风力上升区，全是"初速加重力"的同一副骨架。这篇的模块照抄能跑，改的就是参数表。弹射地垫的实战价值在位移——不是攻击位移，是地形位移。有些平台跳不上去，有些沟跨不过去，一个弹射垫解决所有问题。放一个垫子在悬崖边，踩上去飞过去；放一个垫子在墙根下，弹起来翻上去。弹射垫的便宜在于可重复使用——不像一次性技能，垫子放了就一直在，队友也能用。这也是为什么团队副本里总是有人带弹射垫——一个人的道具全队受益，这买卖怎么算都值。

写完留一句给做位移系的同学：弹射地垫卖的是"抛物线的弧度就是爽感"——那根先冲天后落地的抛物线和落地时的一声闷响，是把跳跃从平地升级到空中的第一根弹簧。

补充说明：这套写法在热重载环境里有一个额外的优势——模块的 参数表可以在运行时动态修改，修改后的参数立即生效，不需要重启游戏。这意味着调试的过程变成了实时的：改一个数值，立刻看到效果，不满意再改回来。这种即时反馈的调试方式比传统的"改代码→重启→测试→再改"快了不止一个量级，也是热重载环境给机制调试带来的最大红利。写机制的时候养成"参数全放 参数表"的习惯，热重载的便利就自动到位了。

另一个容易忽略的细节是清理的时机。卸载 是模块卸载时被调用的清理口——所有的定时器、事件监听、节点引用都要在这里一揽子清干净。漏了定时器的版本模块卸载后还在跑，漏了事件监听的版本重复挂载时重复触发，漏了节点引用的版本怪死后引用悬空。这三个坑每一个都出过事故，卸载 写全了才能说这个模块是安全的。