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

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

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

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

3 つのプラットフォーム

Lichii Emulator のインストール方法

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

Windows で Lichii をセットアップ

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

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

Linux で Lichii をセットアップ

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

リリースの案内

  • Linux AppImage requires glibc 2.39 or newer; the source lists Ubuntu 24.04, Fedora 40, Debian 13, and Arch.
  • Linux tar.gz packages use system libraries, so 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 requires macOS 15 or newer.

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

初回起動

初期設定

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

グラフィック

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

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

入力デバイス

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

ゲームファイル

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

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

  • Recommended download: the PGO build.
  • Back up saves before testing experimental builds.
  • To submit a desktop compatibility report, use a build containing PR #303. Play and stop a Switch 2 game, then right-click it and choose Submit compatibility report. Review the prefilled details and public preview, and explicitly consent before submission.
  • Test games with stock options first; try changing settings only if they do not work.

ゲームに戻る

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

問題の記録 453 件

GitHub issue · open

[Regression] OoT black screen with audio on Linux AMD RADV (RX 9070 XT): Build 83 works, Build 95 fails

ゲーム: The Legend of Zelda: Ocarina of Time (Switch 2) OS: CachyOS (Arch Linux), KDE Plasma / Wayland ビルド: 95 Non-PGO

On Build 95 Non-PGO in Linux AMD RADV, the game remains black-screened while intro audio plays, even after shader compilation. The symptom persisted across the reported Wayland/XWayland and environment-variable tests, and after removing Vulkan Pipeline Cache and Cache Storage.

GitHub issue · open

[Regression] OoT black screen with audio on Linux AMD RADV (RX 9070 XT): Build 83 works, Build 95 fails

ゲーム: The Legend of Zelda: Ocarina of Time (Switch 2) OS: CachyOS, KDE Plasma, Linux; Wayland and XWayland reported ビルド: 117

Build 117 renders again, but the user reports substantial FPS and frametime variability, including drops to 19 FPS.

GitHub issue · open

[Crash] Ocarina of Time (0400486024DEC000): VK_ERROR_DEVICE_LOST right after the intro cutscene on RX 7800 XT (build-88)

ゲーム: The Legend of Zelda: Ocarina of Time (Switch 2)

AMD GPU users report Vulkan VK_ERROR_DEVICE_LOST crashes around the intro-to-gameplay transition or while loading a save. Reports include RX 7800 XT, RX 9070 XT, and RX 6900 XT systems; the issue is not universal across all reports or tested builds.

GitHub issue · open

[Crash] Ocarina of Time (0400486024DEC000): VK_ERROR_DEVICE_LOST right after the intro cutscene on RX 7800 XT (build-88)

ゲーム: The Legend of Zelda: Ocarina of Time (Switch 2)

Some users report crashes or black screens after trying the EDEN_NX2_NO_MESH=1 workaround; results vary by GPU, operating system, and build.

GitHub issue · open

Title: Feature request: precompile all of a game's shaders at first boot (shader warm-up)

ゲーム: The Legend of Zelda: Ocarina of Time (Switch 2) OS: Linux (CachyOS) ビルド: Lichii build 88 (Linux AppImage)

Hard lag or freezes when shaders are being built, mostly on first visits to areas, as reported by the issue author.

GitHub issue · open

[GBug] Ocarina of Time (Switch 2): playable on RX 9070 XT with build 93, ~29 FPS in Kokiri Forest, one thread at 99%

ゲーム: The Legend of Zelda: Ocarina of Time (Switch 2) OS: Windows 11 ビルド: build-93

On build 93 with RX 9070 XT, gameplay is slow-motion at reported frame rates, with heavy bloom and overexposure in bright areas and the Great Deku Tree rendered as a dark silhouette in its intro scene.

GitHub issue · open

[GBug] Ocarina of Time (Switch 2): playable on RX 9070 XT with build 93, ~29 FPS in Kokiri Forest, one thread at 99%

ゲーム: The Legend of Zelda: Ocarina of Time (Switch 2) OS: Windows 11 ビルド: build-95 (the release tagged `build-94`)

On RX 5700 (RDNA1), Kokiri Forest performance is reported at 14–15 FPS, compared with 22–24 FPS indoors; build 95 is reported to have the same outdoor performance as build 93.

GitHub issue · open

[GBug] Ocarina of Time (Switch 2): playable on RX 9070 XT with build 93, ~29 FPS in Kokiri Forest, one thread at 99%

ゲーム: The Legend of Zelda: Ocarina of Time (Switch 2) OS: Windows 11 ビルド: Lichii-AMD 2026.11.07 (nauxph fork, f4e938f516)

