Lichii README

项目的 README,来自 github.com/zortos293/Lichii。合并为一个 markdown 文件:README.md。

⚠️ Lichii has no official website ⚠️

[!CAUTION] Lichii has no official website. The only site run by this project is the game compatibility website, lichii.zortos.me, for compatibility reports only. Download Lichii only from this repository's releases page. Any other "Lichii" website or download (such as lichii.org) is not ours and may contain malware (#545).

Lichii

Lichii

Lichii is an experimental, open-source Nintendo Switch and Switch 2 emulator written in C++. It builds on Eglantine, Eden, yuzu and Sudachi, preserving their contributions while developing this fork's game compatibility and renderer fixes.

This is an independent fork, not an official release of those upstream projects. Lichii is not affiliated with Nintendo.

Visit the Lichii game compatibility website to find games and compare community compatibility reports.

Downloads and setup

Download Lichii only from this repository's releases page. Lichii has no other download site: archives offered elsewhere, such as lichii.org, are not built by this project, and one has been reported to install malware (#545).

On Windows, extract the entire build archive and run lichii.exe. Only use games and system files you have legally obtained. Games, keys and firmware are not included.

Existing saves and settings

Lichii uses its own profile: %APPDATA%\lichii on Windows, and the lichii directories under $XDG_DATA_HOME, $XDG_CONFIG_HOME and $XDG_CACHE_HOME on Linux and macOS. Without XDG overrides, these are ~/.local/share/lichii, ~/.config/lichii and ~/.cache/lichii. An existing portable user/ directory still takes priority and is not imported or changed by the wizard.

On the first non-portable GUI launch, Lichii offers to import Eden and other detected emulator profiles. Back up %APPDATA%\eden first on Windows, or the old data, config and cache directories on Unix, and close the source emulator. Choose Keep Old Data to copy without changing the source, then check your saves and relaunch. Existing destination data is retained in backup directories rather than merged. Move also retains a source backup until you remove it yourself; Link deliberately shares settings and saves. Paths outside the imported data root remain shared and unchanged. An interrupted import offers recovery on the next launch. eden-cli, including --help and --version, refuses to initialize configuration until you import or explicitly choose Start fresh in the GUI.

Compatibility and issue reports

Compatibility and performance vary by game, hardware and driver. Rendering errors, stutters and crashes remain possible. Passing automated tests does not establish that a game renders correctly, and this project makes no universal frame-rate guarantee.

Browse community compatibility reports for results with each player's build and setup.

Desktop reporting requires a build containing PR #303 and is not available in build 88. In builds that include it, play and stop a Switch 2 game, then right-click that game and choose Submit compatibility report. Only the latest session in the current Lichii process is eligible.

Confirm the matching website catalog entry and review the editable machine, game, setup, and enabled add-on details prefilled where available. Check the public preview and give explicit consent before submitting. Nothing uploads automatically, and the native v1 reporter does not read or upload logs or files.

When reporting an issue, include:

Do not upload game files, keys, firmware or private account information.

Building and contributing

See the build guide, user documentation and coding guidelines. Some inherited documentation and internal build target names still use upstream names. The GUI build target is lichii; its output is lichii.exe on Windows and lichii on other desktop platforms.

Keep changes focused and distinguish code-level checks from actual gameplay testing.

Artwork

Art created by YOB (yobslab) The supplied Lichii logo, icon and library artwork are in dist/branding. Windows, Linux and macOS icon resources are generated from that artwork by Generate-LichiiIcons.ps1.

Support Lichii

Lichii is free and stays free. If you want to help, you can donate in crypto. Donations help pay for the AI tools and build machines used to develop this open-source project faster.

Solana (SOL)

JepEjfyWjGjhJvHSrqj52KtLjcbbbmUh1iGqerYBF4w

Ethereum (ETH)

0x055ABa1b80Bc35C836Ce7E9F47c2b3d6C75b5534

Bitcoin (BTC)

bc1qcvxdpf4qvdhqp8ee4s355cjmxrzsphsdwpl8w4

BNB Smart Chain (BNB)

0x055ABa1b80Bc35C836Ce7E9F47c2b3d6C75b5534

Polygon

0x055ABa1b80Bc35C836Ce7E9F47c2b3d6C75b5534

Send each coin on its matching network. Coins sent on the wrong network can't be recovered.

[!NOTE] Donations are voluntary gifts and are non-refundable. A donation does not buy any product, service, perk, early access, exclusive build, priority support or say in the project. Every release stays free and public for everyone.

Credits and license

Lichii inherits the work of the Eglantine, Eden, yuzu and Sudachi projects and their contributors, including Eglantine's original developer Camille LaVey. Original copyright notices and third-party licenses are retained.

See LICENSE.txt and the source files for applicable license terms.

Lichii (zortos293/Lichii)

正在搜索数据库…

9.7K ·GitHub
这是什么?Eglantine 是一款免费开源(FOSS)的 Nintendo Switch 2 模拟器,衍生自 Eden、Yuzu 和 Sudachi 模拟器。本仓库是由 Zortos 维护的非官方分支,加入了上游 Eglantine 项目尚未包含的修复。
这是一个桌面应用,还是我可以嵌入到其他地方的库?它是用 C++ 编写的原生桌面应用,你可以直接安装并在电脑上运行,不是库或 SDK。
我要怎么让它运行起来?可以从本分支的发布页面下载预编译版本,或者按照 README 中链接的 General Build Guide(通用编译指南)自行从源代码编译。
现在能用它来玩我的游戏吗?不能。项目明确标注为“VERY experimental”(非常实验性),目前只有《Mario Kart World》和《Splatoon Raiders》等少数游戏确认能较为流畅地运行;完整的兼容性列表仍在整理中。
它支持哪些操作系统?它可以在 Windows、Linux 和 macOS 上编译和运行。
这个分支相比上游 Eglantine 修复了什么?修复了一个内存泄漏问题,使内存占用保持在 4–5 GB 左右,而不是持续增长到 20 GB 以上;使更多游戏能够启动(包括 Welcome Tour);恢复正常的游戏运行速度;让大多数游戏接近 60 FPS;并修复了若干纹理问题,以及主机模式(docked mode)下的 HDR 颜色错误。
哪些游戏实际运行得不错?《Mario Kart World》的运行速度从尚可到全速不等,取决于你的硬件;《Splatoon Raiders》的性能时好时坏。完整的支持游戏列表仍在整理中。
这个分支所基于的原始项目是谁发起的?原版 Eglantine 模拟器由开发者 Camille LaVey 发起;本仓库是 Zortos 在其基础上独立维护的分支。
作者
zortos293
大小
283.2 MB
星标
9.7K
时长
18天
提交 · 90 天