From 2b270ff76e07b7a8ddabf2b41cc69dab85719345 Mon Sep 17 00:00:00 2001 From: jhaizhou <258432107+jhaizhou-ops@users.noreply.github.com> Date: Tue, 13 Oct 2026 18:15:23 +0800 Subject: [PATCH] Docs: the Mac version requires macOS 26 or later (the graphics layer is built on Metal 4); setup.sh notes it on older systems --- README.md | 2 +- README.zh-CN.md | 2 +- docs/MAC.md | 6 +++++- docs/MAC.zh-CN.md | 6 +++++- setup.sh | 3 +++ 5 files changed, 15 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index ad06bef..0d1ad03 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ This is not a tech demo that "sort of runs". It is a mobile version polished for daily play, from your first character all the way through the endgame. -Platforms: iPhone / iPad (iOS 26 and later) · Mac (Apple silicon, macOS 13 and later, first version) · Game version: Switch release with Reign of the Warlock, 1.0.34.0 (corresponds to PC version 3.3.94012) · English / 中文 · License: MIT · **Bring your own game files** +Platforms: iPhone / iPad (iOS 26 and later) · Mac (Apple silicon, macOS 26 or later, first version) · Game version: Switch release with Reign of the Warlock, 1.0.34.0 (corresponds to PC version 3.3.94012) · English / 中文 · License: MIT · **Bring your own game files** 中文: [README.zh-CN.md](README.zh-CN.md) diff --git a/README.zh-CN.md b/README.zh-CN.md index 2bca20c..0ef3122 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -4,7 +4,7 @@ 这不是一个「勉强能跑」的技术演示,而是一个打磨到可以天天玩、从开荒一路玩到终局的移动版。 -平台:iPhone / iPad(iOS 26 起)· Mac(Apple 芯片,macOS 13 起,第一版)· 游戏版本:Switch 版「术士君临」1.0.34.0(对应 PC 版 3.3.94012)· 中文 / English · 许可证:MIT · **需要自备游戏文件** +平台:iPhone / iPad(iOS 26 起)· Mac(Apple 芯片,macOS 26 及以上,第一版)· 游戏版本:Switch 版「术士君临」1.0.34.0(对应 PC 版 3.3.94012)· 中文 / English · 许可证:MIT · **需要自备游戏文件** English: [README.md](README.md) diff --git a/docs/MAC.md b/docs/MAC.md index f7a77f9..1a3e268 100644 --- a/docs/MAC.md +++ b/docs/MAC.md @@ -2,10 +2,14 @@ 中文:[MAC.zh-CN.md](MAC.zh-CN.md) -On an Apple silicon Mac this project can be built into a native macOS App, `D2R Mobile.app`: double-click to start, with keyboard, mouse and gamepad all working. It runs the same game and the same features we added (rifts, the trove, the chronicle, the Custom page and so on), using the original game's gamepad UI. +On an Apple silicon Mac running **macOS 26 or later**, this project can be built into a native macOS App, `D2R Mobile.app`: double-click to start, with keyboard, mouse and gamepad all working. It runs the same game and the same features we added (rifts, the trove, the chronicle, the Custom page and so on), using the original game's gamepad UI. **Up front: nobody has actually sat down and played this version yet.** Keyboard keys, a physical gamepad, the resource-folder dialog, ⌘Q and menu clicks, and how it feels in the hand — none of these five has been operated by a person. Everything described as "verified" below was run unattended: keys injected by a test script, the mouse through a test entry point, quit / full screen / window resizing through test switches. If you are among the first to try it, please open an issue and tell us how it went. +## Requirements + +Apple silicon and macOS 26 or later. The graphics side is built entirely on a graphics interface that only exists from macOS 26 on (Metal 4); on earlier systems it neither compiles nor opens (the system says the App cannot be used with this version of macOS). The iPhone / iPad version requires iOS 26 for the same reason. + ## Build The prerequisites are the same as for the iOS route: your game files in place and `./setup.sh` finished (see "Getting started" on the front page). Then: diff --git a/docs/MAC.zh-CN.md b/docs/MAC.zh-CN.md index b38a853..a1a4aee 100644 --- a/docs/MAC.zh-CN.md +++ b/docs/MAC.zh-CN.md @@ -2,10 +2,14 @@ English: [MAC.md](MAC.md) -Apple 芯片的 Mac 可以把本项目构建成一个原生的 macOS App:`D2R Mobile.app`,双击启动,键盘、鼠标、手柄都能用。它跑的是同一份游戏、同一套我们加的功能(秘境、珍宝匣、编年史、自定义页等),界面用的是原版的手柄版界面。 +Apple 芯片的 Mac(**macOS 26 及以上**)可以把本项目构建成一个原生的 macOS App:`D2R Mobile.app`,双击启动,键盘、鼠标、手柄都能用。它跑的是同一份游戏、同一套我们加的功能(秘境、珍宝匣、编年史、自定义页等),界面用的是原版的手柄版界面。 **先说在前面:这一版还没有人真的坐下来玩过。**键盘按键、实体手柄、选资源文件夹的对话框、⌘Q 与菜单点击、真人手感——这五项都没有人实际操作过。下面写「验过」的,都是无人值守跑出来的:按键用测试脚本注入,鼠标用测试入口注入,退出、全屏、改窗口大小用测试开关。欢迎第一批试用的人把结果开 Issue 告诉我们。 +## 系统要求 + +Apple 芯片,macOS 26 及以上。图形部分整个建在 macOS 26 才有的图形接口(Metal 4)上,更早的系统上编不过、也打不开(系统会提示这个 App 不能与当前版本的 macOS 配合使用)。iPhone / iPad 版要求 iOS 26 是同一个原因。 + ## 构建 前提与 iOS 那条路相同:游戏文件放到位,`./setup.sh` 跑完(见首页「开始使用」)。然后: diff --git a/setup.sh b/setup.sh index 2636ee7..c1885e5 100755 --- a/setup.sh +++ b/setup.sh @@ -38,6 +38,9 @@ say "$(m "一、这台电脑" "1. This computer")" OSV=$(/usr/libexec/PlistBuddy -c "Print ProductVersion" /System/Library/CoreServices/SystemVersion.plist 2> /dev/null) if [ "$(uname -s)" = Darwin ] && [ "$(uname -m)" = arm64 ]; then ok "$(m "Apple 芯片的 Mac,macOS $OSV" "Apple silicon Mac, macOS $OSV")" else bad "$(m "需要 Apple 芯片的 Mac(这台是 $(uname -s) $(uname -m))" "An Apple silicon Mac is required (this is $(uname -s) $(uname -m))")" "$(m "换一台 Apple 芯片的 Mac 再来" "Use an Apple silicon Mac")"; fi +# 图形层整个建在 macOS 26 / iOS 26 才有的图形接口(Metal 4)上:macOS 低于 26 时,在这台 Mac 上运行的那几样(Mac App、宿主、图形层单测、Mac 冒烟)编不过也跑不了 +# The graphics layer is built entirely on a graphics interface that exists only from macOS 26 / iOS 26 on (Metal 4): below macOS 26, the things that run on this Mac (the Mac App, the host, the graphics unit tests, the Mac smoke run) neither build nor run +case "${OSV%%.*}" in ''|*[!0-9]*) ;; *) [ "${OSV%%.*}" -ge 26 ] || note "$(m "这台 Mac 是 macOS ${OSV}:低于 26。Mac App(dm/tools/mac_app.sh)、宿主与图形层单测、Mac 冒烟需要 macOS 26 及以上(用到了 macOS 26 才有的图形接口)" "This Mac runs macOS ${OSV}, below 26. The Mac App (dm/tools/mac_app.sh), the host and graphics unit tests and the Mac smoke run need macOS 26 or later (they use a graphics interface that exists only from macOS 26 on)")";; esac DK=$DM_ROOT; while [ ! -d "$DK" ] && [ "$DK" != / ]; do DK=$(dirname "$DK"); done; FREE=$(df -g "$DK" 2> /dev/null | awk 'NR==2 {print $4}'); WANT=30; [ -d "$GAME" ] && WANT=15 if [ -n "$FREE" ] && [ "$FREE" -ge "$WANT" ]; then ok "$(m "磁盘剩余 $FREE GB(至少要 $WANT GB)" "$FREE GB free disk space (at least $WANT GB needed)")" else bad "$(m "磁盘剩余 ${FREE:-?} GB,不够:工作区要约 12 GB,解游戏包另要约 20 GB" "Only ${FREE:-?} GB free: the workspace needs about 12 GB, extracting the game package about 20 GB more")" "$(m "腾出空间,或用 DM_ROOT=<别的盘上的目录> 换位置" "Free up space, or point DM_ROOT= elsewhere")"; fi