Collision ko

Collision 시스템

English | 繁體中文 | 日本語 | 한국어

BIT8_CLI는 Tile 기반 2D 게임을 위한 경량 Collision 시스템을 제공합니다.

BIT8_CLI 0.1.0에서 Node는 Solid Tile과 지원되는 Collider 데이터를 사용하여 장애물을 감지하고 Collision을 고려한 이동을 수행할 수 있습니다.

이 시스템은 완전한 물리 시뮬레이션보다 단순하고 예측 가능한 이동 처리에 중점을 둡니다.

1. Collision 개요

Collision 시스템은 주로 세 가지 요소로 구성됩니다.

• Solid Tile: 이동을 차단하는 Map Tile
• Node Collider: Node에 연결할 수 있는 선택적 Collision Geometry
• Movement API: 이동을 확인하고 실행하는 메서드

주요 Node 메서드:

self:collide(dx, dy)
self:move(dx, dy)

이 메서드를 사용하면 Node Script에서 Collision World와 상호작용할 수 있습니다.

2. Solid Tile

Tile은 Asset Registry를 통해 Solid로 설정할 수 있습니다.

Asset Registry는 다음 파일에 저장됩니다.

bit8.assets.toml

예:

solid = [6]

이 설정은 해당 Tilesheet의 여섯 번째 Tile을 Solid로 지정합니다.

이 코드는 설정의 일부이며 완전한 Registry 파일은 아닙니다.

Solid Tile은 Collision 판정에서 전체 8×8 픽셀 영역을 차지합니다.

3. Tile 좌표와 Collision

BIT8_CLI는 8×8 픽셀 Tile을 사용합니다.

예:

Tile (0, 0) → Pixels (0–7, 0–7)
Tile (1, 0) → Pixels (8–15, 0–7)
Tile (0, 1) → Pixels (0–7, 8–15)

Solid Tile은 해당 영역을 통과하는 이동을 차단합니다.

Node는 World Pixel 좌표를 사용하므로 Tile Grid보다 세밀하게 이동할 수 있습니다.

4. Node Collider

Node에는 선택적으로 Collider 정보를 설정할 수 있습니다.

Collider는 Node와 연결된 Collision Geometry를 정의합니다.

Runtime은 지원되는 Collision Geometry를 사용하여 이동을 판정할 수 있습니다.

Collider 설정은 Node의 Map 데이터와 함께 저장됩니다.

지원되는 Collider 속성과 파일 형식의 정확한 내용은 0.1.0 구현을 참고하세요.

5. Collision 확인

이동 시 Collision 발생 여부를 확인하려면 다음 메서드를 사용합니다.

self:collide(dx, dy)

예:

func update()
    if self:collide(1, 0) then
        -- 오른쪽 이동이 차단되었습니다.
    end
end

매개변수는 확인하려는 이동량을 나타냅니다.

이 메서드는 Collision만 확인하며 Node의 위치를 변경하지 않습니다.

6. Collision을 고려한 이동

Collision을 고려하여 Node를 이동하려면 다음 메서드를 사용합니다.

self:move(dx, dy)

예:

func update()
    self:move(1, 0)
end

이 코드는 Node를 오른쪽으로 1픽셀 이동하려고 시도합니다.

Collision으로 이동이 차단되면 실제 이동 거리가 요청한 거리보다 작을 수 있습니다.

7. 이동 처리 순서

BIT8_CLI 0.1.0은 1픽셀 단위로 Collision을 판정합니다.

이동 처리 순서는 다음과 같습니다.

1. X축
2. Y축

예:

self:move(3, 2)

Runtime은 수평 이동을 먼저 시도하고, 이후 수직 이동을 처리합니다.

각 축의 이동은 픽셀 단위로 판정됩니다.

이 방식은 경량 Tile 기반 이동 처리에 적합합니다.

8. Collision Query와 Movement

두 메서드는 서로 다른 역할을 합니다.

메서드	용도	위치 변경
self:collide(dx, dy)	이동 시 Collision 확인	변경하지 않음
self:move(dx, dy)	Collision을 고려한 이동 시도	이동할 수 있으면 변경

단순한 이동에는 self:move()만으로 충분할 수 있습니다.

장애물을 확인한 후 게임 동작을 결정해야 한다면 self:collide()를 사용합니다.

9. 플레이어 이동 예제

다음 예제는 방향 입력 상수를 사용합니다.

func update()
    if btn(LEFT) then
        self:move(-1, 0)
    end

    if btn(RIGHT) then
        self:move(1, 0)
    end

    if btn(UP) then
        self:move(0, -1)
    end

    if btn(DOWN) then
        self:move(0, 1)
    end
end

이 코드는 기본적인 4방향 Collision 대응 이동을 구현합니다.

이 예제는 Script가 적절한 Collision 설정을 가진 Node에 연결되어 있다고 가정합니다.

10. 좌표 직접 변경

Node는 좌표를 직접 변경할 수도 있습니다.

self.x = self.x + 1

하지만 좌표를 직접 변경하는 것과 다음 메서드는 다릅니다.

self:move(1, 0)

장애물이 Node 이동에 영향을 주어야 한다면 Collision을 고려한 이동을 사용하세요.

의도적으로 Node의 위치를 변경해야 한다면 좌표를 직접 설정할 수 있습니다.

11. Collision과 Map

Collision 데이터는 Map과 밀접하게 연결되어 있습니다.

Map은 Tile 데이터를 저장하고, Asset Registry는 등록된 Tile 중 어떤 Tile이 Solid인지 정의합니다.

Node는 Collision Query와 이동 처리 중 이러한 정보를 사용합니다.

자세한 내용은 Maps 및 Assets and Tilesheets 페이지를 참고하세요.

12. 현재 제한 사항

BIT8_CLI 0.1.0은 경량 Collision 시스템을 제공합니다.

완전한 Physics Engine은 아닙니다.

현재 Collision 모델에는 다음 기능이 포함되지 않습니다.

• 완전한 Rigid Body Dynamics
• 물리 엔진을 통한 자동 중력 시뮬레이션
• 현실적인 힘과 운동량 계산
• 범용 물리 프레임워크 수준의 고급 Collision Shape

개발자는 Node Script를 사용하여 게임에 필요한 이동 동작을 구현할 수 있습니다.

다음 단계

다음 페이지:

Camera

관련 문서:

• Nodes
• Maps
• Assets and Tilesheets
• Runtime API

Collision은 Node가 이동할 수 있는 영역을 결정합니다.