インストールとトラブルシューティング

Lichii Emulator のセットアップとトラブルシューティング

ダウンロードから初回起動まで。コントローラーを設定し、ゲームを追加して、起動やプレイを妨げる問題を解決しましょう。

Lichii Emulator のセットアップを表す、取り外したコントローラー、USB-C 接続、ボタン割り当て画面
イラスト:Lichii Emulator のセットアップガイド
Latest recorded build build-88 Pre-release Published November 6, 2026

3 つのプラットフォーム

Lichii Emulator のインストール方法

プラットフォームを選び、手順に沿ってインストールしてください。

Windows で Lichii をセットアップ

  1. 公式の build-88 から現在の Windows 向けファイル(lichii-windows-x86_64.zip (x86_64))をダウンロードし、元のファイル名のまま保存してください。
  2. 書き込み権限のあるフォルダーにアーカイブを展開してください。圧縮ファイルから実行ファイルを直接起動しないでください。
  3. 展開したフォルダーから lichii.exe を起動します。Windows がセキュリティ警告を表示した場合は、続行するかを決める前に、ファイルが公式リリースのリンクから入手したものか確認してください。

別のパッケージが必要ですか? windows 向けのダウンロードを見る

Linux で Lichii をセットアップ

  1. 公開された Linux 向けファイル(lichii-linux-aarch64.AppImage (arm64), lichii-linux-aarch64.tar.gz (arm64), lichii-linux-x86_64.AppImage (x86_64), lichii-linux-x86_64.tar.gz (x86_64))から、システムのアーキテクチャに合うものを選び、リリースのリンクからダウンロードしてください。
  2. lichii-linux-aarch64.AppImage の場合は、ダウンロードしたファイルがあるフォルダーで chmod +x 'lichii-linux-aarch64.AppImage' を実行し、その AppImage を起動してください。
  3. lichii-linux-aarch64.tar.gz の場合は、先にアーカイブを展開し、そのフォルダーから同梱の実行ファイルを起動してください。glibc や Qt の依存関係が不足していると表示されたら、選択したリリースのノートと元の Issue で必要なバージョンを確認してください。
  4. 後で互換性の結果と同じビルドを照合できるように、リリースの URL とビルドタグをインストールしたファイルと一緒に控えておいてください。

リリースの案内

  • Linux AppImage requires glibc 2.39 or newer.
  • Linux tar.gz uses system libraries; Qt 6 and the usual libraries must be installed.

別のパッケージが必要ですか? linux 向けのダウンロードを見る

macOS で Lichii をセットアップ

  1. 公開された macOS 向けファイル(lichii-macos-arm64.dmg (arm64), lichii-macos-arm64.zip (arm64))から、システムのアーキテクチャに合うものを選び、リリースのリンクからダウンロードしてください。
  2. lichii-macos-arm64.dmg の場合は、DMG を開き、「アプリケーション」など、自分で管理できる場所にアプリを移動してください。
  3. lichii-macos-arm64.zip の場合は、ZIP を開き、自分で管理できる場所にアプリを移動してください。初回起動時に macOS が確認を求めたら、アプリを右クリックして「開く」を選択します。
  4. macOS がセキュリティ警告を表示したら、続行する前にダウンロードしたファイルを公式リリースと照合してください。通常のシステム保護は有効のままにしてください。
  5. 選んだ配置先から Lichii を起動します。

リリースの案内

  • macOS arm64 package requires macOS 15 or newer.

別のパッケージが必要ですか? macos 向けのダウンロードを見る

初回起動

初期設定

初回起動時に、使いやすいボタン配置にし、グラフィックを調整して、自分のゲームライブラリを用意しましょう。

グラフィック

使っているビルドのリリースノートにあるグラフィック設定から始めてください。設定は一度に 1 つずつ変更し、結果を記録する場合はビルドタグも残してください。

ゲームごとの設定の目安は、該当する 互換性レポートを参照してください。

入力デバイス

コントローラーを接続し、ボタンを割り当ててプロファイルを保存します。ボタンが反応しない場合は、コントローラーの機種と Lichii のビルドをトラブルシューティングで検索してください。

ゲームファイル

Lichii のライブラリやゲームファイルを開く機能から、合法的に入手したゲームを追加してください。ゲーム、キー、ファームウェアは別途用意します。

現行の公式セットアップ情報

  • Games and system files are not included; use only games and system files you have legally obtained.
  • The rebrand retains the existing Eden/Eglantine data directories and configuration keys. It does not move or delete saves, settings or shader caches.
  • Back up saves before testing experimental builds.
  • Before changing settings, try booting games with stock options.

