peiikai/LASRecomp

选用指南

AI 根据 README 整理 · 2026/10/22 14:01:51

使用方式

以桌面应用形式运行，首次启动会设置游戏文件并本地重编译，提供开始界面选择原版或随机种子、设置字体和控制映射，支持F1或手柄组合键呼出覆盖菜单，可随时在随机种子间切换。

查看 README 依据

> and `romfs` folders, or their contents. Instructions on how to obtain these files will **NOT** be provided. > On first launch the app sets up what it needs, including the actual recompilation locally. No game files, assets or fonts are included. > The screenshot shows the start screen after setup; no Nintendo artwork is included until provided by the user.  ## Project Discord https://discord.gg/DhrgdYqdcY ## Status

Known issues and their status are on the [GitHub issues page](https://github.com/peiikai/LASRecomp/issues). ## Features **Runs natively** - **This is not emulation.** Runs natively on Windows, macOS and Linux using static recompilation of the Switch code. - Unlocked aspect ratio: wider (or taller) windows show more of the island, up to ultrawide; houses and dungeons keep their framing. The original 16:9 framing is one option away. - Start screen: play vanilla or any randomizer seed, set up your own extracted game files, import fonts.

- Switch games use fonts built into the Switch operating system for some text. Sensible replacements are used by default, but you may optionally set up the Switch fonts for an authentic look. Switch fonts are Nintendo IP; you must provide them from your own hardware. - In-game overlay menu (F1, or Minus + Plus on a controller). - Switch between vanilla and any randomizer seed without restarting the app. - Keyboard and controller support, with every button and key remappable (Controls tab / start screen Settings > Controls; menus keep a fixed layout, so a remap can never lock you out).

部署要求

需要自备合法获得的游戏文件（v1.0.0，无更新），首次启动需联网构建。平台要求：macOS仅Apple Silicon；Windows 10+ x86-64需AVX2和Vulkan 1.3；Linux x86-64需AVX2和Vulkan 1.3，aarch64为实验性。构建需要Python 3.12等环境。

查看 README 依据

> in the controversy in relation to this project. You may simply ignore this project and its code. > As with anything on the internet, you run the code at your own discretion. **LAS Recomp** is a static recompilation of *The Legend of Zelda: Link's Awakening* (Nintendo Switch, 2019) into a native Windows, macOS and Linux application. > [!NOTE] > Currently supported platforms: > - macOS - Apple Silicon only, Metal graphics backend + MetalFX > - Windows - x86-64 only, Vulkan graphics backend > - Linux - x86-64, Vulkan graphics backend (AppImage)

> - Linux aarch64 (ARM) - **experimental**: built but untested on real hardware; reports welcome > ([docs/linux.md](docs/linux.md) lists what to include)  > [!NOTE] > **No game files are included.** LAS Recomp needs your own legally obtained copy of the extracted game files of > *Link's Awakening* **v1.0.0**, with no updates applied. When setting up, choose a folder that contains the `exefs`

`build/LAS Recomp.app` (macOS 15+, Apple Silicon) and `make dmg` -> `build/dist/LAS Recomp-<version>-macOS.dmg`. ### Windows Requirements: Windows 10+ x86-64, a CPU with AVX2 and a GPU with Vulkan 1.3. More detail in [docs/BUILD-windows.md](docs/BUILD-windows.md). 1. One-time setup, in PowerShell from the repo root: `powershell -ExecutionPolicy Bypass -File tools\setup_windows.ps1`. It installs MSYS2 (UCRT64: clang, make, SDL3, FFmpeg, Vulkan, shaderc), Python 3.12 for the tools and the randomizer (`third_party\LAS-Randomizer\venv`) and switches the clone to LF line endings.

已知限制

目前为beta版，可能存在bug、崩溃，随机种子可能无解（尤其是地牢房间洗牌模式），宽屏和超宽屏仍有图形问题。部分迷你Boss尚未包含在敌人随机化中。

查看 README 依据

This is a beta release. That means bugs are likely, crashes could occur, randomizer seeds could possibly be unsolvable (dungeon room shuffle modes are especially experimental at this point) and some graphics issues remain (especially in wide and ultrawide aspect ratios). This is a work in progress, hence the beta designation. To report a bug or a possible randomizer logic issue, open a [GitHub issue](https://github.com/peiikai/LASRecomp/issues) - see [CONTRIBUTING.md](CONTRIBUTING.md#reporting-bugs) for what to include. ### Known issues

- Hookshot anything - the hookshot latches onto any wall or object, not just hookshot targets (in logic where enabled). - Environment Randomizer - randomizes in-game environmental effects. - Enemy Randomizer - shuffles overworld enemies, optionally including mini-bosses. Not all mini-bosses are included yet; more will be added as they're made to work outside their dungeons. - Music Randomizer. - Escape Bottle - every seed gives you this gold bottle from the start (it replaces one bottle in the pool). Use it to