On Lichii-AMD 2026.11.07 with RX 9070 XT using GPU Mode Fast, repeated rolling and jumping triggered black game frames while the HUD remained visible; the game continued running. Blackouts recurred in Kokiri Forest and were not accompanied by log output during the reported black periods.

推奨される対処法: Switching GPU Mode from Fast to Accurate at runtime restored the picture without restarting; the commenter reports stutter afterward. Accurate mode was also reported to avoid blackouts but cause heavy stutter.

GitHub issue · open

[GBug] Ocarina of Time (Switch 2): playable on RX 9070 XT with build 93, ~29 FPS in Kokiri Forest, one thread at 99%

ゲーム: The Legend of Zelda: Ocarina of Time (Switch 2) OS: Windows 11 ビルド: local clang-cl Release build of nx2 at 91d1aada6 (not PGO)

With an older configuration retaining GPU accuracy High, GPU thread splitting did not start, leaving work on one GPU thread. The commenter also reports long hitches while native pipelines were built, even with async shaders on.

GitHub issue · open

[GBug] Ocarina of Time (Switch 2): playable on RX 9070 XT with build 93, ~29 FPS in Kokiri Forest, one thread at 99%

ゲーム: The Legend of Zelda: Ocarina of Time (Switch 2) OS: Windows 11 ビルド: build-117 (PGO)

On RX 9070 XT with extracted base-game version 1.0.0, the commenter reports blackouts and a Native compute shader rejected (per-tap gather) log error. They report no blackouts or such error during about 70 minutes of play using version 2.0.0 from a .nup on build 117 PGO.

GitHub issue · open

Ocarina of Time (Switch 2) gets stuck at "Building 9 shaders" on AMD RX 6750 XT

ゲーム: The Legend of Zelda: Ocarina of Time (Switch 2) OS: Windows 11 25H2 ビルド: build-75

On an AMD RX 6750 XT, the emulator freezes at “Building 9 shaders” after launching; background audio continues and the game does not progress.

GitHub issue · open

[Crash]

ゲーム: The Legend of Zelda: Ocarina of Time (Switch 2) OS: Windows 11 26H2 ビルド: nx2-build-92

Heavy stuttering during shader compilation, sometimes dropping to 0 FPS, with poor reported performance.

GitHub issue · closed

[Crash]

ゲーム: The Legend of Zelda: Ocarina of Time (Switch 2) OS: Windows 10 ビルド: Lichii nx2-build-75

On Radeon RX 580 (Polaris / GCN4), the game hangs at 0 FPS with a black screen while building compute pipelines as the intro video starts.

GitHub issue · open

[Investigation] OoT build-88: Vulkan pipeline stalls + reproducible hidden-window NVIDIA crash (static findings, test candidates)

ゲーム: The Legend of Zelda: Ocarina of Time (Switch 2) OS: Windows ビルド: build-88

Two hidden/minimized Windows CLI launches crashed in nvoglv64.dll with exception 0xc0000094 at offset 0xEFC9BB. Static findings identify stale SDL visibility state and no zero-extent guard as possible leads, but neither is proven to cause the crash.

GitHub issue · open

macOS/MoltenVK: Ocarina of Time (0400486024DEC000) kills or hangs the Metal device at the intro-video boundary

ゲーム: The Legend of Zelda: Ocarina of Time (Switch 2) OS: macOS ビルド: nx2 at 8813b44 and 5a50f50

On macOS arm64 with Vulkan via MoltenVK, the Metal device may be lost with a GPU address fault or device error during intro video playback, or the GPU thread may hang at the video-to-gameplay transition in fence waiting or buffer download.

GitHub issue · open

macOS/MoltenVK: Ocarina of Time (0400486024DEC000) kills or hangs the Metal device at the intro-video boundary

ゲーム: The Legend of Zelda: Ocarina of Time (Switch 2) OS: macOS

On Apple GPUs, attachment-less framebuffer draws using a 32768×32768 surface clip can exceed device framebuffer limits and cause GPU failure/device loss. A user also reports a stream-buffer constant-buffer tail read issue on Metal.

GitHub issue · open

macOS/MoltenVK: Ocarina of Time (0400486024DEC000) kills or hangs the Metal device at the intro-video boundary

ゲーム: The Legend of Zelda: Ocarina of Time (Switch 2) OS: macOS ビルド: Local nx2 builds 27226d2 and 55532f2 with user patches

User reports that rejecting shader programs containing native opcode 0x4a4 avoids a Metal page fault, but may leave the run stalled at the end of the video with semaphore waits and GPU-thread abort.

ゲームの動作確認

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

セットアップについて

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

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

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

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

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

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

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

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

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

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

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