Repository navigation
Description
何が起きたか / What happened
macOS では、BepInEx 5.4.23.5 の macOS 版を入れても BepInEx が起動しません。BepInEx が起動してフレームワークが読み込まれるはずが、ゲームは Mod なしで起動します。BepInEx/LogOutput.log も BepInEx/config/ もできません。確かめたのは Apple Silicon の Mac です。
Doorstop を 4.6.0 の ci 版に替えて、ゲームを Rosetta(x86_64)で起動すると、BepInEx とフレームワークが動きます。翻訳 Mod と Steam オーバーレイ(Shift+Tab)も動きました。手順は下の「回避策」に、確かめた結果は「確認したこと」にまとめました。
再現の手順 / Steps to reproduce
- BepInEx_macos_universal_5.4.23.5.zip を、
DragNWash.appの隣(ゲームのフォルダー)に展開します。 - BepInEx の手順どおりに、
run_bepinex.shのexecutable_nameを"DragNWash.app"にして、chmod u+x run_bepinex.shで実行できるようにします。 - ゲームのフォルダーで
./run_bepinex.shを実行して、ゲームを起動します。 - ゲームは Mod なしで起動します。
BepInEx/LogOutput.logもBepInEx/config/もできません。
TomXV/dragnwash-localization の README(macOS の注意書き)にも、Apple M3 Pro / macOS 26.6 で、ネイティブでも Rosetta でも同じ結果になったと書かれています。
バージョン / Versions
ModFramework 1.5.0 / ゲームの macOS 版 9/12/2026_a93aa21a(Unity 6000.3.14f1)/ BepInEx 5.4.23.5 の macOS 版(中の Doorstop は 4.5.0)
環境 / Platform
macOS(macOS 27.2、Apple A18 Pro、メモリー 8 GB、Metal)
ほかに入れている Mod / Other mods installed
BepInEx そのものが起動しないので、ほかの Mod には関係しません。回避策を確かめたときは、フレームワーク 1.5.0(プラグイン 10 個)を入れていました。インストーラーを確かめたときは、翻訳 Mod(TomXV/dragnwash-localization)1.5.0 も日本語で入れていました。2026-09-26 の確認では、フレームワークのうち Tool window だけを、#86 を直したビルドに替えています。
ログ / Log
BepInEx が起動しないので、BepInEx/LogOutput.log はできません。回避策を入れると、LogOutput.log は Chainloader startup complete まで進みます。そのときターミナルに出る無害なメッセージは、下の「確認したこと」に書きました。
原因
原因は 3 つあります。
- BepInEx 5.4.23.5 に入っている Doorstop 4.5.0 が、Unity 6.3 にフックできない。
- Doorstop 4.5.0 は、
LC_DYLD_CHAINED_FIXUPSを使うUnityPlayer.dylibを読み違えて、dlsymにフックできません(macOS: Doorstop cannot hook Unity 6000.3 Mono games — chained-fixups header parses as all zeros NeighTools/UnityDoorstop#108)。 - このゲームの
UnityPlayer.dylibは、arm64 と x86_64 の両方がこの形式です。そのため、Rosetta で動かすだけでは直りません。 - 修正の osx: fix the chained-fixups reader so Unity 6.3 games hook NeighTools/UnityDoorstop#117 は、2026-09-24(UTC)に master へマージされました。macOS: Doorstop cannot hook Unity 6000.3 Mono games — chained-fixups header parses as all zeros NeighTools/UnityDoorstop#108 は開いたままです。
- 修正が入った Doorstop は、今のところ
ciタグのプレリリースだけです。版は 4.6.0 です。本家にはv4.6.0のタグ(master97293a28)がありますが、安定版のリリースはまだ出ていません(2026-09-26 時点)。
- Doorstop 4.5.0 は、
- BepInEx 5.4.23.5 は、arm64 のネイティブ実行では Harmony のパッチを当てられない。
- BepInEx 自身もプリローダーで Harmony を使うので、プラグインは 1 つも読み込まれません。
- 修正の v5: Fix plugin loading on native arm64 macOS BepInEx/BepInEx#1402 は v5-lts にマージ済みですが、リリースはまだです。この修正には、Doorstop 側の Apple Silicon - Add doorstop_jit_memcpy for MAP_JIT writes NeighTools/UnityDoorstop#114 も要ります。
- 当面は Rosetta(x86_64)で動かす必要があります。このゲームをネイティブの arm64 で動かすことは試していません(v5: Fix plugin loading on native arm64 macOS BepInEx/BepInEx#1402 の説明からの判断です)。
- 共通のインストーラーが macOS に対応していない。
Install.exeは Windows 用の BepInEx を入れます。install-steamdeck.shは Linux 用の BepInEx を入れます。bash 4 の機能(declare -Aとmapfile)を使うので、macOS 標準の bash 3.2 では最初のdeclare -Aで止まります。GNU 版にしかないsed -i(拡張子なし)とcp -Tにも頼っています。
Steam オーバーレイ(Doorstop 4.6.0 の ci 版で解決済み)
Doorstop 4.5.0 の ci 版の run.sh では、Steam の起動オプションから起動しても、Shift+Tab で Steam オーバーレイが開きませんでした。
- スクリプトを動かす
/bin/shは SIP で保護されています。そのため、Steam が渡すDYLD_INSERT_LIBRARIES(オーバーレイ)は、スクリプトに届く前に消されます。 - Steam は、同じ一覧(
steamloader.dylibとgameoverlayrenderer.dylib)をSTEAM_DYLD_INSERT_LIBRARIESでも渡します。 - これを引き継ぐ変更が、run.sh: keep the Steam overlay on macOS via STEAM_DYLD_INSERT_LIBRARIES NeighTools/UnityDoorstop#121 として 2026-09-25 にマージされ、4.6.0 の
ci版に入りました。
回避策(動作を確認済み)
公式の BepInEx 5.4.23.5 の macOS 版を使い、Doorstop の 2 つのファイルを 4.6.0 の ci 版に差し替えて、Rosetta で起動します。ゲームのファイル(DragNWash.app の中)は書き換えません。
TomXV/dragnwash-localization#53 で出している実験的なインストーラー(installer/experimental/install-macos.sh)は、この手順を自動で行います。TomXV/dragnwash-localization#53 は、まだマージされていません。このスクリプトは、リリースの zip には入れません。
-
BepInEx_macos_universal_5.4.23.5.zip(zip の SHA-256
01c2ae782eb016dfd6c345a18dbd2dcafffb3d9d318449d6486689f426b4a323)を、DragNWash.appの隣に展開します。 -
Doorstop 4.6.0 の
ci版の doorstop_macos_release_4.6.0.zip からuniversal/libdoorstop.dylibとuniversal/run.shを取り出して、libdoorstop.dylibとrun_bepinex.shを置き換えます。- 試したのは、2026-09-25 20:37 UTC に UnityDoorstop の master
97293a28から作られたビルドです。zip の SHA-256 はfa3c9e4638f82873620b7e7e12ce1730ce01cdc23a7ba3bac2e6bfa31c0e929d、universal/libdoorstop.dylibの SHA-256 は5f31b9fca678536ed1636206f47b77431ac5b972ff92a0a2badf84bc065f9562です。 - 本家の
ciプレリリースは、master に push されるたびに同じ URL のまま作り直されます。版が上がるとファイル名も変わり、前の zip はダウンロードできなくなります。前に試した 4.5.0 のci版の zip は、4.6.0 に替わったときに HTTP 404 になりました。 - そのため、試した zip を中身を変えずに、223n/UnityDoorstop の
ci-4.6.0-97293a28にプレリリースとして置きました。上のリンクはこちらを指しています。SHA-256 は本家の zip と同じで、タグは同じコミット97293a28を指します。 - インストーラーは、SHA-256 で中身を確かめます。本家の
ci版は作り直されるとハッシュが合わなくなるので、インストーラーもこのコピーから取ります。
- 試したのは、2026-09-25 20:37 UTC に UnityDoorstop の master
-
run_bepinex.shの 3 行を書き換えます。sed -i '' \ -e 's|^executable_name=""$|executable_name="DragNWash.app"|' \ -e 's|^archpreference="arm64,x86_64"$|archpreference="x86_64"|' \ -e 's|^target_assembly="Doorstop.dll"$|target_assembly="BepInEx/core/BepInEx.Preloader.dll"|' \ run_bepinex.sh
- どの式も、既定の値が入った行にだけ一致させています。
- 行番号は、4.6.0 の
run.shのものです。 ^target_assembly=.*のように書くと、291 行目のtarget_assembly="$(abs_path "$target_assembly")"まで書き換わります。そうなると、target_assemblyが相対パスのまま Doorstop に渡り、Doorstop はそれを今いるフォルダーから探します。ゲームのフォルダー以外から起動すると、何も知らせずに Mod なしで起動します。- 環境変数
ARCHPREFERENCEを設定しても効きません。スクリプトが 338 行目でarchpreferenceの値をARCHPREFERENCEに入れ直してexportするためです。 arch -x86_64 /bin/bash run_bepinex.shで起動しても、x86_64 にはなりません。スクリプトは最後に必ずarchを通してゲームを起動し、既定のarm64,x86_64では arm64 が選ばれるためです。BepInEx 5.4.23.5 に入っているrun_bepinex.shも同じです。- インストーラーは、
executable_nameにDragNWash.appのフルパスを入れます。ゲームのフォルダー以外から起動しても動くようにするためです。
-
実行できるようにして、ダウンロードしたファイルから
com.apple.quarantineを外します。chmod u+x run_bepinex.sh xattr -dr com.apple.quarantine run_bepinex.sh libdoorstop.dylib BepInEx
-
フレームワークのリリースの zip から、
BepInEx/だけをゲームのBepInEx/に重ねます。 -
Steam のライブラリで Drag'n Wash のプロパティを開き、「起動オプション」に次のように入れて、ふだんどおり「プレイ」で起動します。
"<ゲームのフォルダーの絶対パス>/run_bepinex.sh" %command%- パスにアポストロフィ(
Drag'n Wash)が入っていても、そのまま動きました。 - ゲームのフォルダーに移ってから、ターミナルで
./run_bepinex.shを実行して起動することもできます。ただし、Steam API が使えず、セーブも見えません(下の「Steam から起動したとき」)。確かめるときだけにとどめます。
- パスにアポストロフィ(
4.5.0 の ci 版(master d8973b22)の run.sh を使っている場合は、Steam オーバーレイが開きません。その run_bepinex.sh の中で DYLD_INSERT_LIBRARIES を組み立てる部分(if [ -z "$DYLD_INSERT_LIBRARIES" ]; then から始まる 5 行)を、次のように直すと開きます。NeighTools/UnityDoorstop#121 と同じ中身です。直さなくても Mod は動きます。
inherited_libraries="${DYLD_INSERT_LIBRARIES:-${STEAM_DYLD_INSERT_LIBRARIES}}"
if [ -z "$inherited_libraries" ]; then
dyld_insert_libraries="${doorstop_name}"
else
dyld_insert_libraries="${doorstop_name}:${inherited_libraries}"
fi元に戻すときは、Steam の起動オプションを空にして、BepInEx/、run_bepinex.sh、libdoorstop.dylib、.doorstop_version、changelog.txt をどけます。起動に失敗したときは DragNWash.app/Contents/MacOS/ に preloader_*.log ができるので、それも消します。
確認したこと
試した環境です。
| 項目 | 内容 |
|---|---|
| Mac | Apple A18 Pro、メモリー 8 GB、macOS 27.2 |
| ゲーム | macOS 版 9/12/2026_a93aa21a(Unity 6000.3.14f1、Metal)。ビルド番号は Windows 版と同じです |
| BepInEx | 5.4.23.5 の macOS 版 |
| Doorstop | 2026-09-25 までは 4.5.0 の ci 版(master d8973b22、zip の SHA-256 025296d7339c72cce3020d46efd91823802ad06feb18706dd738f90bc762d649。もうダウンロードできません)。2026-09-26 からは 4.6.0 の ci 版(master 97293a28) |
| フレームワーク | 1.5.0 |
Doorstop 4.5.0 の ci 版で確認
| 項目 | 結果 |
|---|---|
| 実行 | vmmap の Code Type: X86-64 (translated)(Rosetta) |
| BepInEx | Chainloader startup complete |
| フレームワーク | プラグイン 10 個が警告なしで読み込まれ、タイトル画面に「10 mods loaded」と出る |
タイトル画面の右下に、フレームワークのバージョン、読み込まれた Mod の数、ゲームのビルド番号が出ています。
Mods 画面も開けます。
- osx: fix the chained-fixups reader so Unity 6.3 games hook NeighTools/UnityDoorstop#117 の作者は arm64 でしか試していません。今回は、x86_64(Rosetta)のスライスでもこのゲームにフックできました。
- Harmony のパッチが当たりました(
[cursor] Patched 3 GameStateManager method(s))。 - Mods 画面、更新の確認、セーブのスナップショットが動きました。
- F1 のウィンドウ(Tool window 1.5.0)には、文字が出ませんでした。これは macOS で F1 のウィンドウ(Tool window)に文字が出ない(Hiragino Sans を TextCore が読めない) #86 で扱います。修正の Tool window: draw text on macOS, and show characters Unity's text engine cannot draw as "?" #84 は 2026-09-26 にマージされましたが、リリースはまだです。
- ターミナルには、
cant resolve internal call to "UnityEngine.UnityLogWriter::WriteStringToUnityLogImpl"と…::WriteStringToUnityLog"が 2 回ずつ出ます。それぞれのあとにYour mono runtime and class libraries are out of sync.という説明が続きます。Unity 6 に、BepInEx が探す内部関数がないだけです。無害で、ログは正しく書かれます。 - ゲームの macOS 版の
Assembly-CSharp.dllは、Windows 版や Linux 版とハッシュが違います(ci/game-fingerprints.jsonにありません)。ただし、フレームワークが使う型やメンバーは、すべてありました。
Steam から起動したとき(2026-09-25、Doorstop 4.5.0 の ci 版)
Steam の起動オプションから起動したときと、ターミナルから起動したときの違いです。
| 項目 | ターミナルから起動 | Steam の「プレイ」から起動 |
|---|---|---|
| Mod(BepInEx とフレームワーク) | 動く | 動く |
| 実行 | Rosetta(x86_64) | Rosetta(x86_64) |
環境変数 SteamAppId |
なし | 4739660 |
| Steam API | SteamAPI_Init() failed. |
初期化される |
| セーブ(Continue と Load Game) | 出ない | 出る |
| Steam オーバーレイ | ― | run.sh を直すと開く(「回避策」の最後) |
- ゲームは起動のたびに、
steam_appid.txtをDragNWash.app/の中に書きます(Player.logのWrote steam_appid.txt at:)。ターミナルから起動すると Steam API が使えないのは、Steam API がこのファイルを今いるフォルダー(ゲームのフォルダー)から探すためだと見ています。Steam から起動したときは、Steam がSteamAppIdを渡すので問題になりません。 - 試した Mac には、Steam Cloud から来たセーブ(
~/Library/Application Support/Gator Dragon Games/DragNWash/<Steam ID>/slot1/)があります。ターミナルから起動したときは、タイトル画面に Continue と Load Game が出ませんでした。Steam API が使えないので、<Steam ID>のフォルダーを探せないためだと見ています。 run.shを直す前は、gameoverlayrenderer.dylibはあとから読み込まれていましたが、Shift+Tab を押してもオーバーレイは開きませんでした。直したあとは、起動の時点から読み込まれ、オーバーレイが開きました。
起動直後の固まり方を、フレームワークが記録する起動時間で比べました。「最初のフレームまで」は、最初のシーンを読み込んでから次のフレームまでの時間です。「100 ms を超えたフレーム」は、シーンを読み込んでから 10 秒間の数です。
| 起動 | 最初のフレームまで | 100 ms を超えたフレーム |
|---|---|---|
run.sh を直す前(オーバーレイは開かない) |
2.8 秒 | 193 フレーム中 5 |
| 直したあと、1 回目 | 17.8 秒 | 1 フレーム中 1 |
| 直したあと、2 回目 | 3.8 秒 | 166 フレーム中 5 |
- 直したあとの 1 回目だけ、タイトル画面が出る前に 15 秒ほど止まりました。止まり始めたのは、Steam のログでオーバーレイの画面(
gameoverlayui)が起動した直後でした。 - Rosetta がオーバーレイのライブラリを変換して保存するキャッシュ(
gameoverlayrenderer.dylib.aot)は、この起動の 2 秒後に作られていました。止まったのはシーンを読み込んだあと(起動から 28 秒ほどあと)で、シーンを読み込むまでの時間は 2 回目と同じでした。そのため、この変換だけでは説明できません。 - その後の起動で、ゲームのウィンドウが前面にない(アクティブでない)ときに、タイトル画面の前で止まったように見えることがありました。ウィンドウをアクティブにしておくと、なめらかに起動しました。この 15 秒も、それだった可能性がありますが、確かめてはいません。
- 2 回目も起動直後に少し固まりましたが、直す前と同じ程度でした。試した Mac はメモリーが 8 GB で(ゲームの最低要件も 8 GB)、ゲームを Rosetta で動かしているので、その分の重さだと見ています。最初のフレームまでの時間は、直す前より 1 秒ほど長いだけでした(1 回ずつの比較です)。
Doorstop 4.6.0 の ci 版で確認(2026-09-26)
run.sh のオーバーレイの部分には手を加えず、4.6.0 の run.sh に「回避策」の手順 3 の 3 行だけを入れて、Steam の「プレイ」から起動しました。
| 項目 | 結果 |
|---|---|
| Doorstop | 4.6.0(master 97293a28 の ci 版) |
| 実行 | vmmap の Code Type: X86-64 (translated)(Rosetta) |
DYLD_INSERT_LIBRARIES |
libdoorstop.dylib に続けて、Steam の steamloader.dylib と gameoverlayrenderer.dylib |
| Steam オーバーレイ | Steam のログに GameOverlay: started … gameoverlayui が出て、Shift+Tab で開いた |
| BepInEx とフレームワーク | Chainloader startup complete。タイトル画面に「10 mods loaded」 |
| F1 のウィンドウ | Tool window を直したビルドで、文字が出る(Window font: Arial Unicode MS + Apple Symbols。#86) |
| 最初のフレームまで | 2.4 秒(100 ms を超えたフレームは 311 フレーム中 2) |
インストーラーで確認(2026-09-26、TomXV/dragnwash-localization#53)
TomXV/dragnwash-localization#53 の installer/experimental/install-macos.sh を、コミットする前の版で 1 回実行しました。実行したのは、上の 4.6.0 の ci 版の環境(手作業で入れたもの)の上からです。コミットしたのはそのあとです。Doorstop の取得元は、さらにあとのコミットで替えています。
翻訳 Mod は、1.5.0 のリリースの zip を使いました。フレームワークは 1.5.0 で、Tool window だけを #84 のビルドに替えています。インストールのあと、Steam の「プレイ」から起動しました。
| 項目 | 結果 |
|---|---|
| ダウンロード | なし。BepInEx、Doorstop、ModFramework 1.5.0 は、入っているものをそのまま使った(libdoorstop.dylib は、スクリプトが固定しているものとバイト単位で同じ。4.5.0 と 4.6.0 の ci 版の libdoorstop.dylib は同じバイト列) |
run_bepinex.sh |
executable_name をフルパスにするため書き直した(元のファイルは run_bepinex.sh.dragnwash-backup に残る)。オーバーレイの引き継ぎはすでにあるので、そのまま |
| 起動オプション | Steam を終了させてから設定し、Steam を起動し直した |
| 翻訳 | 日本語で表示された(1773 項目。日本語の 868 字をゲームのフォントに追加) |
| Steam オーバーレイ | Shift+Tab で開いた |
| F1 のウィンドウ | 文字と Inspector のツールバーのアイコンが出た。ウィンドウのフォントは、Hiragino Sans を飛ばして Arial Unicode MS + Apple Symbols になった(詳しくは #86) |
- コミットした版は、サンドボックス(偽の HOME と Steam のフォルダー、偽の curl、
/bin/bash3.2)で 235 件のテストを通りました。 - 同じサンドボックスで、本物の BepInEx、Doorstop のコピー、ModFramework の zip をダウンロードする新規インストールも行いました。どれも SHA-256 の確認を通って、最後まで終わりました。
- 試していないこと: 実際のゲームへの、何も入っていない状態からのインストール。コミットした版の実機での実行。実機でのアンインストールと「動作確認」(
--check)。Apple Silicon 以外の Mac。
残っている課題
- 安定版の Doorstop 4.6.0 は、まだ出ていません(2026-09-26 時点)。出たら、macOS installer (experimental): install the workaround that runs the mod on macOS dragnwash-localization#53 のインストーラーは、試してから、コピーではなく安定版の zip を固定し直します。
- Rosetta が全面的に使えるのは macOS 27 までです。長く使うには、ネイティブの arm64 で動かす必要があります。Doorstop 側の修正(Apple Silicon - Add doorstop_jit_memcpy for MAP_JIT writes NeighTools/UnityDoorstop#114 と osx: fix the chained-fixups reader so Unity 6.3 games hook NeighTools/UnityDoorstop#117)は、どちらも 4.6.0 の
ci版に入っています。あとは、BepInEx の修正(v5: Fix crash on macOS arm64: wrap XTermFix and ConsoleSetOutFix in Utility.TryDo BepInEx/BepInEx#1288 と v5: Fix plugin loading on native arm64 macOS BepInEx/BepInEx#1402)が入った安定版を待ちます。ネイティブの arm64 で動くかは、まだ試していません。 - 起動中にゲームのウィンドウが前面にないと、タイトル画面の前で止まったように見えることがあります。macOS installer (experimental): install the workaround that runs the mod on macOS dragnwash-localization#53 では、インストーラーの完了時のメッセージと README に「ウィンドウをクリックすると進む」と書いています。原因は確かめていません。
run_bepinex.shがゲームを直接起動するので、macOS がウィンドウを前面に出していないのかもしれません。 - メモリーに余裕のある Mac では試していません。起動直後に少し固まるのが、試した Mac だけのことなのかは分かっていません。
- フレームワークのドキュメントなどを直す必要があります。
docs/ROADMAP.mdの「Waiting on others」とdocs/DESIGN.mdの「Non-goals (for now)」は、macOS: Doorstop cannot hook Unity 6000.3 Mono games — chained-fixups header parses as all zeros NeighTools/UnityDoorstop#108 だけを理由にしています。日本語版のdocs/ROADMAP.ja.md「ほかの動きを待っているもの」とdocs/DESIGN.ja.md「今はやらないこと」も同じです。docs/GAME_BUILDS.mdに、macOS 版の行がありません。ci/game-fingerprints.jsonに、macOS 版のビルドがありません。DragNWash.appの中でtools/game-fingerprints.pyが数える 274 ファイルのうち、Assembly-CSharp.dllを含む 187 ファイルのハッシュがありません。tools/game-fingerprints.pyはlibdoorstop.dylibを除外していないので、macOS で使う前に直す必要があります。
関連
- macOS: Doorstop cannot hook Unity 6000.3 Mono games — chained-fixups header parses as all zeros NeighTools/UnityDoorstop#108: Doorstop が Unity 6.3 にフックできない(開いたまま)
- osx: fix the chained-fixups reader so Unity 6.3 games hook NeighTools/UnityDoorstop#117: その修正(2026-09-24 にマージ)
- run.sh: keep the Steam overlay on macOS via STEAM_DYLD_INSERT_LIBRARIES NeighTools/UnityDoorstop#121: Steam オーバーレイの引き継ぎ(2026-09-25 にマージ)
- Apple Silicon - Add doorstop_jit_memcpy for MAP_JIT writes NeighTools/UnityDoorstop#114、v5: Fix crash on macOS arm64: wrap XTermFix and ConsoleSetOutFix in Utility.TryDo BepInEx/BepInEx#1288、v5: Fix plugin loading on native arm64 macOS BepInEx/BepInEx#1402: ネイティブの arm64 で動かすための修正
- macOS installer (experimental): install the workaround that runs the mod on macOS dragnwash-localization#53: 回避策を入れる、実験的な macOS 用インストーラー
- macOS で F1 のウィンドウ(Tool window)に文字が出ない(Hiragino Sans を TextCore が読めない) #86: macOS で F1 のウィンドウに文字が出ない件(修正の Tool window: draw text on macOS, and show characters Unity's text engine cannot draw as "?" #84 は 2026-09-26 にマージ、リリースはまだ)
- https://github.com/223n/UnityDoorstop/releases/tag/ci-4.6.0-97293a28: 試した Doorstop 4.6.0 の
ci版のコピー
クレジット表記 / Credit
希望します。表記は @223n でお願いします。
Activity
macOS installer: point to the upstream issue for the macOS setup
Roadmap and design memo: macOS runs through the experimental install …
Game fingerprints for the macOS build, and a macOS row in GAME_BUILDS