Skip to content

Your First Project ko

Shiraishi_AKi edited this page Oct 6, 2026 · 1 revision

첫 번째 프로젝트

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

이 가이드에서는 최소 구성의 BIT8_CLI 프로젝트를 만들고 첫 번째 .b8 프로그램을 실행합니다.

시작하기 전에 BIT8_CLI가 설치되어 있는지 확인하세요.

bit8 --version

아직 설치하지 않았다면 설치 페이지를 참고하세요.

프로젝트 만들기

새 디렉터리를 만듭니다.

mkdir my-bit8-game
cd my-bit8-game

다음 파일을 만듭니다.

main.b8

프로젝트 구조는 다음과 같습니다.

my-bit8-game/
└── main.b8

첫 번째 프로그램

main.b8을 열고 다음 코드를 입력합니다.

func init()
end

func update()
end

func draw()
    cls(0)
    pix(32, 32, 7)
end

BIT8_CLI에서는 Lua의 function을 편리하게 작성하기 위한 형태로 func를 사용할 수 있습니다.

이 프로그램은 화면을 지우고 64×64 framebuffer의 중앙 부근에 하나의 픽셀을 그립니다.

프로젝트 실행

프로젝트 디렉터리에서는 다음과 같이 실행할 수 있습니다.

bit8 run .

BIT8_CLI가 프로젝트를 불러오고 게임 창을 엽니다.

작은 픽셀 하나가 보이면 성공입니다.

프로젝트가 살아났습니다. 👾

게임 라이프사이클

기본적인 BIT8_CLI 프로그램에서는 세 가지 라이프사이클 함수를 정의할 수 있습니다.

func init()
end

func update()
end

func draw()
end

init()

게임이 시작될 때 호출됩니다.

게임 상태를 초기화하는 데 사용할 수 있습니다.

update()

고정 시뮬레이션 업데이트에서 호출됩니다.

BIT8_CLI의 시뮬레이션은 30 Hz로 업데이트됩니다.

이동, 입력, 게임 로직, 타이머 및 상태 변경 등에 사용할 수 있습니다.

draw()

현재 게임 상태를 그립니다.

cls()와 pix() 같은 그리기 함수는 일반적으로 여기에서 사용합니다.

이동 추가하기

이제 픽셀을 움직여 봅시다.

main.b8을 다음 코드로 변경합니다.

x = 32
y = 32

func update()
    if btn(LEFT) then
        x = x - 1
    end

    if btn(RIGHT) then
        x = x + 1
    end

    if btn(UP) then
        y = y - 1
    end

    if btn(DOWN) then
        y = y + 1
    end
end

func draw()
    cls(0)
    pix(x, y, 7)
end

다시 실행합니다.

bit8 run .

이제 방향 입력을 사용해 framebuffer 위의 픽셀을 움직일 수 있습니다.

64×64 화면

BIT8_CLI는 고정된

64 × 64

게임 framebuffer를 사용합니다.

실제 창이 더 크게 표시되더라도 게임 좌표는 이 논리 해상도를 사용합니다.

예를 들어:

pix(0, 0, 7)

은 왼쪽 위에 그려집니다.

pix(32, 32, 7)

은 화면 중앙 부근에 그려집니다.

다음 단계

이제 실행 가능한 BIT8_CLI 프로젝트가 완성되었습니다.

다음 페이지:

언어 기초

그다음에는 다음 항목도 살펴보세요.

픽셀 하나의 게임 개발 인생이 시작되었습니다. 👾

Clone this wiki locally