플랫포머

local proj = vmath.dot(self.correction, normal) -- <1>
local comp = (distance - proj) * normal -- <2>
self.correction = self.correction + comp -- <3>
go.set_position(go.get_position() + comp) -- <4>

proj = vmath.dot(self.velocity, message.normal) -- <1>
if proj < 0 then
    self.velocity = self.velocity - proj * message.normal -- <2>
end

-- player.script

-- 메커니즘을 조정하는 값입니다. 다른 느낌을 원한다면 자유롭게 변경하세요.
-- 오른쪽/왼쪽으로 이동하는 가속도
local move_acceleration = 3500
-- 공중에 있을 때 사용할 가속도 계수
local air_acceleration_factor = 0.8
-- 오른쪽/왼쪽 최대 속도
local max_speed = 450
-- 픽셀 단위로 플레이어를 아래로 끌어당기는 중력
local gravity = -1000
-- 점프할 때 픽셀 단위의 이륙 속도
local jump_takeoff_speed = 550
-- 더블 탭이 점프로 간주되기 위해 발생해야 하는 시간(마우스/터치 컨트롤에서만 사용)
local touch_jump_timeout = 0.2

-- id를 미리 해쉬하면 성능이 향상됩니다.
local msg_contact_point_response = hash("contact_point_response")
local msg_animation_done = hash("animation_done")
local group_obstacle = hash("obstacle")
local input_left = hash("left")
local input_right = hash("right")
local input_jump = hash("jump")
local input_touch = hash("touch")
local anim_run = hash("run")
local anim_idle = hash("idle")
local anim_jump = hash("jump")
local anim_fall = hash("fall")

function init(self)
    -- 이 스크립트에서 입력을 처리할 수 있게 합니다.
    msg.post(".", "acquire_input_focus")

    -- 플레이어의 초기 속도
    self.velocity = vmath.vector3(0, 0, 0)
    -- 충돌과 분리를 추적하기 위한 보조 변수
    self.correction = vmath.vector3()
    -- 플레이어가 지면 위에 서 있는지 여부
    self.ground_contact = false
    -- [-1,1] 범위의 이동 입력
    self.move_input = 0
    -- 현재 재생 중인 애니메이션
    self.anim = nil
    -- 마우스/터치를 사용할 때 점프 가능 시간을 제어하는 타이머
    self.touch_jump_timer = 0
end

local function play_animation(self, anim)
    -- 이미 재생 중이지 않은 애니메이션만 재생합니다.
    if self.anim ~= anim then
        -- 스프라이트에 애니메이션을 재생하라고 알립니다.
        sprite.play_flipbook("#sprite", anim)
        -- 어떤 애니메이션이 재생 중인지 기억합니다.
        self.anim = anim
    end
end

local function update_animations(self)
    -- 플레이어 캐릭터가 올바른 방향을 바라보게 합니다.
    sprite.set_hflip("#sprite", self.move_input < 0)
    -- 올바른 애니메이션이 재생되도록 합니다.
    if self.ground_contact then
        if self.velocity.x == 0 then
            play_animation(self, anim_idle)
        else
            play_animation(self, anim_run)
        end
    else
        if self.velocity.y > 0 then
            play_animation(self, anim_jump)
        else
            play_animation(self, anim_fall)
        end
    end
end

function update(self, dt)
    -- 입력에 따라 목표 속도를 결정합니다.
    local target_speed = self.move_input * max_speed
    -- 현재 속도와 목표 속도의 차이를 계산합니다.
    local speed_diff = target_speed - self.velocity.x
    -- 이 프레임에 걸쳐 적분할 전체 가속도
    local acceleration = vmath.vector3(0, gravity, 0)
    if speed_diff ~= 0 then
        -- 차이의 방향으로 작용하도록 가속도를 설정합니다.
        if speed_diff < 0 then
            acceleration.x = -move_acceleration
        else
            acceleration.x = move_acceleration
        end
        -- 공중에 있을 때는 더 느린 느낌을 주기 위해 가속도를 줄입니다.
        if not self.ground_contact then
            acceleration.x = air_acceleration_factor * acceleration.x
        end
    end
    -- 이 프레임의 속도 변화량을 계산합니다(dv는 delta-velocity의 약자입니다).
    local dv = acceleration * dt
    -- dv가 의도한 속도 차이를 초과하는지 확인하고, 그렇다면 clamp합니다.
    if math.abs(dv.x) > math.abs(speed_diff) then
        dv.x = speed_diff
    end
    -- 나중에 사용하기 위해 현재 속도를 저장합니다.
    -- (self.velocity는 현재 시점에서 이전 프레임에 사용된 속도입니다.)
    local v0 = self.velocity
    -- 속도 변화량을 더해 새 속도를 계산합니다.
    self.velocity = self.velocity + dv
    -- 속도를 적분해서 이 프레임의 이동량을 계산합니다.
    local dp = (v0 + self.velocity) * dt * 0.5
    -- 이를 플레이어 캐릭터에 적용합니다.
    go.set_position(go.get_position() + dp)

    -- 점프 타이머를 업데이트합니다.
    if self.touch_jump_timer > 0 then
        self.touch_jump_timer = self.touch_jump_timer - dt
    end

    update_animations(self)

    -- 휘발성 상태를 리셋합니다.
    self.correction = vmath.vector3()
    self.move_input = 0
    self.ground_contact = false

