Your First Project zh TW

建立第一個專案

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 支援使用 func 作為 Lua function 的便利寫法。

這個程式會清除畫面，然後在 64×64 framebuffer 接近中央的位置畫出一個像素。

執行專案

指定專案路徑執行 BIT8_CLI。

如果 Terminal 已經位於專案目錄：

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 專案。

下一頁：

語言基礎

之後還可以繼續探索：

• Asset 與 Tilesheet
• Map
• Node
• Sprite 與 Animation

一顆像素的遊戲開發生涯正式開始 👾