ゲームに戻る

Lichii でよくあるエラーと対処法

問題の記録 128 件

GitHub issue · open

Old Gtx e new rtx, same fps

GitHub issue · open

[VBug] fairy fountain invisible green hat boy game

GitHub issue · open

[GBug] literally The Legend of Green

OS: Windows 11 ビルド: Lichii nx2 build 83 (5a50f50)

The issue title says “literally The Legend of Green,” but the game field is “Other / not listed”; no specific compatibility symptom is stated.

GitHub issue · open

[VBug] start up on OoT remake screen plays, but after that only audio and a black screen

ゲーム: Other / not listed OS: Windows 11 ビルド: build 75

After the startup screen, audio plays but the screen is black.

GitHub issue · open

[GBug]

GitHub issue · open

[Crash] Loading Shaders AMD

ゲーム: Other / not listed OS: Windows 11; Linux ビルド: 75

The emulator closes while loading shaders before a game is opened; the report says it used 20GB of RAM. Reports mention Windows 11 and Linux, and AMD GPUs.

GitHub issue · open

[GBug] Fast Fusion runs at max 24 fps

GitHub issue · open

[VBug] OoT Black screen after the first cutscene and weird vhs filter in docked mode

ゲーム: Other / not listed OS: Windows 11 ビルド: 75

Black screen after the first cutscene in handheld mode and VHS-like visual filter in docked mode.

GitHub issue · open

[VBug] black screen and slow stuttery dialogue

ゲーム: Other / not listed OS: Windows 11 ビルド: Latest nov 5 2026

After the intro, the scene where the deku tree is talking is completely black with very slow, stuttery dialogue.

GitHub issue · open

[GBug] Mac: 20 fps + audio cuts in and out

GitHub issue · closed

[VBug] Green-hat adventure game boots to black screen, only audio, on mac

ゲーム: Other / not listed OS: macOS ビルド: build 75

Boots to a black screen with audio on macOS.

推奨される対処法: Clear the cache and launch again.

GitHub issue · closed

[VBug] OOTRemake only title screen, no video and ui (only sound)

ゲーム: Other / not listed OS: Windows 11 ビルド: build-75

User reports a black background at the title screen and a black screen after starting a new game, with sound still audible.

GitHub issue · open

[GBug] Audio disappears the legend of zelda

ゲーム: Other / not listed OS: Windows 11 ビルド: 75

Music disappears during the cutscene after booting the game.

GitHub issue · open

[Crash]

ゲーム: Other / not listed OS: Windows 11 ビルド: build-80

The game crashes while building shaders after the title card fades.

GitHub issue · open

[VBug] Black screen on cinematic

ゲーム: Other / not listed OS: Windows 11 ビルド: 75

Black screen during cinematic after the main menu appears; reported on Windows 11 with an AMD RX 6000 series or older GPU.

GitHub issue · open

[Crash] infinite launch screen with legend of zelda ocarina of time

ゲーム: Other / not listed OS: Windows 10 ビルド: 286117c7e0-nx2

Infinite startup launch loop when booting the .NUP version.

GitHub issue · open

[VBug] OOTR Terrain visible trough objects

ゲーム: Other / not listed OS: Windows 11 ビルド: build-75

Terrain is visible through solid objects after getting past the intro.

ゲームの動作確認

ゲームの互換性を確認する

セットアップについて

セットアップに関するよくある質問

古いバージョンを先に削除するべき?

新しいビルドをインストールして動作を確認するまでは、今動いているバージョンを残してください。切り替える前にセーブデータと設定をバックアップしてください。

Windows で依存関係が不足していると表示されたら、何を確認すればいい?

同じリリースの付属ファイルはすべて lichii.exeと同じフォルダーに置いてください。リリースノートや Issue トラッカーで、依存関係のエラー文をそのまま検索してください。

メニューではコントローラーが動くのに、ゲーム内では反応しない。どうすればいい?

入力プロファイルとボタンの割り当てを見直してください。その後、トラブルシューティングでコントローラーの機種やゲーム名を検索してください。

クローズ済みの Issue が表示されるのはなぜ?

「Closed」は Issue トラッカーでの状態です。議論を読み、問題が修正されたのか、移動されたのか、別の理由でクローズされたのかと、影響を受けるビルドを確認してください。

サポートを求めるときは何を伝えればいい?

Lichii のビルド、OS、GPU とドライバー、エラー全文、エラーを起こす手順を記載してください。以前は動作していたビルドでも起きるかどうかを添えてください。