おんがえしの blog

作ったプログラムと調べた技術情報

うさかめゲームエンジンを作っている

エージェントと一緒にソフトウェア開発をいくつかしてきたことによる重要な発見に、「自分が本当に必要としていたり、強いモチベーションやバックグラウンドの知識があるもの」でないと開発が続かない、というのがある(適当にプロンプトを打って適当なアプリケーションができあがり、虚無になることが何度かあった)。

Previous RiverやObsidian Daily Appenderは自分が必要としているもので今も使えている。では、強いモチベーションがあるものはなんだろう? ということで、何度もチャレンジして途中でやめてしまっていた「Rubyで書けるゲームエンジン」に再度チャレンジすることにした。失敗例も持っているし、類似ツールもたくさん触っているので、アイデアや良し悪しの判定は出せるはずだ。

まずは Web の Gemini で壁打ち。

シングルスクリプトゲームエンジンというのを作りたいと考えています。

仕様は以下のようなものです。

1. プログラム、グラフィックス、サウンド全てのリソースを1つのスクリプトだけで記述可能。
2. グラフィックやサウンドのデータはソースコードの1番下にデータ配列として配置する。
3. 自力でグラフィックやサウンドを作らなくてもゲームが作れるように標準で用意された組み込みリソースを使うこともできる。
4. 絵文字をドット絵のように表示することも可能。ゲームプログラムに集中できるように。
5. PICO-8 のような解像度などに制限のある環境を想定。
6. 作成したゲームはスクリプトで配布、ブラウザゲームとしてデプロイ、1バイナリ(リソースファイル不要!)で配布することができる。

このような環境を構築するのに最適な開発言語、採用するスクリプト言語、また類似のものがすでにあるかも含め案を練ってください。

Rust + Macroquad、 Go + Ebitengine、C + Raylib、などが候補に挙がる、Raylibは過去にやったことがあるので今回は使わないことにする。WASM出力時のファイルサイズが小さくなりやすいという情報を元に Rust を選択。

スクリプトは JavaScript/TypeScript や Lua を勧められるので追記。

スクリプトエンジンとしてruby やmrubyを使うことはできますか?

とてもいいんじゃないかと言われる。シングルスクリプトでゲームを作るときに__END__の仕様があるのがよさそうという指摘。なるほど。

次は Ruby のどの処理系を使うか。CRuby, mruby のどちらにするか聞かれる。

mrubyが良さそうに思いました。シングルバイナリ化とブラウザ実行のためのWASM化を考えるとrust+macroquad+mrubyの構成が優位に感じましたがどう思いますか?

ここから落とし穴の指摘。C言語版のmrubyは setjmp / longjmp を使う理由で Rust 標準のWASM化ができないらしい。ブラウザで動かすときに大変だそう。Gemini 優秀。Googleで色々探してみるとそういうば Rust 上で mruby 作っているという話を Rubykaigi のスライドで見た気がする…。

https://mrubyedge.github.io/playground/ を使うのはどうですか?

素晴らしいアイデアとのこと。これでブラウザで動かせるはず。Gemin の壁打ちはここまで。

ありがとうございます。ここからはAntigravityを使ってPC上で進めようと思います。

今までの文脈を全て正確にAntiravityに渡せるようにプロンプトを作成してもらえますか?

  最初は「Rustからmrubyを呼び出し、スクリプト末尾の配列データを読み取って128×128の画面(Macroquad)にドット絵を描画する最小構成(⁠build.rs⁠ 含む)」から始めようと思います。

ここから Antigravity↓


# 役割
あなたはゲームエンジンの開発パートナー(Rust / mruby / Macroquadのエキスパート)です。
これから、PICO-8のようなレトロな世界観を持つ「シングルスクリプトゲームエンジン」をゼロから構築します。

# 全体の仕様(前提知識)
1. プログラム、グラフィックス、サウンド全てのリソースを1つのスクリプト(Ruby)だけで記述可能。
2. グラフィックやサウンドのデータはソースコードの1番下にデータ配列として配置する(`__END__` または末尾のハッシュ/配列)。
3. 標準の組み込みリソース(スプライトや効果音)も呼び出せる。
4. 絵文字をドット絵のように表示することも可能。
5. 解像度やパレット数に制限のある環境を想定(例: 128x128、16色)。
6. ブラウザゲーム(WASM)としてデプロイでき、リソースファイル不要の1バイナリ(単一ファイル)として配布できる。

# 技術スタックの選択
- **ホスト言語 / 描画・音声フレームワーク**: Rust + Macroquad
- **スクリプトVM**: `mruby/edge` (100% Pure Rust製のため、WASM/ネイティブともにビルドが容易)
- **ゴール**: 開発時は`.rb`を書き、配布時は1バイナリ化(またはWASM化)できる仕組みを目指す。

---

# 今回のタスク:最初のマイルストーン
まずは以下の**「最小構成のプロトタイプ」**のコードを実装したいです。

【要件】
1. **Cargoプロジェクト構成**(`Cargo.toml`)の提示
2. **ビルドスクリプト(`build.rs` 等が必要な場合)** の提示
3. **Rustのメインコード(`src/main.rs`)** の提示
   - Macroquadで 128x128 の仮想スクリーン(あるいは拡大ウィンドウ)を表示する。
   - `mruby/edge` を用いて、起動時にRubyスクリプトを読み込み、毎フレーム `update` と `draw` を呼び出す。
   - スクリプトの末尾(または `__END__` 以降)に記述されたカスタム配列(ドット絵データ)をRust側でパースし、Macroquad側でドット絵として描画する。
   - エンジン側から `spr`(スプライト描画)や `cls`(画面クリア)のAPIをRuby側に提供する。

まずは、この最小構成を動かすための具体的なファイル一式(Cargo.toml と src/main.rs、およびサンプルとなるRubyスクリプト)を作成してください。

できた。

https://github.com/ongaeshi/usakame

サンプルゲームを作らせてみるとヴァンサバ風ゲームを作ってきた。 ※ 調整が甘くて大分簡単ではある。

しばらく開発を続けていきます。