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

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

[GBug] Ocarina of Time (0400486024DEC000): gameplay settles at ~29 fps, CPU-bound on two cores (build 75)

ゲーム: The Legend of Zelda: Ocarina of Time

User reports describe gameplay performance below 60 FPS on multiple systems and builds. One report also describes a black 3D screen in Handheld mode; switching to Docked allowed rendering.

GitHub issue · open

[GBug] Ocarina of Time (0400486024DEC000): gameplay settles at ~29 fps, CPU-bound on two cores (build 75)

ゲーム: The Legend of Zelda: Ocarina of Time

A user report says resolution 2X caused flicker or line artifacts; a separate candidate-build report says the release's overexposure warning was not cleared by its limited test.

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 OS: Windows 11 ビルド: build-75

On AMD RDNA2 GPUs, the game may freeze during shader or pipeline building, sometimes with background audio continuing. A commenter also reports black-screen or shader-building hangs with asynchronous shader compilation enabled.

GitHub issue · open

[Crash] Ocarina of Time: AMD RX 7900 XTX driver timeout / device lost at gameplay start, gone with #150 reverted

ゲーム: The Legend of Zelda: Ocarina of Time OS: Windows

User reports GPU driver timeout or device loss when gameplay starts on AMD Windows systems, including RX 7900 XTX and RX 9060 XT. Reports associate the issue with #150 pointer-binding changes, but this is an unconfirmed hypothesis.

GitHub issue · open

Ocarina of Time (0400486024DEC000) build-75: macro parameter desync + unknown texture format 100, broken lighting/bloom and corrupted textures

ゲーム: The Legend of Zelda: Ocarina of Time OS: Gentoo Linux ビルド: build-75

On build-75, user reports over-bright bloom/glow, overly dense fog, incorrect lighting, and some textures decoded as garbage; logs include macro-parameter assertions and an unknown texture format 100.

GitHub issue · open

[VBug] OoT (0400486024DEC000): textures flicker with Low GPU accuracy + EDEN_NX2_SPLIT=2 on AMD RX 9070 XT; High fixes it but turns the split off (~9 fps)

ゲーム: The Legend of Zelda: Ocarina of Time OS: Windows 11

Textures and surfaces flicker with Low GPU accuracy and EDEN_NX2_SPLIT=2 on Radeon RX 9070 XT; some surfaces remain white temporarily.

GitHub issue · open

[VBug] OoT (0400486024DEC000): textures flicker with Low GPU accuracy + EDEN_NX2_SPLIT=2 on AMD RX 9070 XT; High fixes it but turns the split off (~9 fps)

ゲーム: The Legend of Zelda: Ocarina of Time

Outdoor haze is very strong, and the river surface can appear dark or black.

GitHub issue · open

[VBug] OoT (0400486024DEC000): textures flicker with Low GPU accuracy + EDEN_NX2_SPLIT=2 on AMD RX 9070 XT; High fixes it but turns the split off (~9 fps)

ゲーム: The Legend of Zelda: Ocarina of Time

A commenter reports being unable to load a save, with the PC hard-locking or freezing before recovering after a driver crash or timeout; same GPU, 32GB RAM, and i7 9700K.

GitHub issue · closed

[GBug] Ocarina of Time: black 3D gameplay screen; HUD remains visible (Lichii build 75)

ゲーム: The Legend of Zelda: Ocarina of Time ビルド: Lichii nx2 build 75

The 3D gameplay scene can appear black while the HUD remains visible.

推奨される対処法: Switch to Docked mode; one commenter reported this resolved the black screen. Other reports say this workaround did not help.

GitHub issue · closed

[GBug] Ocarina of Time: black 3D gameplay screen; HUD remains visible (Lichii build 75)

ゲーム: The Legend of Zelda: Ocarina of Time ビルド: Lichii build 75

A commenter reported stuttering, FPS drops, and overexposure after switching to Docked mode.

GitHub issue · closed

[GBug] Ocarina of Time: black 3D gameplay screen; HUD remains visible (Lichii build 75)

ゲーム: The Legend of Zelda: Ocarina of Time OS: Windows 11

A commenter reported flickering shadows and trees with no leaves.

GitHub issue · closed

[GBug] Ocarina of Time: black 3D gameplay screen; HUD remains visible (Lichii build 75)

ゲーム: The Legend of Zelda: Ocarina of Time OS: Windows 11

A commenter reported audio playing ahead of the video during the intro.

GitHub issue · open

[VBug] Doesn't work for AMD GPU - 9070 XT (The Legend of Boy in Green Hat)

ゲーム: The Legend of Zelda: Ocarina of Time OS: Windows 11 Version 26H2 ビルド: Build 75

With use_disk_shader_cache = true, subsequent boots hang indefinitely at Loading Shaders 25 / 27.

推奨される対処法: Delete cache/shader/0400486024dec000 and set use_disk_shader_cache = false; the reporter says this resolves the startup freeze.

GitHub issue · open

[VBug] Doesn't work for AMD GPU - 9070 XT (The Legend of Boy in Green Hat)

ゲーム: The Legend of Zelda: Ocarina of Time ビルド: build 75

Black screen after the intro on AMD RX 9070 XT; the game's 1080p upscaler shader is rejected.

