Map 시스템

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

BIT8_CLI는 2D 게임 세계를 만들기 위한 Tile 기반 Map 시스템을 제공합니다.

Map은 등록된 Asset ID를 사용하며 크기를 조정할 수 있습니다. 또한 Node와 Camera를 포함할 수 있습니다.

이 가이드에서는 BIT8_CLI 0.1.0의 Map 시스템을 소개합니다.

1. Map 개요

BIT8_CLI는 고정된 Tile 크기를 사용합니다.

8 × 8 픽셀

기본 Map 크기는 다음과 같습니다.

64 × 64 Tiles

Map의 너비와 높이는 각각 다음 범위로 설정할 수 있습니다.

1 ~ 256 Tiles

Map Cell의 최대 개수는 다음과 같습니다.

65,536 Cells

Map 크기는 게임의 64×64 픽셀 Framebuffer와 독립적입니다.

따라서 화면에 표시되는 영역보다 훨씬 큰 Map을 만들 수 있습니다.

2. Map 파일

BIT8_CLI는 다음 확장자를 사용하여 Map 데이터를 저장합니다.

.b8map

예:

world.b8map

Map 파일에는 Tile 데이터가 포함되며 Node와 Camera를 정의할 수도 있습니다.

프로젝트 구조 예시:

my-bit8-game/
├── main.b8
├── bit8.assets.toml
├── world.b8map
└── assets/
    └── terrain (A).png

이 구조는 설명을 위한 예시입니다.

3. Map 좌표

Map은 Tile 좌표를 사용합니다.

각 Map Cell은 게임 세계에서 8×8 픽셀 영역을 나타냅니다.

예:

Tile (0, 0) → World Pixel (0, 0)

Tile (1, 0) → World Pixel (8, 0)

Tile (2, 0) → World Pixel (16, 0)

Tile (0, 1) → World Pixel (0, 8)

Tile 좌표를 Pixel 좌표로 변환하는 공식은 다음과 같습니다.

pixel_x = tile_x × 8
pixel_y = tile_y × 8

예를 들어 Tile 좌표 (5, 3)은 World Pixel 좌표 (40, 24)에 해당합니다.

4. Map Cell

각 Map Cell은 등록된 Tile을 참조할 수 있습니다.

예:

A1
A2
A3

이 식별자는 다음 파일을 통해 관리되는 등록된 Asset을 참조합니다.

bit8.assets.toml

비어 있는 Map Cell은 다음과 같이 표시합니다.

--

간단한 Map 예시:

A1 A1 A1 A1 A1
A1 -- -- -- A1
A1 -- A2 -- A1
A1 -- -- -- A1
A1 A1 A1 A1 A1

이것은 Map Cell의 개념을 보여 주는 예시이며 완전한 .b8map 파일 형식은 아닙니다.

5. Map 그리기

현재 Map을 그리려면 map()을 사용합니다.

func draw()
    cls(0)
    map()
end

이 코드는 Framebuffer를 지우고 Map을 그립니다.

표시되는 영역은 Framebuffer와 현재 활성화된 Camera에 따라 달라집니다.

정확한 매개변수 사양은 해당 BIT8_CLI 릴리스의 소스 코드를 참고하세요.

6. Map Cell 읽기

BIT8_CLI는 다음 API를 제공합니다.

mget(...)

이 API는 Runtime Map에서 Tile 값을 읽습니다.

Map 작업은 Pixel 좌표가 아닌 Tile 좌표를 사용합니다.

7. Map Cell 수정

BIT8_CLI는 다음 API를 제공합니다.

mset(...)

이 API는 Runtime Map의 Tile 값을 수정합니다.

Runtime에서 수정한 Map 데이터는 실행 중인 게임 상태에 영향을 줍니다.

이는 Editor에서 원본 .b8map 파일에 변경 사항을 저장하는 작업과 다릅니다.

8. Map Workspace

BIT8_CLI의 VS Code Extension에는 Map Workspace가 통합되어 있습니다.

Map Workspace는 Map 데이터를 시각적으로 편집할 수 있는 도구를 제공합니다.

주요 기능:

• Map Canvas
• Tile 선택
• Tile 그리기
• Map Cell 확인
• Zoom 조절
• Node 선택 및 편집
• Camera 시각화
• Property 확인

Map Workspace는 Runtime과 동일한 기반 프로젝트 데이터를 사용합니다.

Editor 인터페이스 자체가 Map 동작의 최종 기준은 아닙니다.

9. Map 내부의 Node

Map에는 Node를 포함할 수 있습니다.

Node는 다음 정보를 정의할 수 있습니다.

• 안정적인 Node ID
• 이름
• 위치
• 활성화 상태
• Script 참조
• 선택적 Sprite 참조
• 선택적 Collider

Node는 게임 세계 구조의 일부입니다.

Node Script는 Runtime 실행 중 동작을 제어할 수 있습니다.

예:

func update()
    self.x = self.x + 1
end

자세한 내용은 Nodes 페이지를 참고하세요.

10. Map 내부의 Camera

Map에는 Camera Node를 포함할 수 있습니다.

Camera는 게임 세계에서 화면에 표시할 영역을 결정합니다.

BIT8_CLI는 64×64 픽셀 Viewport를 사용합니다.

Camera 좌표는 Viewport의 중심을 나타냅니다.

World 좌표를 사용하는 렌더링 작업은 활성화된 Camera를 기준으로 변환됩니다.

반면 다음과 같은 Screen 좌표 기반 작업은:

cls(0)
pix(32, 32, 7)

계속 Screen 좌표를 사용합니다.

자세한 내용은 Camera 페이지를 참고하세요.

11. Solid Tile 및 Collision

등록된 Tile은 Solid로 설정할 수 있습니다.

예:

solid = [6]

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

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

Node는 다음 메서드를 사용할 수 있습니다.

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

자세한 내용은 Collision 페이지를 참고하세요.

12. Map 크기와 성능

지원되는 최대 Map 크기:

256 × 256 Tiles

최대 Cell 수:

65,536 Cells

Map 전체가 64×64 픽셀 Framebuffer 안에 들어갈 필요는 없습니다.

현재 Viewport에는 게임 세계의 일부만 표시됩니다.

큰 Map을 설계할 때는 렌더링 성능과 게임플레이 요구 사항도 고려해야 합니다.

13. 현재 제한 사항

BIT8_CLI 0.1.0은 Tile 기반 Map 시스템을 제공합니다.

다음 기능은 확립된 0.1.0 Map 시스템에 포함되지 않습니다.

• 여러 개의 독립적인 Map Layer
• 대형 배경 이미지를 World Object로 직접 배치하는 기능
• 완전한 Physics Engine

이러한 기능은 향후 버전에서 검토될 수 있습니다.

다음 단계

다음 페이지:

Nodes

관련 문서:

• Asset 및 Tilesheet
• Collision
• Camera
• Map Workspace
• Runtime API

Map은 세계를 정의하고, Node는 그 세계에 동작을 부여합니다.