LumaNX
Interface graphique macOS pour NXnative : bibliothèque de jeux, préparation et export d'une IPA pour iPhone ou iPad.
LumaNX est une interface SwiftUI pour NXnative sur Mac Apple Silicon. On importe ses fichiers NSP, XCI, NSZ ou XCZ, on prépare le jeu (code, shaders, fichiers d'exécution) puis on le lance depuis la bibliothèque ou on exporte une IPA non signée pour iPhone et iPad.
Les jeux Switch 2 sont pris en charge sur Mac à partir d'un dossier déchiffré. L'application ne contient ni jeu ni clé.
Last updated:
Architecture
Mac OS X - macOS
Apple Silicon
Download and links
- Download LumaNX
- Source code 311 GitHub stars
- License : MIT
Version history
0.4.2
- Mise à jour majeure du moteur avec un snapshot nxnative passant de b2d46b86d03f4b03afe11ea61c67cdf00d7a5345 à 38521863e191431f61f6a465eb1aed66078975c0, incluant corrections graphiques, shaders, sauvegardes, audio et runtime.
- Améliorations graphiques et runtime : préchauffage des pipelines mesh/task, corrections des archives de pipeline et de résidence des textures, support étendu du contrôleur Switch 2 et fixes pour Ocarina of Time.
- Correction de la synchronisation quotidienne : compatibilité avec les interfaces d'extraction nxnative anciennes et nouvelles, reconnaissance du runner GitHub VirtualMac ARM pour les sauvegardes, désactivation explicite de NativeAOT.
- Build macOS : fichier .dmg signé ad-hoc pour Apple Silicon uniquement, nécessite macOS 26+, et conserve les données utilisateur (saves, profils) lors de la mise à jour.
- Prérequis techniques : préparation des jeux exige Xcode complet avec Metal, export IPA nécessite aussi iOS platform et XcodeGen.
LumaNX 0.4.2
Changes
- Large engine snapshot update. The bundled nxnative snapshot moves from upstream b2d46b86d03f4b03afe11ea61c67cdf00d7a5345 to 38521863e191431f61f6a465eb1aed66078975c0, retaining LumaNX's controller and SDK compatibility policy. The update refreshes registered game profiles and brings upstream rendering, shader-pipeline, packing, save-sync, audio/video and runtime fixes. Games should be prepared again after updating so their runtime and shader libraries match the new snapshot.
- Graphics and runtime improvements from upstream. The snapshot includes task/mesh pipeline prewarming, pipeline-archive and texture-residency fixes, broader Switch 2 controller support, and multiple Ocarina of Time rendering/performance fixes. These are upstream changes carried by the bundled engine; LumaNX's release validation covers builds and fixtures, not complete gameplay sessions.
- Switch 2 controller test coverage. The native controller harness now covers the additional HID service calls made by the current Switch 2 controller path, keeping those symbols verified without changing production controller behavior.
- Daily engine synchronization repaired. LumaNX now tolerates both old and new nxnative extraction interfaces, accepts GitHub's
VirtualMacARM runner identity in the upstream save-sync fixture, and explicitly disables NativeAOT when rebuilding LumaNX's private metadata-reader adapter. The tested candidate can again pass the complete synchronization pipeline before being committed.
Installation and validation
Download LumaNX-0.4.2-arm64.dmg and verify the SHA-256 shown on the GitHub release. Quit the app and active tasks before replacing the application. The application identifier and existing libraries, saves and settings are retained.
Requires Apple Silicon and macOS 26+. Uses ad-hoc signing and is not notarized. Game preparation requires full Xcode with Metal; IPA export also requires the iOS platform and XcodeGen.
The release workflow runs Python and Swift regression tests, native controller and engine checks, Metal diagnostics, unsigned synthetic iOS packaging, portable runtime bundling, app signing, DMG/source audits and runtime relocation before publishing the DMG. These checks do not establish full-game or iOS-device compatibility: real gameplay sessions and iOS devices remain pending acceptance. NUP and directory imports rely on the registered game profiles and do not generate temporary ones. No games, keys, firmware or player data are included; bundled dependencies retain their licenses.
中文说明
- 大幅同步引擎快照。 内置 nxnative 从上游 b2d46b86d03f4b03afe11ea61c67cdf00d7a5345 更新至 38521863e191431f61f6a465eb1aed66078975c0,并保留 LumaNX 的手柄与 SDK 兼容策略。本次更新刷新已登记游戏配置,并带入上游渲染、着色器流水线、打包、存档同步、音视频和运行时修复。升级后应重新准备游戏,使运行时和着色器库与新快照一致。
- 上游图形与运行时改进。 新快照包含 task/mesh 流水线预热、流水线归档与纹理驻留修复、更完整的 Switch 2 手柄支持,以及多项《塞尔达传说 时之笛》渲染与性能修复。这些能力来自随包引擎;LumaNX 的发布验证覆盖构建与测试夹具,不等同于完整游戏流程验收。
- Switch 2 手柄测试覆盖。 原生手柄测试桩现已覆盖当前 Switch 2 手柄路径新增的 HID 服务调用,在不改变生产手柄行为的前提下持续验证相关符号。
- 修复每日引擎同步。 LumaNX 现可同时适配 nxnative 新旧提取接口,允许上游存档同步夹具识别 GitHub ARM runner 的
VirtualMac设备名,并在重建 LumaNX 私有元数据读取适配器时显式关闭 NativeAOT。候选引擎恢复为通过完整同步流水线后才会提交。
下载 LumaNX-0.4.2-arm64.dmg,按 GitHub Release 页面给出的 SHA-256 校验,退出应用及任务后替换应用。应用标识、现有游戏库、存档与设置保持兼容。
要求 Apple Silicon、macOS 26 及以上;采用临时签名,尚未公证。准备游戏需完整 Xcode 与 Metal,导出 IPA 另需 iOS 平台与 XcodeGen。
标签流水线在发布前完成 Python/Swift 回归、原生手柄与引擎检查、Metal 诊断、合成未签名 iOS 包、运行库封装、应用签名、DMG/源码审计及搬移校验。这些检查不代表完整游戏或 iOS 真机验收:完整游戏流程与 iOS 设备仍待验收;NUP 与目录导入仅使用已登记配置,不自动生成临时配置。不附带游戏、密钥、固件或玩家数据,内置依赖保留各自许可。
DMG SHA-256
2b7caef1ac84e14883afc570f461f62ab4b43965314c0ceb1273087afb9e198a LumaNX-0.4.2-arm64.dmg
0.4.1
- Nouveaux profils de jeu enregistrés : ajout d’ŌKAMI HD, Sonic Superstars et Minecraft Dungeons II, avec rafraîchissement des tables de shaders pour certains profils existants.
- Détection des fichiers de jeu corrompus : blocage précoce des installations si les fichiers ne correspondent pas à leur extension (ex. .zs non-zstd), avec une liste d'erreurs claire.
- Optimisation des bibliothèques de shaders : stockage en un seul fichier image (b-.img) au lieu d’un répertoire, réduisant la taille des caches et accélérant les builds incrémentiels.
- Amélioration de la synchronisation quotidienne : stub pour le service HID de l’applet de contrôleur, évitant des erreurs dans les vérifications de lien sans modifier le code moteur.
- Build exclusif pour Apple Silicon : publication d’un .dmg signé ad-hoc, compatible uniquement avec macOS 26+ et processeurs ARM64 (M1/M2/M3).
LumaNX 0.4.1
Changes
- Engine snapshot sync. The bundled nxnative snapshot moves from upstream 2eb71820aece65dbc30dd17df5483a20483eac0d to b2d46b86d03f4b03afe11ea61c67cdf00d7a5345, keeping the local gamepad and SDK compatibility patches. The translator binaries are rebuilt with it (a new shader-chain stamp), and Mac / iOS games rebuild their shader libraries on first launch after the update.
- Three more registered games. ŌKAMI HD, Sonic Superstars and Minecraft Dungeons II join the registered profiles, and several existing profiles gain refreshed shader tables.
- Damaged game files stop the build early. Files whose bytes do not start as their names promise — a
.zstexture that is not a zstd stream, as found in a damaged Ocarina of Time copy that pegged the CPU in the background loader — now stop packing with a clear list instead of producing a broken install;--allow-damagedpacks them as they are. The check is cached beside the image, so an unchanged game is not read again. - Shader-library images. Shader libraries are now stored as single images (
b-.img) instead of folder trees, shrinking game caches and speeding up incremental runs; bug reports and regression tooling read both layouts. - Progress and reporting. Shader-build progress is reported from the build tool itself (per-stage counts instead of file watching), and audio, video-codec, display-history and probe fixes land with the snapshot alongside a broadened engine test suite.
- Daily-sync robustness. The native input harness now stubs the controller applet's HID service call, so the daily engine sync's link check stays green without touching production engine code.
Installation and validation
Download LumaNX-0.4.1-arm64.dmg and verify the SHA-256 below. Quit the app and active tasks before replacing the application. The application identifier and existing libraries, saves and settings are retained.
Requires Apple Silicon and macOS 26+. Uses ad-hoc signing and is not notarized. Game preparation requires full Xcode with Metal; IPA export also requires the iOS platform and XcodeGen.
The release workflow runs Python and Swift regression tests, native controller and engine checks, Metal diagnostics, unsigned synthetic iOS packaging, portable runtime bundling, app signing, DMG/source audits and runtime relocation before publishing the DMG. These checks do not establish full-game or iOS-device compatibility: real gameplay sessions and iOS devices remain pending acceptance. NUP and directory imports rely on the registered game profiles and do not generate temporary ones. No games, keys, firmware or player data are included; bundled dependencies retain their licenses.
中文说明
- 引擎快照同步。 内置 nxnative 从上游 2eb71820aece65dbc30dd17df5483a20483eac0d 同步至 b2d46b86d03f4b03afe11ea61c67cdf00d7a5345,保留本地手柄与 SDK 兼容补丁。翻译器二进制随之重建(新的着色器链印记),更新后 Mac / iOS 游戏首次启动会重建着色器库。
- 再登记三款游戏。 ŌKAMI HD(大神 HD)、Sonic Superstars(索尼克 超级群星)与 Minecraft Dungeons II(我的世界 地下城 2)加入已登记配置,多款既有配置的着色器表同步刷新。
- 损坏游戏文件提前拦截。 文件字节与其扩展名承诺不符——例如不是 zstd 流的
.zs贴图(一份损坏的《塞尔达传说 时之笛》正因此导致后台加载器 CPU 占用异常)——现在会在打包时以清晰清单中止,而不再产出坏安装包;--allow-damaged可按原样打包。检查结果缓存于镜像旁,未变更的游戏不会重复读取。 - 着色器库镜像化。 着色器库改为单一镜像文件(
b-.img)而非目录树,游戏缓存更小、增量运行更快;问题报告与回归工具同时兼容两种布局。 - 进度与修复。 着色器构建进度改由构建工具自身上报(按阶段计数,替代文件监视);快照同时带来音频、视频解码、显示历史与探针修复,并扩充引擎测试覆盖。
- 每日同步更稳。 原生输入测试为控制器弹窗的 HID 服务调用补充测试桩,每日引擎同步的链接检查保持通过,生产引擎代码零改动。
下载 LumaNX-0.4.1-arm64.dmg,按下方 SHA-256 校验,退出应用及任务后替换应用。应用标识、现有游戏库、存档与设置保持兼容。
要求 Apple Silicon、macOS 26 及以上;采用临时签名,尚未公证。准备游戏需完整 Xcode 与 Metal,导出 IPA 另需 iOS 平台与 XcodeGen。
标签流水线在发布前完成 Python/Swift 回归、原生手柄与引擎检查、Metal 诊断、合成未签名 iOS 包、运行库封装、应用签名、DMG/源码审计及搬移校验。这些检查不代表完整游戏或 iOS 真机验收:完整游戏流程与 iOS 设备仍待验收;NUP 与目录导入仅使用已登记配置,不自动生成临时配置。不附带游戏、密钥、固件或玩家数据,内置依赖保留各自许可。
DMG SHA-256
b18e4b7df271c01cf4251c4722b287e03ecb623e3dc49d95937cf883e9bbf7ea LumaNX-0.4.1-arm64.dmg
0.4.0
- Import des fichiers .nup de la Nintendo Switch 2 sans clé, avec gestion des mises à jour et DLC via un système centralisé.
- Copie et vérification sécurisée des fichiers en une seule passe, avec restauration automatique en cas d’échec.
- Prise en charge des images RomFS.img et des shaders DLC pour macOS, incluant leur intégration dans les packages IPA.
- Synchronisation du moteur nxnative avec une version spécifique et vérification systématique de zbic==1.0.1.post1.
- Build .dmg pour Apple Silicon uniquement, compatible avec macOS 13.5 (version 26) et au-delà.
- Requiert Xcode complet (avec Metal) pour la préparation des jeux et XcodeGen pour l’export IPA.
LumaNX 0.4.0
Changes
- Import Switch 2 NUP packages. Switch 2
.nupcontainers are now imported without keys and prepared like directory sources, using the registered nxnative game profiles and versions. The base, update and DLC payloads inside the container are read and verified against a single managed copy; full standalone updates and empty-base placeholders per the upstream layout are supported, and the name, version and cover from the control data are shown. NUP sources cannot be mixed with other sources, and Switch 2 games keep IPA export disabled. - One-pass copy with safer catalogue updates. The original file is copied and hashed in a single pass, then every payload — including versions and DLC not selected to run — is verified from the staged copy. A failed or cancelled save restores the existing cover and catalogue, and temporary files never outlive the attempt. Update records must identify the same application family, control data is size-bounded before parsing, and covers are accepted only with JPEG/PNG magic and sane sizes; invalid optional metadata falls back to the registered profile defaults.
- Resource images and DLC shaders. Shader processing, Mac installation and launch now cover
RomFS.imgand DLC images, and IPA packaging works for regular packages. Incremental preparation records the resource-image and DLC-shader dependencies, keeps cancellation state, and preserves the last good run version on failure. - Engine sync and pinned ZBIC. The bundled nxnative snapshot is synced to upstream 2eb71820aece65dbc30dd17df5483a20483eac0d while keeping the local gamepad and SDK compatibility patches. The bundled
zbic==1.0.1.post1runs a decode check on every build, and the runtime package retains the original sources, fixed hash and license. - Updated documentation. Bilingual import hints, usage and engine-modification docs, acceptance records, and broader release checks that NUP player files never enter distributed archives.
Installation and validation
Download LumaNX-0.4.0-arm64.dmg and verify the SHA-256 below. Quit the app and active tasks before replacing the application. The application identifier and existing libraries, saves and settings are retained.
Requires Apple Silicon and macOS 26+. Uses ad-hoc signing and is not notarized. Game preparation requires full Xcode with Metal; IPA export also requires the iOS platform and XcodeGen.
The release workflow runs Python and Swift regression tests, native controller and engine checks, Metal diagnostics, unsigned synthetic iOS packaging, portable runtime bundling, app signing, DMG/source audits and runtime relocation before publishing the DMG. These checks do not establish full-game or iOS-device compatibility: real gameplay sessions and iOS devices remain pending acceptance. NUP and directory imports rely on the registered game profiles and do not generate temporary ones. No games, keys, firmware or player data are included; bundled dependencies retain their licenses.
中文说明
- 支持导入 Switch 2 NUP 封包。
.nup文件现在可免密钥导入,按已登记的 nxnative 游戏配置与版本像目录来源一样准备。容器内的本体、更新与 DLC 读取校验后共用一份托管副本;支持上游规定的完整独立更新与空本体占位,并读取控制数据中的名称、版本与封面。NUP 不能与其他来源混用,Switch 2 继续禁用 IPA 导出。 - 单遍复制,目录更新更安全。 原文件单遍复制并计算哈希,再从暂存副本校验每个 payload(含未选用的版本与 DLC)。保存失败或取消时恢复已有封面与目录,临时文件不遗留。更新记录必须属于同一应用家族,控制数据先限长再解析,封面只接受 JPEG/PNG 魔数与合理大小;无效可选元数据回退到登记配置默认值。
- 资源镜像与 DLC 着色器。
RomFS.img与 DLC 镜像接入着色器处理、Mac 安装与启动,普通游戏包支持 IPA 打包。增量准备记录资源镜像与 DLC 着色器依赖,保留取消状态,失败时保留最近一次成功运行版本。 - 引擎同步与固定 ZBIC。 内置 nxnative 同步至上游 2eb71820aece65dbc30dd17df5483a20483eac0d,保留本地手柄与 SDK 兼容补丁;内置
zbic==1.0.1.post1每次构建执行解码检查,运行包保留原版源码、固定哈希与许可证。 - 更新文档。 中英文导入提示、使用与引擎修改文档、验收记录,并扩展发行包对 NUP 玩家文件的排除检查。
下载 LumaNX-0.4.0-arm64.dmg,按下方 SHA-256 校验,退出应用及任务后替换应用。应用标识、现有游戏库、存档与设置保持兼容。
要求 Apple Silicon、macOS 26 及以上;采用临时签名,尚未公证。准备游戏需完整 Xcode 与 Metal,导出 IPA 另需 iOS 平台与 XcodeGen。
标签流水线在发布前完成 Python/Swift 回归、原生手柄与引擎检查、Metal 诊断、合成未签名 iOS 包、运行库封装、应用签名、DMG/源码审计及搬移校验。这些检查不代表完整游戏或 iOS 真机验收:完整游戏流程与 iOS 设备仍待验收;NUP 与目录导入仅使用已登记配置,不自动生成临时配置。不附带游戏、密钥、固件或玩家数据,内置依赖保留各自许可。
DMG SHA-256
d08641282d9d91dae02f4901f81887447528d6aeea8e1648ee918ce0a1794e2e LumaNX-0.4.0-arm64.dmg
0.3.0
- Ajout du support pour l'import de dossiers Switch 2 décompressés (Mac uniquement), incluant base/exefs, base/romfs et DLC, avec validation des métadonnées avant intégration.
- Correction des boutons du contrôleur Switch Pro : alignement sur les labels officiels d’Apple GameController (plus de doublons A/B ou X/Y inversés).
- Mise à jour des documents en français et chinois, incluant un guide dédié aux builds incrémentaux et aux modifications du moteur.
- macOS : build exclusive pour Apple Silicon (M1/M2/M3), nécessite macOS 13.4+ (version 26), et un Xcode complet (Metal + iOS SDK pour l’export IPA).
- Processus de validation renforcé : tests automatisés (Python/Swift, Metal, contrôleurs, packaging), mais sans garantie de compatibilité complète avec les jeux ou iOS.
LumaNX 0.3.0
Changes
- Import Switch 2 unpacked directories. Folders containing
base/exefsandbase/romfs— along with chosen update and DLC directories — are added without keys; scanning a parent folder finds nested games too. The worker validates the NPDM program ID, NSO build IDs, paths and content before copying into the library, then follows the usual Mac preparation, launch, cleanup and rollback flow. Directory sources are Mac-only in this release. - Incremental preparation. Unpacking, DLC, version configuration, rewrite, capture/decode, shaders and the host build each record their own input dependencies. Engine updates no longer discard the whole build cache: a controller-header change refreshes only the host stage, unchanged stages reuse the verified run version and IPA, and a new IPA export destination is validated and copied from the existing package. Existing caches continue when the engine snapshot and dependency sources verify; corrupt, failed or cancelled preparations never overwrite the last good run version or saves.
- Corrected Switch Pro controller buttons. The runtime and input-test page now follow the printed labels Apple's GameController reports, removing the double A/B and X/Y swap on Nintendo Switch Pro Controllers. Recognition for pads exposed as generic HID devices is planned next.
- Refreshed documentation. Bilingual usage and development docs, a new incremental-build guide and updated engine-modification notes.
Installation and validation
Download LumaNX-0.3.0-arm64.dmg and verify the SHA-256 below. Quit the app and active tasks before replacing the application. The application identifier and existing libraries, saves and settings are retained.
Requires Apple Silicon and macOS 26+. Uses ad-hoc signing and is not notarized. Game preparation requires full Xcode with Metal; IPA export also requires the iOS platform and XcodeGen.
The release workflow runs Python and Swift regression tests, native controller and engine checks, Metal diagnostics, unsigned synthetic iOS packaging, portable runtime bundling, app signing, DMG/source audits and runtime relocation before publishing the DMG. These checks do not establish full-game or iOS-device compatibility: real Switch Pro hardware, complete gameplay sessions and iOS devices remain pending acceptance, and the bundled engine does not implement DM_INPUT_CONFIG yet, so custom mappings are saved but not applied by the engine. No games, keys, firmware or player data are included; bundled dependencies retain their licenses.
中文说明
- 支持导入 Switch 2 已解包目录。 含
base/exefs与base/romfs的目录,以及选定的更新与 DLC 目录,可在无密钥情况下加入游戏库;扫描父目录也能找到嵌套的游戏目录。工作进程校验 NPDM 程序 ID、NSO 构建 ID、路径与内容后复制入库,沿用常规的 Mac 准备、启动、清理与回滚流程。本版本目录来源仅限 Mac。 - 增量准备。 解包、DLC、版本配置、重写、采集/解码、着色器与宿主各阶段记录独立输入依赖:引擎更新不再整包重建缓存,仅改手柄头文件时只刷新宿主阶段;未变化阶段复用已验证的运行版本与 IPA,新的 IPA 导出位置只校验并复制已有包。引擎快照与依赖来源可验证时旧缓存接续使用;损坏、失败或取消的准备不会覆盖最近一次成功的运行版本与存档。
- 修正 Switch Pro 手柄按键。 运行时与输入测试页统一按 Apple GameController 报告的印刷标签处理,消除任天堂 Switch Pro 手柄 A/B、X/Y 的重复交换;以通用 HID 暴露的手柄识别将在后续版本跟进。
- 刷新文档。 中英文使用与开发文档、新增增量构建指南及引擎修改说明。
下载 LumaNX-0.3.0-arm64.dmg,按下方 SHA-256 校验,退出应用及任务后替换应用。应用标识、现有游戏库、存档与设置保持兼容。
要求 Apple Silicon、macOS 26 及以上;采用临时签名,尚未公证。准备游戏需完整 Xcode 与 Metal,导出 IPA 另需 iOS 平台与 XcodeGen。
标签流水线在发布前完成 Python/Swift 回归、原生手柄与引擎检查、Metal 诊断、合成未签名 iOS 包、运行库封装、应用签名、DMG/源码审计及搬移校验。这些检查不代表完整游戏或 iOS 真机验收:真实 Switch Pro 手柄、完整游戏流程与 iOS 设备仍待验收;当前内置引擎尚未实现 DM_INPUT_CONFIG,自定义映射仅保存、尚未由引擎应用。不附带游戏、密钥、固件或玩家数据,内置依赖保留各自许可。
DMG SHA-256
30f25b7b8dfeb675d3241ef4076eb6b90d40495169d195bdc174ab61c4b89c9c LumaNX-0.3.0-arm64.dmg
0.2.20
- Mise à jour complète de l’engine intégré avec des corrections sur les extractions RomFS et les shaders depuis la version précédente.
- Synchronisation quotidienne de l’engine rétablie, incluant des validations renforcées des ancres de patch et des mappings de contrôleurs partagés.
- Compatibilité étendue pour les extractions via transmission de l’ID d’application aux extracteurs récents, tout en gardant le support des signatures anciennes.
- Documentation mise à jour avec des captures d’interface actuelles et des détails sur le cycle de publication hebdomadaire et la compilation macOS.
- Build officiel pour macOS sous forme de .dmg (ARM64) nécessitant macOS 26+ et Apple Silicon, avec signature ad-hoc non notarisée.
- Préparation des jeux exige Xcode complet avec Metal et support iOS pour les exports IPA.
LumaNX 0.2.20
Changes
- Updated bundled engine. Includes nxnative
cd859c38a8f8890ddbb57a23d6f45e23ba9e6651, with upstream extraction, RomFS and shader preparation updates since 0.2.19. Re-prepare existing games to apply engine changes. - Restored daily engine synchronization. Sync patches now support upstream shared controller mappings and continue to validate unique patch anchors. The imported engine retains LumaNX's native controller button policy.
- Updated extraction compatibility. The worker passes the selected application ID to newer upstream extractors, retains support for older signatures, and adapts Application/Patch content selection in the bundled reader.
- Refreshed documentation. Bilingual READMEs include current interface previews, daily engine synchronization, weekly release cadence and the supported macOS source build sequence.
Installation and validation
Download LumaNX-0.2.20-arm64.dmg and verify the SHA-256 below. Quit the app and active tasks before replacing the application. The application identifier and existing libraries, saves and settings are retained.
Requires Apple Silicon and macOS 26+. Uses ad-hoc signing and is not notarized. Game preparation requires full Xcode with Metal; IPA export also requires the iOS platform and XcodeGen.
The release workflow runs Python and Swift regression tests, native controller and engine checks, Metal diagnostics, unsigned synthetic iOS packaging, portable runtime bundling, app signing, DMG/source audits and runtime relocation before publishing the DMG. These checks do not establish full-game or iOS-device compatibility. No games, keys, firmware or player data are included; bundled dependencies retain their licenses.
中文说明
- 更新内置引擎。 包含 nxnative
cd859c38a8f8890ddbb57a23d6f45e23ba9e6651,汇总 0.2.19 之后上游的解包、RomFS 与着色器准备更新。已有游戏需要重新准备才能应用引擎变更。 - 恢复每日引擎同步。 同步补丁兼容上游共享手柄映射,并继续严格校验补丁锚点;导入引擎保留 LumaNX 的原生手柄按键策略。
- 适配新版解包接口。 工作进程向新版上游解包器传入选定应用 ID,同时兼容旧签名,并适配内置读取器的 Application/Patch 内容筛选。
- 刷新使用与编译文档。 中英文 README 包含当前界面预览、每日引擎同步、每周发布节奏,以及受支持的 macOS 源码编译顺序。
下载 LumaNX-0.2.20-arm64.dmg,按下方 SHA-256 校验,退出应用及任务后替换应用。应用标识、现有游戏库、存档与设置保持兼容。
要求 Apple Silicon、macOS 26 及以上;采用临时签名,尚未公证。准备游戏需完整 Xcode 与 Metal,导出 IPA 另需 iOS 平台与 XcodeGen。
标签流水线在发布前完成 Python/Swift 回归、原生手柄与引擎检查、Metal 诊断、合成未签名 iOS 包、运行库封装、应用签名、DMG/源码审计及搬移校验。这些检查不代表完整游戏或 iOS 真机验收。不附带游戏、密钥、固件或玩家数据,内置依赖保留各自许可。
DMG SHA-256
19bba1ac7297f14ea544ff18e22ed1f26b6a6a31c46d0b1ce0d234f6c66c5ac4 LumaNX-0.2.20-arm64.dmg
0.2.19
- Ajout du support pour Subnautica: Below Zero (010014C011146000) via une mise à jour du moteur embarqué, testé sur Apple Silicon avec 30 fps et une panne audio ponctuelle.
- Extension du décodage des shaders enregistrés pour les bundles Criterion bnd2 (ex. : Need for Speed: Hot Pursuit Remastered) et mise à jour des tables de shaders pour 211 profils de jeu.
- Correction de la détection des conflits de formatage dans l’interface phone-motion (erreur claire au lieu d’un silence).
- macOS : build .dmg exclusive pour Apple Silicon (M1/M2/M3), compatible avec macOS 13 (26+) et nécessitant Xcode + Metal pour la préparation des jeux.
- Processus de validation étendu (tests Python/Swift, vérifications Metal, packaging iOS non signé, signature ad-hoc et audits de sécurité).
LumaNX 0.2.19
Changes
- Updated bundled engine. Includes nxnative
710559cf53d2b9037f48b44f515e940f71b51f2b, which adds Subnautica: Below Zero (010014C011146000) — tested on Apple Silicon Mac at 30 fps through the title, menu, new Survival game, hangar opening and the crash site; upstream notes one audio-device stall at the landing — and extends registered-shader decoding: Criterionbnd2bundles (Need for Speed: Hot Pursuit Remastered reads its ~2,112 GLSLC outputs fromSHADERS.BNDL) and refreshed per-game shader tables across 211 profiles. - Decoders prepared for registered shader builds. The conversion worker builds the game decoders a profile registers for its shader toolchain, with regression tests for repeated profile derivation.
- Stricter daily-sync patch anchors. The sync's SDK compatibility patch now fails loudly when upstream reformats the guarded phone-motion interface (previously it silently skipped), and worker import search paths are deduplicated across repeated derivations.
Installation and validation
Download LumaNX-0.2.19-arm64.dmg and verify the SHA-256 below. Quit the app and active tasks before replacing the application. The application identifier and existing libraries, saves and settings are retained.
Requires Apple Silicon and macOS 26+. Uses ad-hoc signing and is not notarized. Game preparation requires full Xcode with Metal; IPA export also requires the iOS platform and XcodeGen.
The release workflow runs Python and Swift regression tests, native controller and engine checks, Metal diagnostics, unsigned synthetic iOS packaging, portable runtime bundling, app signing, DMG/source audits and runtime relocation before publishing the DMG. These checks do not establish full-game or iOS-device compatibility. No games, keys, firmware or player data are included; bundled dependencies retain their licenses.
中文说明
- 同步内置引擎。 包含 nxnative
710559cf53d2b9037f48b44f515e940f71b51f2b:新增 Subnautica: Below Zero(010014C011146000),在 Apple Silicon Mac 上以 30 fps 通过标题、菜单、新生存档、机库开场与坠机点实测;上游记录降落阶段有一次音频设备停顿。注册着色器解码扩展:Criterionbnd2包(Need for Speed: Hot Pursuit Remastered 从SHADERS.BNDL读取约 2,112 个 GLSLC 输出),并刷新 211 个游戏档案的着色器表。 - 转换工作进程按档案构建注册的解码器。 工作进程为档案注册的着色器工具链构建所需的游戏解码器,重复档案推导带回归测试。
- 每日同步补丁锚点更严格。 同步的 SDK 兼容补丁在上游改写受保护接口的排版时会明确报错(此前会静默跳过),工作进程的导入搜索路径在重复推导下去重。
下载 LumaNX-0.2.19-arm64.dmg,按下方 SHA-256 校验,退出应用及任务后替换应用。应用标识、现有游戏库、存档与设置保持兼容。
要求 Apple Silicon、macOS 26 及以上;采用临时签名,尚未公证。准备游戏需完整 Xcode 与 Metal,导出 IPA 另需 iOS 平台与 XcodeGen。
标签流水线在发布前完成 Python/Swift 回归、原生手柄与引擎检查、Metal 诊断、合成未签名 iOS 包、运行库封装、应用签名、DMG/源码审计及搬移校验。这些检查不代表完整游戏或 iOS 真机验收。不附带游戏、密钥、固件或玩家数据,内置依赖保留各自许可。
DMG SHA-256
c733449a464f3e1781f2b04846a906abed267699353b22d1f0e40fd817b78cb3 LumaNX-0.2.19-arm64.dmg
0.2.18
- Interface "Liquid Glass" unifiée et simplifiée : pages de la bibliothèque, conversion et paramètres partagent un ensemble de contrôles, avec suppression du bandeau de préparation et regroupement des éléments.
- Conversion consolidée en une seule ligne : format/sortie/démarrage alignés, formats d'entrée dynamiques, outils avancés (import/réinitialisation) regroupés dans un menu.
- Suppression des enregistrements de tâches terminées : bouton dédié préservant les logs et fichiers générés, protection des tâches en cours ou annulées.
- Interface de configuration rationalisée : vérifications environnementales regroupées, suppression du champ manuel pour Xcode, ajout d’un panneau dédié aux mappings périphériques.
- Version macOS minimale relevée à 26+, exigence de Xcode complet avec Metal pour la préparation des jeux et XcodeGen pour les exports IPA.
- Build ARM64 (Apple Silicon) uniquement, signature ad-hoc non notarisée, vérification SHA-256 obligatoire avant installation.
LumaNX 0.2.18
Changes
- A calmer Liquid Glass interface. The game library, conversion and settings pages now share one set of glass controls. The library drops the preparation-flow banner and places library counts and search on one capsule row; game details are expanded by default above Manage game, with tighter version and import-content layout.
- Conversion on one row. Output format, output location and the start button share a row. Supported input formats follow the selected operation; key import and recheck move into a More tools menu, and prompts appear only when a prerequisite is missing.
- Delete finished task records. Task cards are narrower, diagnostics are collapsed by default, and details, log and copy actions sit on one row. A new Delete button removes only the record of a finished task — logs and generated files are kept — and stale catalog responses or late events cannot restore a deleted record. Running, queued or cancelling tasks stay protected.
- Settings in one layer. Environment checks flatten to a single expandable section, the manual Xcode path field is removed (pick Xcode.app or run Recheck instead), the first-run wizard sits next to recheck, keyboard/mouse and controller mapping get their own panel, and About plus open-source licenses are shown directly.
- Reduced-transparency fallback preserved for every new glass surface, and all new wording ships with English translations.
- Updated bundled engine. Includes nxnative
8325eefbc68a935c5f684d4fbdff571e2540b4b4, with worker support for the upstream split Metal tool lock interface.
Installation and validation
Download LumaNX-0.2.18-arm64.dmg and verify the SHA-256 below. Quit the app and active tasks before replacing the application. The application identifier and existing libraries, saves and settings are retained.
Requires Apple Silicon and macOS 26+. Uses ad-hoc signing and is not notarized. Game preparation requires full Xcode with Metal; IPA export also requires the iOS platform and XcodeGen.
The release workflow runs Python and Swift regression tests, native controller and engine checks, Metal diagnostics, unsigned synthetic iOS packaging, portable runtime bundling, app signing, DMG/source audits and runtime relocation before publishing the DMG. These checks do not establish full-game or iOS-device compatibility. This release does not include the separate upstream Chinese-language compatibility PR. No games, keys, firmware or player data are included; bundled dependencies retain their licenses.
中文说明
- 更安静的液态玻璃界面。 游戏库、转换和设置页统一一套玻璃控件。游戏库移除准备流程条,统计数量与搜索共用一行胶囊;游戏详情默认展开、置于“管理游戏”上方,版本与导入内容排版更紧凑。
- 转换操作一行完成。 输出格式、输出位置和开始按钮同行排列;按所选操作显示支持的输入格式;密钥导入与重新检查收进“更多工具”菜单,仅在缺少条件时提示。
- 可删除已结束的任务记录。 任务卡片更窄,诊断默认折叠,详情、日志与复制操作同行。新增“删除”按钮仅移除已结束任务的记录,保留日志与生成文件;旧目录响应或迟到事件无法恢复已删除的记录,运行中、排队与取消中的任务仍受保护。
- 设置压成一层。 环境检查合并为单个可展开区域,移除手工 Xcode 路径输入(改用“选择 Xcode.app…”与“重新检查”),首次运行向导与重新检查并列,键鼠与手柄映射独立成栏,关于与开源许可直接展示。
- 保留减少透明度回退。 所有新增玻璃表面在“减少透明度”下保持非透明回退,新增文案均附英文翻译。
- 同步内置引擎。 包含 nxnative
8325eefbc68a935c5f684d4fbdff571e2540b4b4,工作进程已适配上游拆分后的 Metal 工具锁接口。
下载 LumaNX-0.2.18-arm64.dmg,按下方 SHA-256 校验,退出应用及任务后替换应用。应用标识、现有游戏库、存档与设置保持兼容。
要求 Apple Silicon、macOS 26 及以上;采用临时签名,尚未公证。准备游戏需完整 Xcode 与 Metal,导出 IPA 另需 iOS 平台与 XcodeGen。
标签流水线在发布前完成 Python/Swift 回归、原生手柄与引擎检查、Metal 诊断、合成未签名 iOS 包、运行库封装、应用签名、DMG/源码审计及搬移校验。这些检查不代表完整游戏或 iOS 真机验收。本次不包含单独提交给上游的中文语言兼容 PR。不附带游戏、密钥、固件或玩家数据,内置依赖保留各自许可。
DMG SHA-256
678737928b18d5579243231370b044e5db13a30dcd74628619ab0bc77f4384d5 LumaNX-0.2.18-arm64.dmg
0.2.17
- Interface simplifiée du côté jeux : version en cours et bouton de lancement visibles, section Manage game centralisant langues, mappings, sauvegardes et outils de préparation.
- Ajout de raccourcis clavier natifs pour macOS : ⌘Q (quitter), ⌘, (Paramètres), ⌘O (ajouter un jeu), ⇧⌘K (importer des clés), ⌘R (rafraîchir la bibliothèque).
- Initialisation automatique du cache de l’engine et du lecteur sur première utilisation, sans boucle de réessai en cas d’échec.
- Correction du build natif du contrôleur, incluant une mise à jour des dépendances de motion pour le harness de régression.
- Version minimale de macOS requise : macOS 26+, avec exigence de Xcode complet (Metal) pour la préparation des jeux et IPA export.
LumaNX 0.2.17
Changes
-
A quieter game sidebar. Ready games show their running version and launch action. Expand Manage game for launch language, keyboard/mouse/controller mapping, save backups and version rollback, the save folder, preparation, IPA export, and cleanup/removal. Technical identifiers, compatibility and imported content are in a separate collapsed Game details section.
-
Launch language in one row. Choosing a language shows a brief confirmation for the next launch. Repeated changes restart the toast timer; reselecting the current value does not save or notify again.
-
macOS keyboard shortcuts. ⌘Q quits the application, including from setup, mapping and recovery sheets; ⌘, opens Settings; ⌘O adds games; ⇧⌘K imports keys; ⌘R refreshes the library; ⌘1/2/3 switches between Library, File conversion and Preparation tasks.
-
Automatic bundled-engine initialization. The packaged engine and reader initialize their private cache on first use. Manual repair remains under More tools → Repair bundled engine. Failed initialization does not retry in a loop.
-
Native controller build check. Includes the main-branch correction that links the controller regression harness with its upstream motion dependencies.
-
Updated bundled engine. Includes nxnative
76c545320666b07b225ae8e11a8c5d8b46273862and the 0.2.16 extraction/reader compatibility and verified build-copy signing fixes.
Installation and validation
Download LumaNX-0.2.17-arm64.dmg and verify the SHA-256 below. Quit the app and active tasks before replacing the application. The application identifier and existing libraries, saves and settings are retained.
Requires Apple Silicon and macOS 26+. Uses ad-hoc signing and is not notarized. Game preparation requires full Xcode with Metal; IPA export also requires the iOS platform and XcodeGen.
The release workflow runs Python and Swift regression tests, native controller and engine checks, Metal diagnostics, unsigned synthetic iOS packaging, portable runtime bundling, app signing, DMG/source audits and runtime relocation before publishing the DMG. These checks do not establish full-game or iOS-device compatibility. This release does not include the separate upstream Chinese-language compatibility PR. No games, keys, firmware or player data are included; bundled dependencies retain their licenses.
中文说明
-
重新设计游戏详情。 已准备游戏默认显示运行版本和启动按钮;展开“管理游戏”后统一访问启动语言、键鼠与手柄映射、存档备份与版本回滚、存档目录、重新检查并准备、IPA 导出及清理移除。Title ID、兼容性和导入内容收进独立、默认折叠的“游戏详情”。
-
语言选择保持单行。 修改后通过短暂提示告知下次启动生效,连续修改会重新计时;重复选择当前语言不会再次保存或提示。
-
增加键盘快捷键。 ⌘Q 完全退出,包括向导、映射与恢复窗口;⌘, 打开设置;⌘O 添加游戏;⇧⌘K 导入密钥;⌘R 刷新游戏库;⌘1/2/3 切换游戏库、文件转换和准备任务。
-
内置引擎自动初始化。 安装包首次使用时自动初始化私有引擎与读取器缓存,手动修复收进“更多工具 → 修复内置引擎”;初始化失败不会循环重试。
-
修复原生手柄构建检查。 包含主线对手柄回归程序的链接修正,补齐上游运动输入依赖。
-
同步内置引擎。 包含 nxnative
76c545320666b07b225ae8e11a8c5d8b46273862,以及 0.2.16 的提取/读取器兼容和构建副本签名修复。
下载 LumaNX-0.2.17-arm64.dmg,按下方 SHA-256 校验,退出应用及任务后替换应用。应用标识、现有游戏库、存档与设置保持兼容。
要求 Apple Silicon、macOS 26 及以上;采用临时签名,尚未公证。准备游戏需完整 Xcode 与 Metal,导出 IPA 另需 iOS 平台与 XcodeGen。
标签流水线在发布前完成 Python/Swift 回归、原生手柄与引擎检查、Metal 诊断、合成未签名 iOS 包、运行库封装、应用签名、DMG/源码审计及搬移校验。这些检查不代表完整游戏或 iOS 真机验收。本次不包含单独提交给上游的中文语言兼容 PR。不附带游戏、密钥、固件或玩家数据,内置依赖保留各自许可。
DMG SHA-256
049b2ca92ae456b0d0e7bf0f062b9d0dd80e596680ec0f3c29a67cb0add0156c LumaNX-0.2.17-arm64.dmg
0.2.15
- Renommage complet en LumaNX (anciennement LumaDock) avec mise à jour des noms de projet, exécutable et documentation, tout en conservant l’icône originale.
- Mise à jour en place pour les installations existantes : données utilisateur, sauvegardes, bibliothèques et caches sont préservés sans migration manuelle.
- Exclusif Apple Silicon et macOS 26+ requis, avec build .dmg signée ad-hoc (non notarisée) et dépendance à Xcode complet pour la préparation des jeux.
- Pas de changement fonctionnel : le moteur nxnative et le comportement du lanceur restent identiques à la version 0.2.14.
LumaNX 0.2.15
Changes
- Renamed to LumaNX (previously LumaDock). The project, application, executable, packages and documentation now use the LumaNX name, and the bilingual screenshots have been refreshed. The original icon is unchanged.
- In-place upgrade for existing installs. The application identifier (
org.nsmac.launcher), application-support data directory, game libraries, saves, settings and prepared caches are all retained; replacing the old app is enough. New conversion jobs default to aLumaNX Conversionsoutput folder. - No engine or functional changes. The bundled nxnative engine and the launcher's behavior are identical to 0.2.14; this release only changes names, branding and documentation.
Installation and validation
Download LumaNX-0.2.15-arm64.dmg and verify the SHA-256 below. Quit the app and active tasks before replacing it in Applications. Because the bundle identifier is unchanged, LumaNX replaces LumaDock in place; keep your library, saves and successful caches.
Requires Apple Silicon and macOS 26+. Uses ad-hoc signing and is not notarized. Game preparation requires full Xcode with Metal; IPA export also requires the iOS platform and XcodeGen.
This version passed the complete CI workflow before entering main: Python and Swift regression tests, native controller and engine checks, Metal diagnostics, unsigned synthetic iOS packaging, portable runtime bundling, app signing, DMG validation, source audits and runtime relocation. The release tag workflow repeats these checks before publishing this version's DMG.
Validation uses synthetic fixtures and compile checks; it does not establish real-game compatibility, physical-controller behavior, iOS device behavior, power-loss recovery or removable-media disconnect handling. No games, keys, firmware or player data are included. Bundled dependencies retain their licenses.
中文说明
- 更名为 LumaNX(原名 LumaDock)。 项目、应用、可执行文件、安装包与文档统一改用 LumaNX 名称,并更新双语界面截图;原创图标保持不变。
- 老用户原地升级。 应用标识(
org.nsmac.launcher)、应用数据目录、游戏库、存档、设置与已准备缓存全部保留,直接替换旧应用即可;新任务的转换输出默认改用LumaNX Conversions目录。 - 无引擎或功能变更。 内置 nxnative 引擎与启动器行为与 0.2.14 完全一致,本版本仅调整名称、品牌与文档。
下载 LumaNX-0.2.15-arm64.dmg,按下方 SHA-256 校验,退出应用及任务后替换“应用程序”中的副本。应用标识未变化,LumaNX 会原地替换 LumaDock;保留游戏库、存档和成功缓存。
要求 Apple Silicon、macOS 26 及以上;采用临时签名,尚未公证。准备游戏需完整 Xcode 与 Metal,导出 IPA 另需 iOS 平台与 XcodeGen。
本版本已通过完整 CI 后进入 main:包括 Python 与 Swift 回归、原生手柄和引擎检查、Metal 诊断、合成未签名 iOS 包、可搬移运行库封装、应用签名、DMG 校验、源码清单审计及运行库搬移。版本标签流水线将再次完成这些检查后发布当前版本 DMG。
验证使用合成数据和编译检查,不代表真实游戏、实体手柄、iOS 真机、断电或外置盘断开验收。不附带游戏、密钥、固件或玩家数据,内置依赖保留各自许可。
DMG SHA-256
5541c9afad4468d8e9614a9a7bae990a9c7ba791418063a4aae934bc9b1f7865 LumaNX-0.2.15-arm64.dmg
0.2.14
- Mise à jour du moteur embarqué (nxnative) avec correction des flux NVN vertex non alignés sur Metal, séparation des entrées scriptées et physiques des contrôleurs, et détection automatique des layouts audio.
- Retour des fonctionnalités IGN image-atomic et texture-atomic natives, déjà présentes en 0.2.13, pour contourner les limitations de la version 0.2.12 du traducteur.
- Build arm64.dmg pour Apple Silicon uniquement, compatible avec macOS 13 (Ventura) ou supérieur, nécessitant Xcode complet et Metal pour la préparation des jeux.
- Préparation des jeux requise après mise à jour : suppression de l’ancienne version, exécution de "Préparer les outils du moteur" dans les paramètres, puis réinitialisation des jeux concernés.
- Validation interne via tests automatisés (CI) : Python/Swift, contrôleurs natifs, diagnostics Metal, packaging iOS non signé et vérification du DMG, sans test sur données réelles ou matériel physique.
- Signature ad-hoc et non notarisée par Apple, sans inclusion de jeux, clés, firmware ou données utilisateur.
LumaDock 0.2.14
Changes
- Updated bundled engine. Synchronize nxnative from
c484b13cto40e6baede556acd454169ac75b33d1686063f528, retaining LumaDock's native controller mapping. Includes fixes for unaligned NVN vertex streams on Metal, separation of scripted and physical controller input, and audio layout detection, plus updated engine profiles and regression tools. - Shader compatibility follow-up (#20). This build includes the returning IGN image-atomic and native texture-atomic support already present in 0.2.13. These address limitations reported with the older 0.2.12 translator. The latest sync does not itself prove that both shaders reported in #20 now build; the reporter's game data has not been tested here, and unsupported TRAP or predicate semantics can still fail.
Installation and validation
Download LumaDock-0.2.14-arm64.dmg and verify the SHA-256 below. Quit LumaDock and active tasks before replacing the app in Applications. In Settings, select Prepare engine tools, then prepare affected games again to apply the updated engine. Keep your library, saves and successful caches.
Requires Apple Silicon and macOS 26+. Uses ad-hoc signing and is not notarized. Game preparation requires full Xcode with Metal; IPA export also requires the iOS platform and XcodeGen.
The synchronized engine passed the complete CI workflow before entering main: Python and Swift regression tests, native controller and engine checks, Metal diagnostics, unsigned synthetic iOS packaging, portable runtime bundling, app signing, DMG validation, source audits and runtime relocation. The release tag workflow repeats these checks before publishing this version's DMG.
Validation uses synthetic fixtures and compile checks; it does not establish real-game compatibility, physical-controller behavior, iOS device behavior, power-loss recovery or removable-media disconnect handling. No games, keys, firmware or player data are included. Bundled dependencies retain their licenses.
中文说明
- 同步上游引擎。 nxnative 从
c484b13c更新至40e6baede556acd454169ac75b33d1686063f528,保留璃游的原生手柄映射。包含 Metal 上未对齐 NVN 顶点流处理、脚本输入与实体手柄状态分离、音频布局检测等修复,并更新引擎配置和回归工具。 - 跟进着色器兼容性(#20)。 本版本包含 v0.2.13 已引入的带返回值 IGN image atomics 及原生纹理原子操作支持,针对 v0.2.12 旧转换器的相关限制。本次同步不代表已确认 #20 报告的两个着色器均可构建:尚未使用报告者的游戏数据复测,不支持的 TRAP 或谓词语义仍可能失败。
下载 LumaDock-0.2.14-arm64.dmg,按下方 SHA-256 校验,退出应用及任务后替换“应用程序”中的副本。在设置中执行“准备引擎工具”,再重新准备受影响的游戏,以应用新引擎。保留游戏库、存档和成功缓存。
要求 Apple Silicon、macOS 26 及以上;采用临时签名,尚未公证。准备游戏需完整 Xcode 与 Metal,导出 IPA 另需 iOS 平台与 XcodeGen。
同步引擎已通过完整 CI 后进入 main:包括 Python 与 Swift 回归、原生手柄和引擎检查、Metal 诊断、合成未签名 iOS 包、可搬移运行库封装、应用签名、DMG 校验、源码清单审计及运行库搬移。版本标签流水线将再次完成这些检查后发布当前版本 DMG。
验证使用合成数据和编译检查,不代表真实游戏、实体手柄、iOS 真机、断电或外置盘断开验收。不附带游戏、密钥、固件或玩家数据,内置依赖保留各自许可。
DMG SHA-256
a16f4ca32922324a6181264ac70f46b648359da4b599565700a713ff994b89b2 LumaDock-0.2.14-arm64.dmg
0.2.13
- Interface utilitaire réorganisée en cartes Liquid Glass compactes pour les pages Settings, Conversion, Tasks, first-run setup et input mapping, tout en gardant visibles les progrès, échecs et avertissements.
- Outils environnementaux regroupés : actions Settings et setup partagées, Xcode et Metal placés sous More Tools, avec amélioration du contraste et du feedback visuel des boutons.
- Tests de protection des paquets stabilisés via un helper natif compilé localement, remplaçant la copie de binaire macOS pour éviter les instabilités.
- Fichier d'installation LumaDock-0.2.13-arm64.dmg signé ad-hoc, compatible uniquement avec Apple Silicon et macOS 26+.
LumaDock 0.2.13
Changes
- Compact utility pages. Refresh Settings, Conversion, Tasks, first-run setup, input mapping, and save recovery with compact Liquid Glass cards. Keep current progress, failed tasks and warnings visible while collapsing history and advanced details.
- Clearer environment tools. Share the setup and Settings action group, group Xcode and Metal actions under More Tools, and improve button contrast and pressed feedback. Preserve disabled conditions and the Metal uninstall confirmation.
- Reliable package protection tests. Compile a small native helper for the running-app test instead of copying a macOS platform binary. App replacement protection and packaging behavior remain unchanged.
Installation and validation
Download LumaDock-0.2.13-arm64.dmg and verify the SHA-256 below. Quit LumaDock and active tasks before replacing the app in Applications. Requires Apple Silicon and macOS 26+. Uses ad-hoc signing and is not notarized. Game preparation requires full Xcode with Metal; IPA export also requires the iOS platform and XcodeGen.
The reviewed changes passed 65 Swift tests and 192 Python tests locally. Both PR workflows passed their complete build and package checks before merging. The release tag workflow rebuilds and validates the combined source, signatures, distribution boundaries and runtime relocation before publishing the DMG.
Validation uses synthetic fixtures and compile checks; it does not establish real-game compatibility, physical-controller behavior, iOS device behavior, power-loss recovery or removable-media disconnect handling. No games, keys, firmware or player data are included. Bundled dependencies retain their licenses.
中文说明
- 精简辅助页面。 设置、转换、任务、首次运行向导、输入映射及存档恢复统一为紧凑的液态玻璃卡片。当前进度、失败任务及警告保持可见,历史记录和高级信息默认折叠。
- 整理环境工具。 设置与向导共用操作组件,Xcode 和 Metal 操作归入“更多工具”,改善按钮对比度和按下反馈,保留禁用条件及 Metal 卸载确认。
- 稳定打包保护测试。 运行中应用测试改用现场编译的原生助手,避免复制 macOS 系统二进制造成不稳定;应用替换保护及打包行为保持不变。
下载 LumaDock-0.2.13-arm64.dmg,按下方 SHA-256 校验,退出应用及任务后替换“应用程序”中的副本。要求 Apple Silicon、macOS 26 及以上;采用临时签名,尚未公证。准备游戏需完整 Xcode 与 Metal,导出 IPA 另需 iOS 平台与 XcodeGen。
已审查改动在本机通过 65 项 Swift 测试及 192 项 Python 测试;两个 PR 的完整构建与打包 CI 均在合并前通过。标签流水线重新构建并校验合并后的源码、签名、分发边界和运行库搬移后发布 DMG。
验证使用合成数据和编译检查,不代表真实游戏、实体手柄、iOS 真机、断电或外置盘断开验收。不附带游戏、密钥、固件或玩家数据,内置依赖保留各自许可。
DMG SHA-256
163091a6e67dd6ec622e8737279b337fcab911a6be9cc7a38d2403093304e8e7 LumaDock-0.2.13-arm64.dmg
0.2.12
- Installation macOS optimisée : le package .dmg utilise la compression LZMA et ne contient que les slices ARM64 des binaires universels avant signature, réduisant sa taille.
- Prise en charge des sauvegardes et rollback : création de snapshots vérifiés, restauration de sauvegardes et basculement entre versions de runtime, avec sauvegarde automatique avant toute opération.
- Gestion sécurisée des fichiers partagés : conservation des conteneurs gérés référencés par d’autres jeux (y compris les entrées cachées) et rejet des liens symboliques pointant vers sauvegardes ou backups.
- Intégration de nxnative et contrôleurs natifs : inclusion d’une version fixe de nxnative (rev. c4b74a62...) et de ses outils, avec mapping des boutons Switch/Xbox/PS vers le bouton A sur Mac/iOS via GameController.
- Interface allégée : cartes d’importation réduites, sélecteur de langue sur une ligne, et affichage des exigences IPA sur hover, avec des vérifications d’environnement visibles par défaut.
- Validation macOS : build exclusif pour Apple Silicon, compatible avec macOS 26+ (ou ultérieur), nécessitant Xcode complet (Metal) et XcodeGen pour l’export IPA.
LumaDock 0.2.12
Changes
-
Smaller macOS installer. Use LZMA DMG compression, remove development examples and self-tests from staged dependencies, and keep only ARM64 slices of universal runtime binaries before signing. Offline runtime modules, engine profiles, notices and corresponding source archives remain included. Extend relocation checks to font, cryptography, compression, dictionary and image modules.
-
Save backups and runtime rollback. Create verified save snapshots, restore a selected backup, and switch between prepared runtime versions. Restore and version switching back up current saves first; version switching does not restore old saves automatically. Recovery is serialized with gameplay and preparation, and retries stay bound to their original library.
-
Safe shared-file cleanup. Keep managed containers referenced by other games, including hidden entries. Cache cleanup refuses symbolic links that could reach saves or backups.
-
Bundled nxnative and native controllers. Include nxnative revision
c4b74a62f926e1c5bff71b50d7fae9d6340ddf08, its translator, metadata reader and third-party notices. Packaged apps prepare the bundled tools offline without installing the .NET SDK. Native GameController input maps Switch Pro A / Xbox A / PlayStation cross to game A on Mac and iOS. Prepare existing games again to apply the new host. -
Compact game details and environment checks. Use smaller import cards, keep the launch-language selector on one line, and show IPA requirements on hover. Failed checks remain visible; passed checks are collapsed by default.
-
Tested daily engine synchronization. Import upstream sources daily at 03:00 Asia/Shanghai, reapply controller rules, and update the repository only after full CI passes. Interface changes, failures or a changed main branch retain the previous engine. Daily synchronization does not publish a Release.
Installation and validation
Download LumaDock-0.2.12-arm64.dmg and verify its SHA-256 below. Quit LumaDock and active tasks before replacing the app in Applications. Requires Apple Silicon and macOS 26+. The app uses ad-hoc signing and is not notarized. Game preparation requires full Xcode with Metal; IPA export also requires the iOS platform and XcodeGen.
After upgrading, choose Prepare engine tools in Settings, then prepare existing games again for the new controller behavior. Save backups and runtime versions are available from game details.
The combined changes pass 192 Python tests. Release validation also covers Swift Release tests, native controller snapshots, engine host tests and compilation, iOS source compilation, real Metal diagnostics, unsigned synthetic IPA packaging, signatures, distribution boundaries and runtime relocation. The tag workflow rebuilds and validates the DMG before publishing it; public Release assets contain only the DMG.
Validation limits: synthetic input and compile checks do not establish physical-controller behavior, real-game compatibility, iOS device behavior, power-loss recovery or removable-media disconnect handling. No games, updates, DLC, firmware, player keys, artwork, saves, backups or player caches are included. The bundled engine and dependencies retain their licenses.
中文说明
-
缩小 macOS 安装包。 DMG 改用 LZMA 压缩,暂存依赖时移除开发示例与自测文件,签名前将通用运行库精简为 ARM64。保留离线运行模块、引擎配置、许可与对应源码压缩包,并加强字体、加密、压缩、字典及图片模块的搬移检查。
-
存档备份与运行版本回退。 创建并校验存档快照,恢复指定备份,或切换已准备的运行版本。恢复和版本切换前自动备份当前存档;切换运行版本不会自动回退存档。恢复与游戏运行、准备任务互斥,重试限定在原游戏库内。
-
安全清理共享文件。 保留其他游戏(含隐藏条目)仍引用的托管容器;拒绝通过符号链接清理存档或备份。
-
内置引擎与原生手柄。 内置 nxnative 固定版本
c4b74a62f926e1c5bff71b50d7fae9d6340ddf08、翻译器、读取器及第三方许可。安装包可离线准备工具,无需另装 .NET SDK。Mac/iOS 共用原生 GameController 规则:Switch Pro A / Xbox A / PS 叉键对应游戏 A。已有游戏需重新准备一次以更新宿主。 -
精简界面。 压缩导入内容卡片,启动语言保持单行,IPA 要求移至悬停提示。异常环境检查直接显示,通过项默认折叠。
-
每日同步并验证引擎。 每天北京时间 03:00 导入上游源码、重新应用手柄规则,通过完整 CI 后才更新仓库。接口变化、验证失败或 main 已变化时保留旧引擎。每日同步不发布 Release。
下载 LumaDock-0.2.12-arm64.dmg,按下方 SHA-256 校验,退出应用及任务后替换“应用程序”中的副本。要求 Apple Silicon、macOS 26 及以上;采用临时签名,尚未公证。准备游戏需完整 Xcode 与 Metal,导出 IPA 另需 iOS 平台与 XcodeGen。
升级后在设置中选择“准备引擎工具”,再为已有游戏重新准备以应用手柄规则。游戏详情提供存档备份与运行版本管理。
整合后通过 192 项 Python 测试。发行验证还覆盖 Swift Release、原生手柄快照、引擎宿主测试与编译、iOS 源码编译、实际 Metal 诊断、合成未签名 IPA、签名、分发边界及运行库搬移。标签流水线重新构建并验证后才发布 DMG;Release 只附带 DMG。
验证范围: 合成输入和编译检查不代表实体手柄、真实游戏、iOS 真机、断电或外置盘断开验收。不附带游戏、更新、DLC、固件、玩家密钥、封面、存档、备份或玩家缓存,内置引擎及依赖保留各自许可。
DMG SHA-256
70551489862940f111b642bfcfc666066493491a51b3fe6215ef824f9164a237 LumaDock-0.2.12-arm64.dmg
0.2.10
- Gestion améliorée des fichiers NSP/XCI fusionnés : lecture complète des packages (jeu de base, mises à jour intégrées et DLC) via leurs métadonnées, avec un seul exemplaire géré du conteneur physique.
- Compatibilité renforcée avec les moteurs nxnative : utilisation de la version la plus récente des jeux importés pour générer des profils privés et des tables de shaders si les builds enregistrés ou leurs entrées ne correspondent pas.
- Protection des données en cas d’échec : validation des timbres d’entrée des shaders et des plateformes iOS avant sauvegarde des points de contrôle ; conservation des sauvegardes et de l’état précédent en cas d’annulation ou d’échec.
- Build macOS spécifique : publication de LumaDock-0.2.10-arm64.dmg pour Apple Silicon, nécessitant macOS 26+, avec signature ad-hoc non notarisée (nécessite un certificat Developer ID pour une distribution validée).
- Sécurité des tâches en cours : blocage de la remplacement d’une application cible si son exécutable ou ses processus enfants sont actifs ; validation complète du package signé avant publication.
LumaDock 0.2.10
Changes
- Read every package in merged NSP/XCI files. Register the base game, embedded updates and DLC from their own content metadata, while keeping one managed copy of the physical container. Reimport repairs older single-package records; after preparing the updated engine reader, existing managed containers are rescanned automatically. Extraction selects the requested title and version instead of choosing an arbitrary NCA of the same type.
- Prepare the imported version with recent nxnative engines. When the selected engine provides the derived-profile API, use the newest imported game version and generate a private profile and shader tables when registered builds or their shader inputs do not match. Registered builds retain their applicable fixes. Derived builds use their own shader inputs, C1/CB tables, cache identity and experimental status. Older engines retain explicit version requirements; games with no matching profile remain unsupported.
- Preserve successful work on failure. Validate shader input stamps and iOS shader platforms before checkpointing. Cancellation, shader failures and failed installation preserve the previous runtime and saves; retry verifies reusable extraction, rewrite and shader-split stages.
- Unify the task banner. Place the global task banner within the content area's background and use the same native Liquid Glass surface as the other controls. Remove its extra button background and the toolbar keyboard button; input mapping remains available in Settings and game details.
- Protect running applications during packaging. Refuse to replace an output app while its executable or runtime children are running. Build and validate a complete signed app in a staging directory; restore the previous app if publication or relocated-runtime validation fails.
--output-dirsupports independent local builds. Verify the bundled Python can launch the bundledspirv-crosswith a GUI-style PATH, both before and after relocation. Missingspirv-crossnow reportsshader_tool_missingrather than game shader incompatibility.
Installation and validation
The release workflow builds LumaDock-0.2.10-arm64.dmg and its source archive. Verify SHA256SUMS, quit any running LumaDock copy and its tasks, then replace the app in Applications. Requires Apple Silicon and macOS 26+. This release still uses ad-hoc signing and is not notarized; a valid local code signature does not guarantee Gatekeeper approval. A Developer ID Application certificate and Apple notarization are required for normal identified-developer distribution.
After upgrading, prepare the engine tools again in Settings to update the container reader. Existing managed game files can then be rescanned without another import. A shader task interrupted by an app replacement can be retried after reopening the complete app; keep the sources, keys and successful caches.
Local verification passed 156 Python tests and 61 Swift Release tests, plus the later appearance/progress regression subset after the toolbar adjustment. Synthetic pipelines cover derived Mac/iOS preparation, cache reuse, cancellation, failures, wrong shader stamps and wrong iOS shader platforms. The actual nxnative derivation API was checked with synthetic input. Read-only inspection of a player's merged XCI identified both its base and embedded update, and the version planner selected the update without requiring another registered version. The native metadata reader compiled against LibHac 0.19. Signed local apps passed runtime, nested spirv-cross execution and distribution-boundary checks; a separate synthetic window was visually checked in light, dark and high-contrast appearances.
Validation limits: these checks do not establish successful full compilation or gameplay of the player's 1.0.1 game, iOS device compatibility, or Gatekeeper/notarization acceptance. Tag CI rebuilds and validates public artifacts before publishing them; its completion is not claimed by these local results.
No engine, games, updates, DLC, firmware, player keys, artwork, saves or player caches are included. Third-party notices remain in the bundled documentation.
中文说明
- 完整识别合并容器。 按各自内容元数据登记 NSP/XCI 中的本体、内置更新及 DLC,共用一份托管副本。重新导入可修复旧记录;准备新版读取器后,自动重扫已有托管文件。解包器明确选择标题与版本,避免取错同类型 NCA。
- 接入 nxnative 动态派生。 所选引擎提供相应接口时,选择已导入的最新游戏版本;登记版本或着色器素材不匹配时,在私有缓存生成独立配置和着色器表。登记版本保留对应修复;派生版本使用自己的着色器、C1/CB 表与缓存,并标为实验性。旧引擎继续校验指定版本,没有对应游戏配置时仍不能构建。
- 保留成功阶段。 着色器输入标记与 iOS 编译平台验证通过后才写检查点。取消、着色器失败和安装失败保留上次成功运行版本与存档;重试会验证并复用解包、代码重写和着色器提取等已完成阶段。
- 统一界面材质。 底部任务栏移入内容区,共用背景和系统 Liquid Glass 材质;去掉按钮额外底色及右上角键盘按钮。设置和游戏详情保留输入映射入口。
- 避免打包打断任务。 目标应用或其运行时子进程仍运行时拒绝覆盖。完整包先在暂存目录签名、验证,再发布;发布或搬移后验证失败会恢复旧包。新增
--output-dir独立输出目录;搬移前后验证内置 Python 在 GUI PATH 下能启动内置spirv-cross。缺少工具时报告shader_tool_missing,不再误报游戏着色器不兼容。
工作流生成 LumaDock-0.2.10-arm64.dmg 和源码包。核对 SHA256SUMS,退出运行中的应用和任务后再替换“应用程序”中的副本。需要 Apple Silicon、macOS 26 及以上。此版仍为 临时签名、未公证;本地签名校验通过不代表通过 Gatekeeper。正常的已识别开发者分发仍需 Developer ID Application 证书和 Apple 公证。
升级后在设置中重新准备引擎工具,即可更新读取器并重扫已有托管文件,无需重新导入。若着色器任务曾因应用被替换而中断,重新打开完整应用后重试即可;保留源文件、密钥及成功缓存。
本地通过 156 项 Python、61 项 Swift Release 测试,工具栏调整后另通过相关外观与进度回归。合成流程覆盖 Mac/iOS 派生配置、缓存、取消、失败、错误输入标记及 iOS 平台校验;使用合成数据核对真实 nxnative 派生接口。对玩家合并 XCI 的只读检查识别出本体与内置更新,版本规划无需另一登记版本。元数据读取器通过 LibHac 0.19 编译;本地包通过签名、内置 Python/spirv-cross 子进程及分发边界检查;独立合成窗口检查了浅色、深色和高对比外观。
验证范围: 未完成玩家 1.0.1 游戏的整套真实编译或游玩验收,未验证 iOS 真机,也未通过 Apple 公证验收。标签 CI 会重建并验证公开附件;本地结果不代表标签 CI 已完成。
不附带引擎、游戏、更新、DLC、固件、玩家密钥、封面、存档或玩家缓存,第三方许可保留在随包文档中。
0.2.9
- Correction majeure du flux d’ajout de jeux : suppression de la redirection involontaire des fichiers XCI/NSZ/XCZ vers une page dédiée, rétablissant l’import direct dans la bibliothèque.
- Lecture native des fichiers XCI sans conversion systématique en NSP, tandis que les archives NSZ/XCZ restent automatiquement décompressées en temporaires avant import.
- Conservation des contrôles de tâche (progress bar, attente de fin de build, annulation, réessai) et nettoyage des fichiers temporaires après décompression.
- Build macOS disponible uniquement en ARM64 (Apple Silicon), compatible avec macOS 26+, nécessitant Xcode complet, Metal et un moteur externe nxnative pour la préparation.
- Validation via 182 tests (Python/Swift) et vérification d’un workflow complet, incluant diagnostic Metal et tests d’IPA non signées, mais sans garantie de compatibilité avec des jeux commerciaux.
LumaDock 0.2.9
Changes
- Restore Add games (#13). Fix the #8 regression that sent XCI/NSZ/XCZ selections to the independent File conversion page. Adding files or scanning a mixed-format folder now continues through library import and automatic preparation when required content is available and automatic preparation is enabled.
- Read XCI directly. NSP and XCI are passed directly to the compatible nxnative reader. Managed copies retain their original container extension; XCI is not repacked into NSP. Only NSZ/XCZ archives are automatically decompressed into temporary NSP/XCI files before import, using the library key.
- Preserve task controls. Automatic decompression reports progress, can wait for an active build or game to finish, and supports cancellation and retry. Temporary output is cleaned up. Independent file conversion keeps its own settings and keys.
Installation and validation
Download LumaDock-0.2.9-arm64.dmg, verify SHA256SUMS, and drag LumaDock.app into Applications. Requires Apple Silicon and macOS 26+. Packages use ad-hoc signing and are not notarized. Preparation requires full Xcode, Metal and a compatible external nxnative engine; IPA export also requires the iOS platform and XcodeGen.
The import fix passed 122 Python tests and 60 Swift Release tests, plus the PR's complete CI build, real Metal diagnostics, unsigned UIKit IPA validation, package/signature checks and runtime relocation. An isolated app verified that a synthetic mixed XCI/XCZ folder proceeds from import to preparation and a ready library entry. The tag workflow rebuilds and validates all assets before publishing them.
Validation limits: UI and import tests use synthetic containers with metadata/compiler test doubles. They do not establish successful commercial-game decryption, compilation, gameplay or physical iOS compatibility. The previously documented newer-nxnative NVN IPA C1 inputs-stamp issue is not addressed by this update.
No engine, games, updates, DLC, firmware, player keys, game artwork, saves or player caches are included. Thanks to nxnative, MacNativeGames, d2r-mobile, SAK-Mac, S2Arm and their contributors; full notices remain in the bundled documentation.
中文说明
- 恢复添加游戏流程(#13)。 修复 #8 将 XCI/NSZ/XCZ 选择直接转交独立“文件转换”页的问题。添加文件或扫描混合格式文件夹后继续入库;所需内容齐全且开启自动准备时,自动开始编译。
- 直接读取 XCI。 NSP、XCI 直接交给兼容的 nxnative 读取器,托管副本保留原容器扩展名,不将 XCI 重新封装为 NSP。仅 NSZ/XCZ 使用游戏库密钥自动解压为临时 NSP/XCI 后导入。
- 保留任务控制。 自动解压显示进度,可等待已有构建或游戏结束,支持取消、重试及临时产物清理。独立文件转换保留自己的设置和密钥。
下载 LumaDock-0.2.9-arm64.dmg,核对 SHA256SUMS 后拖入“应用程序”。需要 Apple Silicon、macOS 26 及以上。安装包采用 ad-hoc 签名,尚未公证。游戏准备仍需完整 Xcode、Metal 和兼容的外部引擎;IPA 导出还需 iOS 平台与 XcodeGen。
导入修复通过 122 项 Python、60 项 Swift Release 测试,以及 PR 的完整 CI 构建、真实 Metal 诊断、原创 UIKit 未签名 IPA 校验、安装包和签名校验、运行时搬移检查。独立测试应用实际验证合成 XCI/XCZ 混合目录从导入自动进入准备,最终游戏库显示可启动。版本标签流水线会在公开附件前重新执行完整构建与校验。
验证范围: 界面和导入测试使用原创合成容器,元数据读取及编译由测试替身提供,不代表商业游戏解密、编译、游玩或实体 iOS 兼容性验收。本版未处理此前记录的新版 nxnative NVN IPA C1 inputs 标记兼容问题。
项目不附带引擎、游戏、更新、DLC、固件、玩家密钥、游戏封面、存档或玩家缓存。感谢 nxnative、MacNativeGames、d2r-mobile、SAK-Mac、S2Arm 及贡献者;完整致谢与许可保留在随包文档中。
0.2.8
- Correction d’un crash lié à la préparation des shaders en lisant prioritairement dm/gfx/nvn/dmsh_chain.h de nxnative, avec fallback sur les en-têtes par jeu pour les moteurs plus anciens.
- Affichage détaillé des étapes, durées et estimations de temps pour la préparation des jeux et l’export IPA, avec calcul de médianes locales pour les étapes non-cachées.
- Correction du calcul de progression des shaders iOS en comptabilisant les paires de réflections/bibliothèques iOS, indépendamment de l’état du cache Mac.
- Build exclusif pour Apple Silicon (ARM64) avec support de macOS 26+, distribué via un fichier .dmg non notarisé et signé ad-hoc.
- Validation par 114 tests Python et 57 tests Swift Release, incluant vérifications Metal sur macOS/iOS et tests de relocalisation runtime.
LumaDock 0.2.8
Changes
- Shader preparation fix (#12). Read newer nxnative's shared
dm/gfx/nvn/dmsh_chain.h, with fallback to the selected game's header for older engines. This fixes the missing-header crash reported in the #9 follow-up, before shader compilation starts. Missing or invalid headers trigger one private engine-workspace rebuild before an actionable error. - Milestone progress and time estimates (#11). Game preparation and IPA export show their steps, purposes, elapsed time, estimated remaining time and completion time in both the task page and global task bar. Successful uncached stages train local median estimates by game, target and toolchain. Initial timings are reference estimates; unknown totals do not produce numeric percentages. Adapted from S2Arm with its attribution and MIT notice retained.
- Correct iOS shader progress. Count completed iOS reflection/library pairs instead of the Mac cache, including with older per-game chain headers. A finished Mac cache no longer makes an unfinished iOS shader stage appear complete.
Installation and validation
Download LumaDock-0.2.8-arm64.dmg, verify SHA256SUMS, and drag LumaDock.app into Applications. Requires Apple Silicon and macOS 26+. Packages use ad-hoc signing and are not notarized. Preparation requires full Xcode, Metal and a compatible external nxnative engine; IPA export also requires the iOS platform and XcodeGen.
The combined changes passed 114 Python tests and 57 Swift Release tests, real macOS/iOS Metal checks, original unsigned UIKit IPA validation, and CI package, signature and runtime-relocation checks. Tests exercise both header layouts through actual synthetic header-generation subprocesses and iOS counting while the Mac cache is complete. The tag workflow repeats the full build and validation before publishing assets.
Validation limits: #9's reporter bypassed the missing-file error by copying the header, then reported 0% shader progress. Those logs do not establish successful compilation or a complete game build. Real-game preparation, gameplay and physical iOS devices have not been revalidated. Newer nxnative NVN IPA export has a separate existing C1 table inputs-stamp compatibility issue; this release does not resolve it.
No engine, games, updates, DLC, firmware, player keys, game artwork, saves or player caches are included. Thanks to nxnative, MacNativeGames, d2r-mobile, SAK-Mac, S2Arm and their contributors; full notices remain in the bundled documentation.
中文说明
- 修复着色器准备崩溃(#12)。 优先读取新版 nxnative 的共享
dm/gfx/nvn/dmsh_chain.h,兼容旧版每游戏头文件,修复 #9 追评中在编译启动前发生的缺失头文件异常。缺失或无效头文件会触发一次私有引擎工作区重建,仍无效时给出明确提示。 - 里程碑进度与耗时估算(#11)。 游戏准备和 IPA 导出显示阶段、步骤作用、已用时间、预计剩余和完成时刻,任务页与全局底栏同步。成功且未命中缓存的阶段按游戏、目标和工具链积累本机耗时中位数;初始耗时明确为参考估计,未知总量不显示数字百分比。实现参考 S2Arm,保留来源和 MIT 声明。
- 修正 iOS 着色器计数。 IPA 任务读取 iOS 产物,避免 Mac 缓存完成后提前显示 iOS 阶段完成,旧版头文件同样适用。
下载 LumaDock-0.2.8-arm64.dmg,核对 SHA256SUMS 后拖入“应用程序”。需要 Apple Silicon、macOS 26 及以上。安装包采用 ad-hoc 签名,尚未公证。游戏准备仍需完整 Xcode、Metal 和兼容的外部引擎;IPA 导出还需 iOS 平台与 XcodeGen。
组合版本通过 114 项 Python、57 项 Swift Release 测试、真实 macOS/iOS Metal 检查、原创 UIKit 未签名 IPA 校验,以及 CI 的安装包、签名与运行时搬移检查。新增回归实际启动原创头文件生成子进程,并确认 Mac 缓存完成时 iOS 进度不会提前完成。版本标签流水线会在公开附件前重新执行完整构建与校验。
验证范围: #9 报告者仅确认复制头文件后越过缺失文件异常,随后反馈进度停在 0%;附件不能证明编译或完整游戏准备成功。本次未重验真实游戏准备、游玩或 iOS 真机。新版 nxnative 的 NVN IPA 导出另有既存 C1 表 inputs 标记兼容问题,本版尚未处理。
项目不附带引擎、游戏、更新、DLC、固件、玩家密钥、游戏封面、存档或玩家缓存。感谢 nxnative、MacNativeGames、d2r-mobile、SAK-Mac、S2Arm 及贡献者;完整致谢与许可保留在随包文档中。
0.2.7
- Ajout d’une page dédiée à la conversion de fichiers (NSP/XCI, NSZ/XCZ) avec compression/décompression et fusion des packages (base, mises à jour, DLC).
- Protection des données : isolation des entrées/sorties, gestion des clés dédiées, historique des tâches et logs séparés, export sécurisé sans écrasement des fichiers existants.
- Correction d’un bug dans la préparation des DLC pour macOS, lié à l’absence d’argument obligatoire dans extract_aoc() lors de l’export IPA.
- Build .dmg spécifique Apple Silicon (arm64) avec vérification SHA256, mais pas de notarisation (signature ad-hoc uniquement).
- Dépendances inchangées : Xcode complet, Metal et moteur externe nxnative requis pour la préparation des jeux, XcodeGen pour l’export IPA.
LumaDock 0.2.7
LumaDock is a game launcher for Apple Silicon Macs running macOS 26 or later, using a player-selected external nxnative engine.
Changes
- Bundled file conversion. Convert NSP/XCI (including NSZ/XCZ inputs), compress or decompress NSZ/XCZ, and merge one game's base, update and DLC packages. The new File conversion page uses bundled tools adapted from SAK-Mac, with NSC_BUILDER, nsz and pinned dependencies. Conversion needs your own valid keys; it does not need a separate Python, Xcode or nxnative installation. Generated NSPs can be imported into the library. (#8)
- Protected inputs and outputs. Conversion runs with private input/backend copies, separate conversion keys, progress, cancellation/retry, task history and log actions. Validated results are exported into a new folder without replacing existing output. Upstream licenses, dependency notices and corresponding GPL/MPL component sources are included.
- DLC preparation fix. Pass the engine source directory to the upstream seven-argument
extract_aocinterface. This fixesTypeError: extract_aoc() missing 1 required positional argument: 'logs'during Mac preparation and IPA export. The reported exception was caused by an incorrect call; it did not establish a console/firmware version mismatch. (#9, #10)
Installation and validation
Download LumaDock-0.2.7-arm64.dmg, verify SHA256SUMS, and drag LumaDock.app into Applications. Packages use ad-hoc signing and are not notarized. Game preparation still requires full Xcode, Metal and a compatible external engine; IPA export also requires the iOS platform and XcodeGen.
The combined changes passed 98 Python tests and 51 Swift Release tests, real macOS/iOS Metal success/failure checks, and original unsigned UIKit IPA packaging/validation. DLC regression coverage includes Mac/iOS calls, multiple DLC packages, no DLC, cache reuse and failure/retry. Conversion success tests use original containers and backend protocol fixtures; real bundled backends are checked for startup, relocation and invalid-key rejection. These checks do not establish commercial-game conversion, in-game DLC behavior or physical iPhone/iPad compatibility.
No engine, games, updates, DLC, firmware, player keys, game artwork, saves or player caches are included. Import only content you are authorized to use. The project is not affiliated with Nintendo or any game publisher. Thanks to nxnative, MacNativeGames, d2r-mobile, SAK-Mac and their contributors; full notices remain in the bundled documentation.
中文说明
璃游 0.2.7 面向 Apple Silicon Mac、macOS 26 及以上,使用玩家自行提供的外部 nxnative 引擎。
- 内置文件转换。 新增“文件转换”页面,支持 NSP/XCI 转换(可输入 NSZ/XCZ)、压缩解压及同一游戏本体、更新和 DLC 合并。内置参考 SAK-Mac 的调度逻辑、NSC_BUILDER、nsz 和固定版本依赖;导入自己的有效密钥即可使用,无需另装 Python、Xcode 或 nxnative。生成的 NSP 可直接入库。(#8)
- 保护原文件和已有输出。 使用私有输入与后端副本、独立转换密钥,提供进度、取消重试、任务历史、日志和结果入口。校验后导出至新文件夹,不覆盖旧结果;保留上游许可、依赖声明及 GPL/MPL 组件对应源码。
- 修复 DLC 准备失败。 补齐
extract_aoc所需的引擎源码目录参数,修复 Mac 准备和 IPA 导出时的missing 1 required positional argument: 'logs'。此异常来自调用参数错误,现有日志没有证明主机或固件版本不匹配。(#9、#10)
下载 LumaDock-0.2.7-arm64.dmg,核对 SHA256SUMS 后拖入“应用程序”。安装包采用 ad-hoc 签名,尚未公证。游戏准备仍需要完整 Xcode、Metal 和兼容的外部引擎;IPA 导出还需要 iOS 平台与 XcodeGen。
组合版本通过 98 项 Python、51 项 Swift Release 测试、真实 macOS/iOS Metal 成功与失败检查,以及原创 UIKit 未签名 IPA 构建校验。DLC 回归覆盖 Mac/iOS、多 DLC、无 DLC、缓存复用和失败重试。转换成功测试使用原创容器和后端协议夹具;真实内置后端检查覆盖启动、搬移和无效密钥拒绝。尚未验证商业游戏转换、游戏内 DLC 加载或实体 iPhone/iPad 兼容性。
项目不附带引擎、游戏、更新、DLC、固件、玩家密钥、游戏封面、存档或玩家缓存;仅导入有权使用的内容。项目与 Nintendo 及游戏发行商无隶属或认可关系。感谢 nxnative、MacNativeGames、d2r-mobile、SAK-Mac 及贡献者;完整致谢和许可保留在随包文档中。
0.2.6
- Ajout d'une fonctionnalité export IPA depuis l'interface utilisateur pour générer un package iPhone/iPad non signé.
- Amélioration des diagnostics : erreurs actionnables avec code, étape échouée, suggestions de réparation et logs redigés.
- Visibilité des avertissements shaders persistants même après réutilisation de points de contrôle.
- Barre de progression unifiée pour les opérations longues (imports, builds, vérifications, etc.), avec affichage des données mesurées ou barre indéterminée.
- Validation locale étendue incluant 78 tests Python et 45 tests Swift Release, plus vérifications UI multilingues et IPA synthétiques.
- Exigence Xcode iOS et XcodeGen pour l'export IPA, avec vérification des CRCs et préservation de l'IPA précédent en cas d'échec.
LumaDock 0.2.6
LumaDock is a game launcher for Apple Silicon Macs running macOS 26 or later, using a player-selected external nxnative source directory.
Changes
- Actionable errors. Build failures show the failed stage, error code, suggested repair, redacted compiler output and a link to the specific log. Copy a redacted summary from the alert or task. Diagnostics cover missing Metal/SDK components, shader translation/compilation errors, shader-chain mismatches, disk/permission errors and possible memory exhaustion. Worker startup failures and unexpected exits are also retained.
- Shader warnings stay visible. A shader tool returning success with incomplete shader results produces a warning; no usable shaders stops the build. Warnings survive checkpoint reuse instead of disappearing on retry. A completed build does not guarantee correct graphics in every scene.
- Progress across long operations. A shared linear progress display covers imports, source/copy/cache verification, engine preparation, game/shader builds, IPA export, environment checks, Metal component management, cleanup and diagnostics export. Tasks show measured bytes/files/shaders and percentages when a real total is known; otherwise they show an indeterminate bar, current phase and elapsed time. Progress remains visible outside Tasks and inside setup/Settings. Pure Python work has heartbeats; ordinary messages no longer clear counters.
- Generate IPA. Choose Generate IPA… in game details to export an unsigned iPhone/iPad game package. Mac and iOS builds have separate cache identities; iOS shaders are checked before packaging. Export validates archive structure/CRCs and preserves the previous IPA after failure or cancellation. Xcode's iOS platform, Metal compiler and XcodeGen are required. Sign the IPA with your installation tool before installing it.
- Keep English/Chinese UI and guides synchronized. CI additionally compiles original Metal samples for macOS/iOS, checks real compiler error redaction and builds/validates a small unsigned UIKit fixture IPA. No engine or player content is fetched for these checks.
Installation and validation
Download LumaDock-0.2.6-arm64.dmg, verify SHA256SUMS, and drag LumaDock.app into Applications. Packages use ad-hoc signing and are not notarized. Preparing games requires full Xcode, Metal and your own compatible external engine. IPA export additionally needs the iOS platform and XcodeGen (brew install xcodegen).
Local validation passed 78 Python tests and 45 Swift Release tests, plus English/Chinese UI checks of progress, cancellation/retry, warning/error actions, mapping save and synthetic IPA export. Regression coverage includes library/import/setup flows, keys and source isolation, engine/tool caches, cancellation/retry, input mappings, language/appearance, diagnostics, progress, IPA export and distribution data boundaries. Real Apple tools validate macOS/iOS Metal success and failure paths and a synthetic iOS app archive. These checks do not establish commercial-game preparation, gameplay or physical iPhone/iPad compatibility. See the bundled validation record for the exact scope.
No games, updates, DLC, firmware, player keys, game artwork, saves or player caches are included. Import only content you are authorized to use. Back up important saves. The project is not affiliated with Nintendo or any game publisher. Thanks to nxnative, MacNativeGames, d2r-mobile and their contributors; acknowledgements and third-party licenses remain in the README and bundled guides.
中文说明
璃游 0.2.6 面向 Apple Silicon Mac、macOS 26 及以上,继续使用玩家自行提供的外部 nxnative 源码。
- 具体报错与修复建议。 显示失败阶段、错误代码、处理建议和脱敏编译器输出,直接定位对应日志,也可复制错误摘要。区分 Metal/SDK 缺失、着色器转换或编译失败、缓存链不匹配、空间/权限问题及可能的内存不足;工作进程启动失败和异常退出也会保存诊断。
- 保留着色器警告。 进程返回成功但着色器结果不完整时显示警告,没有可用着色器时停止构建;缓存复用后仍显示警告。“准备完成”不代表所有场景画面正常。
- 补齐耗时操作的进度条。 覆盖导入、源文件/副本/缓存校验、引擎准备、游戏与着色器构建、IPA 导出、环境检查、Metal 组件管理、清理和诊断导出。可计数时显示实际字节、文件、着色器数量和百分比;总量未知时使用线形不定进度条,并显示阶段及已用时间。其他页面、设置及向导中也能查看进度,普通消息不会清空计数,纯 Python 任务持续发送心跳。
- 一键生成 IPA。 游戏详情点击“生成 IPA…”即可导出未签名 iPhone/iPad 游戏包。Mac/iOS 缓存隔离,检查 iOS 着色器、IPA 结构及 CRC;失败或取消保留上次 IPA。需要 Xcode iOS 平台、Metal 组件和 XcodeGen;安装到设备前仍需自行签名。
- 同步中英文界面和文档;CI 新增 macOS/iOS 实际 Metal 成功/失败诊断及原创 UIKit 样例 IPA 构建校验,不下载引擎或玩家内容。
下载 LumaDock-0.2.6-arm64.dmg,核对 SHA256SUMS 后拖入“应用程序”。安装包采用 ad-hoc 签名,尚未公证。本地通过 78 项 Python、45 项 Swift Release 测试,以及中英文进度、取消/重试、错误/警告、映射保存及合成 IPA 导出的实际界面检查。回归检查覆盖启动器各工作流程、取消与重试、设置、进度、诊断及数据边界,并使用真实 Apple 编译器与合成 iOS 应用验证;不代表商业游戏准备、游玩或 iPhone/iPad 真机兼容性验收。具体范围见随包验收记录。
项目不附带游戏、更新、DLC、固件、玩家密钥、游戏封面、存档或玩家缓存;仅导入有权使用的内容,并备份重要存档。项目与 Nintendo 及游戏发行商无隶属或认可关系。感谢 nxnative、MacNativeGames、d2r-mobile 及贡献者;README 与随包文档保留上游致谢和第三方许可。
0.2.5
- Exigence d’un moteur externe obligatoire : suppression des sources nxnative, du lecteur NSP et du traducteur de shaders dans le DMG et le code source, avec obligation de fournir un répertoire nxnative compatible.
- Correction du code langue chinois : remplacement de zhHans par zh-Hans dans les paramètres de langue, avec choix par jeu ou par défaut, sans réimport de firmware.
- Sortie du setup améliorée : possibilité de quitter le processus d’installation via Esc ou ⌘Q, même en cas d’échec de vérification, tout en conservant les blocages pour les étapes critiques.
- Validation renforcée des interfaces externes : vérification des empreintes et isolation des caches, avec préservation de la dernière version fonctionnelle après une panne.
- Build .dmg pour Apple Silicon uniquement : distribution via LumaDock-0.2.5-arm64.dmg avec signature ad-hoc non notarisée, nécessitant Xcode complet et le composant Metal pour préparer les jeux.
- Tests locaux validés : 55 tests Python et 34 tests Swift Release, mais sans validation de jeux commerciaux ou de compatibilité multilingue avec des moteurs tiers.
LumaDock 0.2.5
LumaDock is a Mac game launcher for Apple Silicon and macOS 26 or later, built to work with nxnative.
Changes
- External engine only. The app, DMG and source archive no longer include nxnative sources, the NSP reader or shader translator. Obtain a complete compatible nxnative source directory yourself, select its root in setup or Settings, then choose Prepare engine tools. There is no engine download action. The initial tool build requires the .NET 10 SDK for macOS Arm64 and may restore NuGet dependencies. Builds use private copies and leave your original source directory unchanged. Generic Python/.NET runtimes and conversion tools remain bundled.
- Game language (#2). Fix the invalid hardcoded
zhHanscode tozh-Hans. Choose Launch language in game details, or a Default game language in Settings. Per-game choices persist independently of the interface language and apply on the next launch without rebuilding or importing firmware. The game and engine must support the selected language. - Setup exit (#1). Leave incomplete setup with Set up later / Esc, or quit normally with Quit LumaDock / ⌘Q, including when environment checks fail or are running. Required checks still gate imports and preparation.
- Validate external source interfaces and fingerprints, isolate private tool caches, and preserve the previous successful runtime after failures. Custom mappings require an external engine implementing
DM_INPUT_CONFIG; otherwise the editor explains that the engine's own controls apply. - Update English/Chinese guides and light-mode screenshots without game content. CI builds the standalone launcher without downloading nxnative.
Installation and validation
Download LumaDock-0.2.5-arm64.dmg, check SHA256SUMS, and drag LumaDock.app into Applications. The community build uses ad-hoc signing and is not notarized. Preparing games also requires full Xcode and Apple's Metal compiler component; the setup assistant checks their actual state and explains installation.
Local validation passed 55 Python tests and 34 Swift Release tests, actual English/Chinese menu checks, package/signature checks and release-artifact verification. No commercial games were run for this release, so these checks do not establish gameplay or in-game language compatibility with arbitrary external engines. GitHub Actions independently verifies and publishes the tag's DMG, source archive and checksums; local results do not confirm the remote run.
No games, updates, DLC, firmware, player keys, game artwork, saves or player caches are included. Import only content you are authorized to use. Experimental native execution can crash, stutter or lose saves; back up important data. The project is not affiliated with or endorsed by Nintendo or any game publisher. Special thanks to nxnative, MacNativeGames, d2r-mobile and their contributors; upstream acknowledgements and third-party licenses remain in the README and bundled documentation.
中文说明
璃游 0.2.5 面向 Apple Silicon、macOS 26 及以上。
- 改为外部引擎。 应用、DMG 和源码包不再内置 nxnative 源码、NSP 读取器或着色器翻译器,也没有引擎下载按钮。请自行获取兼容的完整源码,在向导或设置中选择包含
dm和scripts的根目录,再点击“准备引擎工具”。首次需要 .NET 10 SDK(macOS Arm64),可能恢复 NuGet 依赖。所有构建及适配在私有副本中完成,原目录保持不变;通用 Python/.NET 运行时及转换工具仍随应用提供。 - 修复游戏语言(#2)。 将错误的
zhHans改为zh-Hans。游戏详情新增“启动语言”,设置新增“默认游戏语言”;每游戏选择独立保存,与界面语言无关,下次启动生效,无需重新准备或导入固件。实际语言取决于游戏和引擎支持。 - 修复向导退出(#1)。 环境失败或检查进行中,也可通过“稍后设置 / Esc”离开,或通过“退出璃游 / ⌘Q”正常退出;必要检查仍会限制导入和准备。
- 增加外部引擎接口、源码指纹和工具完整性检查,隔离缓存并保留上次成功的运行版本。自定义映射需要引擎提供
DM_INPUT_CONFIG;不支持时明确提示并使用引擎默认操作。更新中英文说明及不含游戏内容的浅色截图,CI 不下载 nxnative。
下载 LumaDock-0.2.5-arm64.dmg,核对校验和后拖入“应用程序”。安装包采用本地 ad-hoc 签名,尚未公证;准备游戏还需要完整 Xcode 和 Metal 编译组件,向导会检查实际状态并提供安装方法。
本地通过 55 项 Python、34 项 Swift Release 测试,以及中英文实际菜单、应用签名与发行产物校验。本次未运行商业游戏,不能据此声称任意外部引擎的游玩或游戏内语言验收通过。标签流水线独立校验并发布 DMG、源码包和校验和;本地结果不代表远端已成功。
项目不附带游戏、更新、DLC、固件、玩家密钥、游戏封面、存档或玩家缓存;仅导入有权使用的内容。实验性运行可能崩溃、卡顿或丢失存档,请备份重要数据。项目与 Nintendo 及游戏发行商无隶属或认可关系。特别感谢 nxnative、MacNativeGames、d2r-mobile 及其贡献者;README 与随包文档保留上游致谢、风险及第三方许可。
0.2.4
- Lanceur natif pour macOS : ajout de LumaDock, compatible Apple Silicon et macOS 26+, avec configuration guidée et gestion des bibliothèques NSP.
- Préparation automatique : progression visible, annulation possible, validation des caches et configuration des périphériques (clavier/souris/manette).
- Génération locale du runtime : support de l’interface Liquid Glass et gestion des composants Xcode/Metal.
- Tests limités : Breath of the Wild 1.9.0 (lancement réussi) et Super Mario Odyssey 1.4.1 (test de gameplay validé).
- DMG ARM64 : installation via drag-and-drop dans Applications, signature ad-hoc non notarisée, dépendance à Xcode complet + Metal Compiler.
- Avertissement : aucun contenu Nintendo (jeux, DLC, clés) n’est fourni, vérification SHA256 requise pour les téléchargements.
New in 0.2.4
- Clarify Xcode setup recovery: if setup is already complete, check again or quit and reopen LumaDock first. Review the actual diagnostics before using a manual initialization command.
- Keep the in-app English/Chinese repair instructions and offline environment guides consistent. Environment checks still run once at startup, with manual rechecks and verification after toolchain/library changes.
Local validation: 43 Python tests, 24 Swift Release tests, and app/DMG/source/signature/checksum and bundled-runtime relocation checks passed. No games were run or Apple components installed, removed or licensed during validation. A reported recovery after reopening does not establish a specific root cause or a new gameplay test result. GitHub Actions publishes the release only after its own checks pass; local validation does not confirm the remote run.
0.2.4 更新
- 明确 Xcode 设置恢复步骤:若已完成设置,先重新检查或退出后重开璃游;仍失败时查看实际诊断,确认需要后再使用手动初始化命令。
- 应用内英文、中文提示与离线环境说明保持一致。保留每次启动检查一次、手动检查及工具链或游戏库变化后的验证。
本地通过 43 项 Python 测试、24 项 Swift Release 测试,以及应用、DMG、源码包、签名、校验和与内置运行库搬移检查。本次未运行游戏,未安装、卸载 Apple 组件或接受许可。用户重开后恢复的反馈不代表已确定根因,也不增加游戏游玩验证结论。CI 自身检查通过才会公开 Release;本地通过不代表远端已完成。
LumaDock is a native Mac launcher built on nxnative, for Apple Silicon and macOS 26 or later.
- Guided setup: check the environment, choose a library, import your own
prod.keys, then add NSP games. - Automatic preparation with progress, cancellation, validated caches, and keyboard/mouse/controller configuration.
- Direct Mac runtime generation, a Liquid Glass interface, and Xcode / Metal component management.
- Tested titles: Breath of the Wild 1.9.0 (build and startup passed) and Super Mario Odyssey 1.4.1 (player gameplay test passed). These are limited test results, not full-game completion claims; see the README and validation record.
Download the ARM64 DMG and drag LumaDock into Applications. Packages use local ad-hoc signing and are not notarized. A full Xcode installation and the Metal compiler component are needed to prepare games.
No games, updates, DLC, firmware, keys, game artwork, or player caches are included. Import only content you are authorized to use. This project is not affiliated with Nintendo. Thanks to nxnative, MacNativeGames, d2r-mobile, and their contributors; third-party licenses and notices are preserved.
The release DMG and source archive are built and checked by GitHub Actions; verify them with SHA256SUMS.
璃游是基于 nxnative 的原生 Mac 游戏启动器,面向 Apple Silicon、macOS 26 及以上。先检查环境,再选择游戏库、导入玩家密钥及 NSP,支持自动准备、进度显示、缓存复用与键鼠/手柄映射。
历史记录中《旷野之息》1.9.0 构建及启动通过,《奥德赛》1.4.1 玩家游玩测试通过,均不代表全流程验证。《奥德赛》的较长游玩记录使用此前的 10b33338 引擎;更新固定引擎不会扩大这一证据范围。安装包采用本地 ad-hoc 签名,尚未公证;准备游戏需要完整 Xcode 与 Metal 编译组件。
项目不附带游戏、更新、DLC、固件、密钥或玩家缓存,与 Nintendo 没有隶属关系。感谢 nxnative 等上游项目及贡献者。安装包和源码包由 GitHub Actions 生成并校验,可用 SHA256SUMS 核对。
0.2.3
- Lancement automatique : vérification environnementale unique par lancement, réutilisation des résultats (y compris échecs) pour les changements de paramètres ou réouverture de l’assistant.
- Diagnostics Xcode : affichage détaillé des erreurs (licence, timeout, absence) avec sortie de commande et code de sortie, même sans texte ; commande de réparation copiable générée via Xcode sélectionné.
- Documentation intégrée : instructions en anglais/chinois et notices tierces accessibles via un lecteur hors ligne embarqué, y compris depuis l’assistant.
- Affichage des dépendances : versions et chemins complets des composants embarqués (Python, extensions, .NET) dans une section déployable.
- Sécurité des packages : suppression des chemins de recherche Homebrew résiduels et rejet des dépendances natives externes/symlinks lors de l’emballage.
- Build macOS : validation locale sur macOS 27.0.1 (Xcode 27.1) incluant tests Swift/Python, audits de chemins d’exécution et vérification DMG/signature.
New in 0.2.3
- Check the environment automatically once per app launch. Settings and reopened setup reuse the current result, including failures; manual rechecks and verification after toolchain/library changes remain available.
- Explain Xcode initial setup failures with the selected Developer path, the status command, error output and exit status even when the command returns no text. Distinguish missing Xcode, a reported license error, timeout and other initialization/status failures. A copyable repair command uses the selected Xcode; the user runs it manually after reviewing and agreeing to Apple's license. LumaDock does not execute privileged initialization or accept licenses automatically.
- Open English/Chinese environment instructions and third-party notices in an offline reader inside the app, including from the setup assistant.
- Show bundled component versions first, with full installation paths in an expandable section. Locate Python, extensions and .NET from the current app bundle.
- Remove leftover Homebrew runtime search paths and reject external native dependencies/symlinks during packaging. CI verifies actual bundled tool startup after renaming and moving the app into a path containing Chinese characters and spaces.
- An incomplete packaged app reports its own missing resources instead of falling back to a developer checkout.
Local validation: 43 Python tests, 24 Swift tests, native runtime load-path audits, real UI navigation/offline-guide checks, relocation tests, and DMG/source/signature/checksum verification passed on macOS 27.0.1 with Xcode 27.1. No games were run. The reported initialization failure on another Mac cannot be diagnosed from its old screenshot alone; use the updated diagnostics. Physical macOS 26 testing remains outstanding. GitHub Actions builds and publishes this release only after its checks pass; local results do not confirm the remote run.
0.2.3 更新
- 每次启动自动检查一次;切换设置或重新打开向导复用本次结果,包括失败结果。手动检查、工具链或游戏库变更后的验证保留。
- Xcode 初始设置失败时显示所选 Developer 路径、检查命令、错误输出及退出码;命令无输出也不会只显示通用说明。区分缺少 Xcode、命令报告的许可错误、超时及其他初始化或状态检查失败。修复命令按实际 Xcode 路径生成,由玩家阅读并同意 Apple 许可后手动执行;应用不自动执行管理员初始化或接受许可。
- 环境安装说明与第三方许可改为应用内离线阅读,支持中英文,首次运行向导内也能打开。
- 内置组件默认显示版本,完整位置可展开;Python、扩展及 .NET 根据当前应用包位置定位。
- 清除 Homebrew 备用搜索目录,打包时拒绝外部原生依赖和符号链接;CI 实际验证应用改名、移动至中文和空格目录后仍能启动内置工具。
- 应用包缺少资源时报告本包错误,不回退到开发者源码目录。
本地通过 43 项 Python 测试、24 项 Swift 测试、运行库审计、真实界面切换及离线说明检查、搬移验证,以及 DMG、源码、签名和校验和检查。测试系统为 macOS 27.0.1 / Xcode 27.1;本次没有运行游戏,也未在对方 Mac 上确认初始化失败的具体原因。macOS 26 真机验证仍待补充。CI 全部通过才会公开 Release,本地通过不代表此次远程构建已成功。
LumaDock is a native Mac launcher built on nxnative, for Apple Silicon and macOS 26 or later.
- Guided setup: check the environment, choose a library, import your own
prod.keys, then add NSP games. - Automatic preparation with progress, cancellation, validated caches, and keyboard/mouse/controller configuration.
- Direct Mac runtime generation, a Liquid Glass interface, and Xcode / Metal component management.
- Tested titles: Breath of the Wild 1.9.0 (build and startup passed) and Super Mario Odyssey 1.4.1 (player gameplay test passed). These are limited test results, not full-game completion claims; see the README and validation record.
Download the ARM64 DMG and drag LumaDock into Applications. Packages use local ad-hoc signing and are not notarized. A full Xcode installation and the Metal compiler component are needed to prepare games.
No games, updates, DLC, firmware, keys, game artwork, or player caches are included. Import only content you are authorized to use. This project is not affiliated with Nintendo. Thanks to nxnative, MacNativeGames, d2r-mobile, and their contributors; third-party licenses and notices are preserved.
The release DMG and source archive are built and checked by GitHub Actions; verify them with SHA256SUMS.
璃游是基于 nxnative 的原生 Mac 游戏启动器,面向 Apple Silicon、macOS 26 及以上。先检查环境,再选择游戏库、导入玩家密钥及 NSP,支持自动准备、进度显示、缓存复用与键鼠/手柄映射。
历史记录中《旷野之息》1.9.0 构建及启动通过,《奥德赛》1.4.1 玩家游玩测试通过,均不代表全流程验证。《奥德赛》的较长游玩记录使用此前的 10b33338 引擎;更新固定引擎不会扩大这一证据范围。安装包采用本地 ad-hoc 签名,尚未公证;准备游戏需要完整 Xcode 与 Metal 编译组件。
项目不附带游戏、更新、DLC、固件、密钥或玩家缓存,与 Nintendo 没有隶属关系。感谢 nxnative 等上游项目及贡献者。安装包和源码包由 GitHub Actions 生成并校验,可用 SHA256SUMS 核对。
Reply on the forum
A question or a hands-on report? Open the discussion on the forum.