推奨される対処法: Comment reports that #112 fixes the shader rejection; its CI build is fix/oot-upscaler-gathers / 7459f10 (build-80), and the fix is on nx2, but not in a release yet.

GitHub issue · open

[VBug] Doesn't work for AMD GPU - 9070 XT (The Legend of Boy in Green Hat)

ゲーム: The Legend of Zelda: Ocarina of Time OS: Windows 11

On AMD, the world is black except around Navi and Link; an RX 6800 XT reporter says the workaround still leaves all 3D geometry black.

推奨される対処法: Comment reports that #127 fixes AMD-only demote reordering. Before it is merged, setting EDEN_NX2_REJECT_HASH=e40561a7a0f7a0b3 in %APPDATA%\eden\nx2_switches.txt makes the world visible on the RX 9070 XT report; another reporter says it does not resolve 3D rendering on the RX 6800 XT.

GitHub issue · open

[VBug] Doesn't work for AMD GPU - 9070 XT (The Legend of Boy in Green Hat)

ゲーム: The Legend of Zelda: Ocarina of Time ビルド: build 75

Texture flicker with Low GPU accuracy and GPU thread split on AMD RX 9070 XT.

GitHub issue · open

[VBug] Doesn't work for AMD GPU - 9070 XT (The Legend of Boy in Green Hat)

ゲーム: The Legend of Zelda: Ocarina of Time

Handheld mode is reported as much brighter and blurrier than Docked mode.

GitHub issue · open

[VBug] Ocarina of Time: AV1 cutscenes render solid green on AMD/RADV (audio and subtitles OK)

ゲーム: The Legend of Zelda: Ocarina of Time OS: Linux (CachyOS) ビルド: 75 (`nx2-build-75`, Linux x86_64 PGO AppImage)

On Linux with AMD/RADV, AV1 intro cutscene video renders solid green while audio and subtitles work.

GitHub issue · open

[VBug] Ocarina of Time: AV1 cutscenes render solid green on AMD/RADV (audio and subtitles OK)

ゲーム: The Legend of Zelda: Ocarina of Time OS: Windows 10 22H2 (19045.6466) ビルド: `nx2-build-75`, MSVC x86_64 (`lichii-windows-x86_64.zip`)

On Windows 10 with AMD, the intro AV1 cutscene shows a black video layer with working audio and subtitles, then the emulator hangs indefinitely.

GitHub issue · open

[Build] Tree does not compile with clang-cl on Windows (NOMINMAX and FARPROC casts)

ゲーム: The Legend of Zelda: Ocarina of Time OS: Windows 11 ビルド: b8c812b18

A local ClangCL build of b8c812b18 stalled at max present 8 and showed no frames; a local MSVC build of the same commit stalled at max present 8 and died within a minute, unlike the reported build-75 release.

GitHub issue · open

[GBug] Ocarina of Time / Audio Desync

ゲーム: The Legend of Zelda: Ocarina of Time OS: Windows 11 ビルド: 75

User reports audio/video desynchronization on the title screen and intro; a commenter reports slow-motion live-rendered title-screen video with audio leading by approximately three seconds, worsening by the initial dream cutscene.

GitHub issue · open

[VBug] [nx2-build-75] Zelda: Ocarina of Time (0400486024DEC000) black screen — no AV1 decoder

ゲーム: The Legend of Zelda: Ocarina of Time OS: Windows 11 26H2 ビルド: 75

User reports a black screen after the game's AV1 video streams fail to decode; FFmpeg reports no decoder for "video/av1". The game idles indefinitely on a black frame.

GitHub issue · open

[GBug] Ocarina of Time (0400486024DEC000): black screen on Adreno 740/Turnip, pipeline builders stuck in driver until memory runs out

ゲーム: The Legend of Zelda: Ocarina of Time OS: Linux 7.2.6, ArmadaOS (Fedora 44 based) ビルド: build-75

On Adreno 740 with Turnip, large native compute-shader pipelines can keep Vulkan pipeline-builder workers busy, consume substantial memory, and result in a black screen; some tests also reported GPU hangs or device loss.

GitHub issue · open

[GBug] Zelda OOTR Won't Load

ゲーム: The Legend of Zelda: Ocarina of Time OS: Windows 11 ビルド: 70

Issue reporter says Zelda Ocarina Of Time Remake stays on "Launching..." indefinitely; the log records an emulated program break with error F001. Other reports mention an infinite launch screen.

GitHub issue · open

[GBug] Zelda OOTR Won't Load

ゲーム: The Legend of Zelda: Ocarina of Time ビルド: release-binaries #75

A user reports severe shader problems with white visuals; handheld mode shows a black screen.

GitHub issue · open

[GBug] Zelda OOTR Won't Load

ゲーム: The Legend of Zelda: Ocarina of Time OS: Windows ビルド: R75 PGO

A user reports a black screen past the title screen.

GitHub issue · closed

[GBug]

ゲーム: The Legend of Zelda: Ocarina of Time OS: Windows 11 26H2 (Build 26300.9818) ビルド: Lichii Development Build — nx2-build-75

The 3D gameplay scene is black while HUD elements remain visible; menus and item preview can render correctly.

ゲームの動作確認

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

セットアップについて

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

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

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

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

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

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

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

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

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

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

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