Skip to content

Your First Project ja

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 の中央付近に 1 ピクセルを描画します。

プロジェクトを実行

プロジェクトディレクトリ内では次のように実行できます。

bit8 run .

BIT8_CLI がプロジェクトを読み込み、ゲームウィンドウを開きます。

小さな 1 ピクセルが表示されれば成功です。

プロジェクトが動き始めました。👾

ゲームのライフサイクル

基本的な BIT8_CLI プログラムでは、3 つのライフサイクル関数を定義できます。

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 プロジェクトが完成しました。

次のページ:

言語の基礎

その後は以下も参照してください。

1 ピクセルのゲーム開発人生が始まりました。👾

Clone this wiki locally