darling-lol README

项目的 README,来自 github.com/lucannez64/darling-lol。合并为一个 markdown 文件:README.md。

darling-lol

Darling-LoL

Experimental macOS League of Legends client on x86-64 Linux through Darling

[!IMPORTANT]

Critical Announcement

1. Maintenance: Built mainly as a technical challenge, because everyone kept telling me it was impossible. I do not have the time to maintain it fully. Apart from issues that block you completely, I will only review and merge pull requests.

2. Bans: You will probably get permabanned. You alone are responsible for launching the game in a modified environment (Darling).

  • DO NOT cheat.
  • DO NOT play ranked.
  • DO NOT use your main account.

Note: Currently triggering 3-Day Suspensions ("UNSUPPORTED_THIRD_PARTY_TOOLS"). DON'T USE IT RN.

3. Continuity: If discontinued, patches remain available under their upstream licenses, and the original integration tooling under GPL-3.0.

4. To Riot: A lot of players want to play your game on Linux. If you want to fix this, make LoL Next compatible natively or via a layer like Proton (Epic did it with Easy Anti-Cheat, kernel anticheat included). Contact: [email protected] (especially for an official or supported version of League on Linux).

Open to work: part-time remote as an employee, or full-time remote as a freelancer for a mission.


Status

This is a development snapshot, not a finished launcher. The Riot and League clients launch, and manually played ARAM games have run. Graphics, audio, input, startup crashes and memory reclamation have received compatibility fixes.

What's included

Not included: game files, Riot installers, account databases, tokens, prefixes, captures or compiled binaries. Install the game manually through Riot. The normal launcher does not patch the client, enable an Electron inspector, or start UI automation helpers. It clears DYLD_INSERT_LIBRARIES and keeps Darling runtime overrides; this is not a claim of approval by Riot.


Requirements

scripts/build.sh and scripts/install-runtime.sh run scripts/preflight.py first and stop on unsupported versions (RCLOL_SKIP_PREFLIGHT=1 bypasses it). For other distributions, see the dependency list in the pinned Darling source; tools/env-check.sh is a starting check (package names may need adapting).


Automated Installation

Installs dependencies, configures the build environment and compiles Darling-LoL. Requires at least 50 GiB free.

Supported distributions: Fedora 44+, Arch Linux, Debian 14+, Ubuntu 26.04+. Hosts outside this list (for example Ubuntu 24.04 and its derivatives) can still install through a Fedora Toolbox container with --toolbox.

git clone https://github.com/lucannez64/darling-lol
cd darling-lol
bash scripts/install-native.sh

Options:

Options can be combined: bash scripts/install-native.sh --toolbox --verbose


Build Instructions

Nix / Rootless Package (experimental)

Nix supplies the launcher and dependencies, not a prebuilt Darling or the game. First setup is interactive and builds into the writable per-user workspace.

nix run github:lucannez64/darling-lol#installer
nix run github:lucannez64/darling-lol#default -- --update
nix run github:lucannez64/darling-lol#default
nix run github:lucannez64/darling-lol#shell

From a local checkout:

nix run .#installer
nix run .#default

Limits: run updates only after manually closing the clients and shutting Darling down; a live prefix marker blocks a second launch; one workspace/namespace is supported at a time; do not delete build/nix-gcroots/ while in use. See Nix setup and operational limits.

Manual Build (Non-Nix)

Ensure no Riot/League session is running before installing the runtime.

git clone https://github.com/lucannez64/darling-lol.git
cd darling-lol
python3 -m venv build/venv
build/venv/bin/pip install -r requirements.txt
python3 scripts/configure.py --guest-user "$USER"
./scripts/build.sh
sudo cmake --install build/darling-src/build
./scripts/install-runtime.sh

Default layout: /usr/local/libexec/darling, ~/.darling and /Users/$USER inside the guest (use the real guest account name if different). Paths are rendered into ignored files under build/runtime/tools; don't run the tokenized tools/ templates directly. The install wrapper shuts Darling down before replacing per-user overrides and backs up relevant files. See setup details.


Launch & Usage

For native and manual builds, install the Riot Client (change euw to your region), then sign in and install League through Riot's own UI. For Nix, use the Nix launch instructions:

./scripts/installer.sh euw

Launch:

./scripts/run.sh

