Swanium Crystal — WonderSwan Emulator

Swanium Crystal は、WonderSwan、WonderSwan Color、WonderSwan Crystal 向けゲームを実行するクロスプラットフォームエミュレーターです。

Swanium の Crystal 実装で、SDL2 を用いたネイティブの表示、入力、音声出力を提供します。エミュレーション対象は WonderSwan Crystal に固定していますが、WonderSwan / WonderSwan Color 用 ROM は Crystal の後方互換機能として実行できます。実機 BIOS は使用せず、カートリッジのリセットベクタから直接起動します。

主な機能

• WonderSwan、WonderSwan Color、WonderSwan Crystal のカートリッジを直接起動
• V30 CPU、PPU、APU、DMA、割り込み、タイマ、Bandai 2001 / 2003 mapper を実装
• SRAM、カートリッジ EEPROM、RTC の永続化
• 10 スロットのセーブステート
• 横画面・縦画面、整数倍率、フルスクリーン、nearest / linear フィルタ
• キーボードとゲームパッド入力の割り当て変更
• 最近開いた ROM、ネイティブメニュー、デバッグオーバーレイ
• macOS、Windows、Linux 向け配布物と、Crystal / SDL2 ベースの共通コア

ダウンロード

ビルド済みバイナリは Releases から入手できます。配布ファイル名は次の形式です。

macOS では ZIP を展開して Swanium Crystal.app を Applications フォルダへ移動します。Windows では ZIP を展開して swanium-crystal.exe を実行します。Linux 版は X11、または Wayland 上の XWayland を使用します。GTK3 がウィンドウとメニューを、SDL2 が同じウィンドウ内のゲーム画面を担当します。Wayland ネイティブバックエンドには対応していません。

macOS の注意: 配布アプリは Apple のノータリゼーションを受けていません。Gatekeeper にブロックされた場合は、システム設定の「プライバシーとセキュリティ」から「このまま開く」を選ぶか、次を実行してください。

xattr -cr "/Applications/Swanium Crystal.app"

必要なもの

実行するには、利用者自身が合法的に所有・用意した WonderSwan 用 ROM ファイルが必要です。本プロジェクトは ROM、BIOS、セーブデータを配布・収集・ダウンロードしません。

ファイル選択メニューから開くか、コマンドラインでファイルを指定します。

swanium-crystal --rom /path/to/game.wsc

受け付ける拡張子は .ws と .wsc です。カートリッジヘッダと起動エントリを検証してから読み込みます。BIOS は不要です。

ビルド

macOS

Xcode Command Line Tools、Homebrew、mise を導入してから実行します。

git clone https://github.com/bubio/swanium-crystal.git
cd swanium-crystal
brew install sdl2 sdl3
mise run setup
mise run build

アプリケーションバンドルは bin/Swanium Crystal.app に生成されます。

Linux

SDL2、GTK3、GDK X11 の開発パッケージと mise を導入してから実行します。

git clone https://github.com/bubio/swanium-crystal.git
cd swanium-crystal
mise run setup
mise run build-linux

実行ファイルは bin/swanium-crystal に生成されます。

Windows

Visual Studio の MSVC 環境、SDL2 開発パッケージ、mise を用意し、SDL2 の展開先を SWANIUM_SDL2_DIR に指定して実行します。

git clone https://github.com/bubio/swanium-crystal.git
cd swanium-crystal
mise run build-windows

実行ファイルは bin/swanium-crystal.exe に生成されます。

使い方

アプリを引数なしで起動すると、ROM を選択するウィンドウを開きます。--rom を指定するとその ROM を直ちに起動します。

メニューから ROM の選択、最近開いた ROM、スロット 0–9 のセーブステート、表示倍率、フルスクリーン、フィルタ、キーボード／ゲームパッドの割り当てを変更できます。

ライセンス

Swanium Crystal のソースコードは MIT License で提供します。ROM、BIOS、商用ゲームデータ、セーブデータは含まれません。

Swanium Crystal は非公式のファンプロジェクトであり、Bandai Namco Entertainment Inc. および WonderSwan 関連の権利者とは提携していません。