end

local function handle_obstacle_contact(self, normal, distance)
    -- 보정 벡터를 접촉 normal에 투영합니다.
    -- (첫 번째 접촉점에서는 보정 벡터가 0-vector입니다.)
    local proj = vmath.dot(self.correction, normal)
    -- 이 접촉점에 필요한 보정량을 계산합니다.
    local comp = (distance - proj) * normal
    -- 이를 보정 벡터에 더합니다.
    self.correction = self.correction + comp
    -- 보정량을 플레이어 캐릭터에 적용합니다.
    go.set_position(go.get_position() + comp)
    -- 플레이어가 지면 위에 서 있다고 간주할 만큼 normal이 충분히 위를 향하는지 확인합니다.
    -- (0.7은 순수한 수직 방향에서 약 45도 벗어난 것과 거의 같습니다.)
    if normal.y > 0.7 then
        self.ground_contact = true
    end
    -- 속도를 normal에 투영합니다.
    proj = vmath.dot(self.velocity, normal)
    -- 투영값이 음수라면 속도의 일부가 접촉점을 향하고 있다는 뜻입니다.
    if proj < 0 then
        -- 이 경우 해당 컴포넌트를 제거합니다.
        self.velocity = self.velocity - proj * normal
    end
end

function on_message(self, message_id, message, sender)
    -- 접촉점 메세지를 받았는지 확인합니다.
    if message_id == msg_contact_point_response then
        -- 오브젝트가 장애물로 간주하는 대상인지 확인합니다.
        if message.group == group_obstacle then
            handle_obstacle_contact(self, message.normal, message.distance)
        end
    end
end

local function jump(self)
    -- 지면에서만 점프를 허용합니다.
    -- (더블 점프 같은 동작을 만들려면 카운터를 추가해 확장하세요.)
    if self.ground_contact then
        -- 이륙 속도를 설정합니다.
        self.velocity.y = jump_takeoff_speed
        -- 애니메이션을 재생합니다.
        play_animation(self, anim_jump)
    end
end

local function abort_jump(self)
    -- 아직 올라가는 중이라면 점프를 일찍 끊습니다.
    if self.velocity.y > 0 then
        -- 위쪽 속도를 줄입니다.
        self.velocity.y = self.velocity.y * 0.5
    end
end

function on_input(self, action_id, action)
    if action_id == input_left then
        self.move_input = -action.value
    elseif action_id == input_right then
        self.move_input = action.value
    elseif action_id == input_jump then
        if action.pressed then
            jump(self)
        elseif action.released then
            abort_jump(self)
        end
    elseif action_id == input_touch then
        -- 터치 지점을 향해 이동합니다.
        local diff = action.x - go.get_position().x
        -- 멀리 떨어져 있을 때만 입력을 줍니다(10픽셀 초과).
        if math.abs(diff) > 10 then
            -- 100픽셀보다 가까워지면 감속합니다.
            self.move_input = diff / 100
            -- 입력을 [-1,1]로 clamp합니다.
            self.move_input = math.min(1, math.max(-1, self.move_input))
        end
        if action.released then
            -- 점프하려는지 확인하기 위해 마지막 release의 시간을 재기 시작합니다.
            self.touch_jump_timer = touch_jump_timeout
        elseif action.pressed then
            -- 더블 탭하면 점프합니다.
            if self.touch_jump_timer > 0 then
                jump(self)
            end
        end
    end
end