First installs and future Riot updates can still hit compatibility gaps (e.g. an accepted Install action failing native LaunchAgent registration and leaving the download idle). The archived inspector-based workaround is excluded from the manual workflow. The client window-visibility correction is part of the installed runtime (Darling's AppKit overlay), not a patch to Riot's binaries. See troubleshooting for the known limitation and the fixes already in the runtime.

Advanced launch options:

These window-management helpers are opt-in, off by default, and do not patch client binaries.


Updating

Exit the game and both clients first.

Nix users: use nix run --refresh github:lucannez64/darling-lol#default -- --update when running through Nix. For an installed profile or system package, upgrade the package first, then run darling-lol --update. The commands below are for native and manual builds.

Native / manual builds (for a --toolbox install, run these inside the container):

git pull
./scripts/update.sh
sh scripts/run.sh

update.sh re-applies changed patches (reverting the earlier version of each, so other edits survive), rebuilds incrementally and reinstalls the base runtime and per-user overrides. It refuses to run while a Riot or League process is open. For single components, see incremental updates.

A built runtime can also be shipped without the toolchain via tools/runtime-package.py: see prebuilt runtime overlays.


Testing

Start with the standalone regression checks, then play a match manually: docs/TESTING.md. Do not attach a debugger, query client APIs, inject diagnostic hooks or automate client/game input. The project includes standalone compatibility probes and the opt-in host-side window-management helpers described above, but no client injection hooks, client API automation or input automation; the normal launcher enables none of them.

FPS counters, presentation requests and display refresh are different measurements. Record average and p99 frame times, scene, graphics settings, power state and focus. Game-process speed switches are in setup; the passive match sampler is mentioned in status.


Repository Layout

scripts/                portable entry points
upstream/manifest.json  exact base revisions and patch ownership
patches/                current source changes, one patch per repository
tools/                  runtime templates, installers, standalone probes
tests/                  regression tests
research/               research notes
docs/                   setup, testing, status, compliance, interoperability
.github/workflows/      CI
build/                  local sources, outputs, rendered tools (ignored)

This is an unofficial interoperability effort. It distributes source patches for Darling and original tooling, not the Riot client, game code, assets or accounts. The normal launcher does not patch the client, game, CEF or anti-cheat. Users obtain the client from Riot and are responsible for complying with Riot's terms; account restrictions are possible. See interoperability scope and compliance guidance (neither is legal advice).

Darling/upstream components keep their licenses (NOTICE.md). Original integration tooling is GPL-3.0; patches retain the licensing of their target files.

League of Legends and Riot Games are trademarks or registered trademarks of Riot Games, Inc. This project is not affiliated with, endorsed by, or sponsored by Riot Games.

Donations: Support on Ko-Fi

darling-lol (lucannez64/darling-lol)

正在搜索数据库…

这是什么?这是一组实验性的补丁和工具,通过给 Darling macOS 兼容层打补丁,让你能在 x86-64 Linux 上运行 macOS 版的英雄联盟客户端。
这是现成的启动器,还是只是给 Darling 的补丁?这是一个开发快照:包含针对 30 个 Darling 组件的固定版本源码补丁,以及构建、安装和启动的封装脚本,并不是成品的一键启动器。
我到底该怎么用它把英雄联盟跑起来?先用项目自带的安装脚本构建打过补丁的 Darling 运行时。脚本会完成编译、停止 Darling、替换每用户的覆盖配置,并备份受影响的文件。之后登录,再通过 Riot 自家的客户端界面安装英雄联盟。
构建之前需要先装什么?带 Git LFS 的 Git、Bash、curl、unzip、CMake、Make、带 LLVM 开发文件的 Clang/LLD、C/C++ 编译器、Python 3.12+,以及 Darling 自身的构建依赖和 X11/XCB/SHM 开发文件。另外还需要大约 50 GB 的可用磁盘空间。
用这个会被 Riot 封号吗?很可能会,即便你遵循了作者的建议:不要用主账号,不要排位,也不要作弊,因为这仍然属于未受支持的修改版客户端。
英伟达显卡也能用吗?目前只有 AMD 的 RADV Vulkan 驱动经过实际测试;NVIDIA 显卡以及混合显卡的笔记本配置均未经验证,可能无法正常工作。
和在 Windows 上原生运行英雄联盟相比,性能如何?在 Ryzen 5 5500 / RX 6600 的测试机上,ARAM 在 Darling 下现在平均约为 118-135 FPS,修复近期问题前约为 84 FPS;而原生 Windows 上为 170-190 FPS。
我能切换到其他 Riot 大区或语言吗?可以,启动前设置 RCLOLREGION 和 RCLOLLOCALE 环境变量即可,例如 'RCLOLREGION=NA RCLOLLOCALE=enUS ./scripts/run.sh'。
这个项目包含任何自动化或作弊工具吗?没有。作者明确表示,本项目不附带任何客户端自动化、检查或性能分析辅助工具,测试说明也禁止调试、API 查询或输入自动化。
大小
3.8 MB
星标
742
更新
提交Nov 17
时长
1个月
提交 · 90 天