Repo ↗ · 原始 README ↗ · 文件包（Markdown／授權）

封面參考（原作）： The Legend of Zelda: Majora’s Mask · 原作宣傳圖，由 IGDB 提供。圖片版權屬原權利人，供辨識原作使用，不代表此重寫／模組專案的實際畫面。

來源維護者： icyyyy0000 · 版本： 8da0ae49b85b · 整理日期： 2026-10-12

文件授權： CC0-1.0 · LICENSE · 本文形式： README 翻譯

下文為來源 README 的繁中翻譯，由 Kirikirin 使用 AI 輔助整理；功能、完成度與測試結果均為原作者描述，本站未逐項實機驗證。圖片改為來源連結，指令與技術識別保留原文。

你需要安裝 MAJORA’S MASK RECOMPILED，並在 STEAM 上擁有 SONIC ADVENTURE DX，此模組才能運作

Termina Adventure

以索尼克、塔爾斯、納克魯斯、艾咪、大貓或 E-102 伽瑪遊玩 Majora’s Mask: Recompiled，並在需要薩爾達道具、面具或進度機制時隨時切換回林克。

目前版本：0.1.22 · Windows · 實驗性

Termina Adventure 使用 Sonic Adventure DX 的伴隨模組。兩款遊戲同時運行：伴隨模組對抗從 Majora’s Mask 串流而來的碰撞資料，執行原始 SADX 角色任務，然後將移動和動畫狀態傳回薩爾達，並在該處渲染角色模型。此方法靈感來自 SkyCraft。

功能

  • 六名可遊玩的 Sonic Adventure 角色，包含其原始模型、動畫動作和角色音效。
  • 索尼克對合格敵人的動量、旋轉衝刺、追蹤攻擊和追蹤連鎖。
  • 塔爾斯的飛行和尾巴旋轉；納克魯斯的滑翔、攀爬和拳擊；艾咪的錘子攻擊和奔跑錘跳。
  • 大貓的新能力：面向方向抓取、空中踩踏，以及可選的原始釣竿揮動。釣魚無法運作。
  • 伽瑪的射擊和懸浮，可調整懸浮速度和射擊速率。
  • 每個角色在 L 鍵的站立表情動作。
  • 角色跟隨攝影機，可調整回應、精簡控制提示，以及單螢幕設定選單。
  • 從任何林克面具形態切換，並返回底層形態。

不包含超級索尼克、蛋頭博士或蒂卡爾。

需求

  • Zelda 64: Recompiled，使用你自己支援的 ROM 設定 Majora’s Mask。模組資訊清單需要 Recompiled 1.2.2 或更新版本；尚未測試與每個更新版本的相容性。
  • Sonic Adventure DX for PC，透過 SAModManager 設定 SADX Mod Loader。開發時使用轉換為模組載入器的 Steam 安裝版本。
  • MainMemory’s Character Select Mod，在 SADX 中安裝並啟用。
  • 兩款遊戲同時運行，並允許 SADX 在其視窗非活躍時更新。

匯出檔包含兩個薩爾達模組、原生橋接 DLL、SADX 伴隨模組、建議設定、啟動器及原始碼。不包含遊戲、ROM、存檔、模組載入器或 Character Select Mod。

安裝

替換檔案前請關閉兩款遊戲。備份任何現有模組檔案和設定。

  1. 將匯出檔 Zelda64Recompiled/mods/ 資料夾中的所有四個檔案複製到 Zelda Recompiled 的模組目錄：

    termina_adventure-0.1.22.nrm
termina_adventure_bridge-0.1.22.nrm
termina_bridge.dll
termina-adventure-settings.ini

  2. 移除舊版的這兩個 Termina Adventure .nrm 檔案，不要動到無關的模組。在薩爾達的模組選單中啟用兩個提供的模組。將 Original SADX physics、SADX character models 和 Character HUD 設為開啟，並將 Starting character 設為林克。

  3. 將匯出檔的 SADX/mods/TerminaAdventureBridge/ 資料夾複製到 SADX 的 mods/ 目錄。

  4. 在 SAModManager 中，啟用 Termina Adventure SADX Companion 和 Character Select Mod。將伴隨模組置於載入順序中 Character Select Mod 之前，然後儲存/套用設定檔。

  5. 停用 SADX 的 Pause on inactive window 設定。保持其音效音量可聽見；伴隨模組會另行靜音關卡音樂。

  6. 將 Launch SADX Companion.cmd 複製到 sonic.exe 旁，並將 Launch Termina Adventure.cmd 複製到 Zelda64Recompiled.exe 旁。先啟動 SADX 伴隨模組，再啟動薩爾達。遊玩時保持兩者運行。

若為可攜式薩爾達安裝，模組目錄是 Zelda64Recompiled.exe 旁的 mods/ 資料夾。其他安裝請使用遊戲的模組資料夾位置。

現有設定可能覆寫預設值。複製提供的 INI 會將模組的已儲存設定替換為以下預設值；若想保留舊 INI，請先備份。

控制

按鈕名稱指的是在 Zelda Recompiled 中映射的 N64 控制，而非鍵盤按鍵或你實體控制器上印的標籤。

輸入 動作
Z + D-pad 左 / 右 切換角色
Z + D-pad 上 返回林克
Z + D-pad 下 開啟或關閉設定
Z + D-pad 下 備用設定快捷鍵
站立不動時按 L 角色表情動作

在設定中，D-pad 上/下選擇選項，左/右調整選項，B 或 Start 儲存並關閉。

角色 能力
索尼克 A 跳躍。在空中放開再按 A 以追蹤合格敵人；彈跳後放開/再按以連鎖。在地面按住 B 蓄力旋轉衝刺，然後放開以發射。
塔爾斯 A 跳躍。放開 A，然後在空中再按 A 並按住以飛行。放開以下降。B 執行尾巴旋轉。按住初始跳躍不會開始飛行。
納克魯斯 A 跳躍；按住 A 以滑翔或在表面附近附著。使用搖桿攀爬。放開 A 或按 B 以落下。非攀爬時按 B 拳擊。
艾咪 A 跳躍。B 使用錘子；按住 B 進行旋轉錘攻擊。累積奔跑速度並按 B 進行錘跳。
大貓 A 跳躍。在地面，B 朝大貓面向方向抓取。在空中，輕按/放開 B 抓取，或按住 B 約 0.25 秒以踩踏。A 或重新按 B 取消拉近。停用 Big new mechanics 以使用 B 的原始釣竿揮動。
E-102 伽瑪 A 跳躍；保持按住 A 以在下降時懸浮。放開以正常落下。B 發射薩爾達端射擊；Z 鎖定瞄準選定敵人。
林克 正常薩爾達控制、道具、面具和進度動作。

移動或按 A/B/L 時表情動作會取消。林克保留其正常的 L 行為。

預設設定

設定 預設值
起始角色 林克
Original SADX physics / character models 開啟
角色速度 / 重力 100% / 100%
攝影機跟隨速度 25%
攝影機平滑 開啟
控制提示 開啟
Character HUD 開啟，切換後短暫顯示
角色音效 開啟
SADX 關卡音樂 靜音
納克魯斯攀爬任何表面 開啟
大貓新機制 開啟
大貓抓取範圍 / 速度 正常 / 正常
伽瑪懸浮速度 100%
伽瑪射擊速度 正常
艾咪錘跳高度 100%

角色速度和重力可從 25% 到 300% 以 25% 增量調整。伽瑪的水平懸浮速度最高可達 500%。伽瑪射擊速度和大貓抓取速度各有五個具名選項：最慢、慢、正常、快、最快。大貓抓取範圍使用 最短、短、正常、長、最長。

匯出檔的預設值同時設定於提供的 INI 及其編譯核心模組中。偏好設定儲存至 termina_bridge.dll 旁的 termina-adventure-settings.ini。

橋接運作方式

Majora's Mask: Recompiled                 Sonic Adventure DX
  Input + scene collision  ----------->    Companion character task
  Render model + apply pose <-----------    Movement + animation state

薩爾達端提供輸入、附近作者定義地形和遊戲狀態。SADX 端暫時對抗該鏡像地形執行其角色任務，並透過共享記憶體傳回其位置、速度和動畫狀態。薩爾達渲染提取的角色模型，並處理宿主遊戲傷害和進度整合。

地形觀察器和碰撞行為保留 0.1.18 基準。伴隨模組也包含後續的塔爾斯輸入和動畫修正；其 DLL 與 0.1.18 並非位元組完全相同。

從原始碼建置

匯出檔的 Source/ 目錄包含專案程式碼、生成的模型/動畫程式碼、薩爾達參考標頭檔和符號，以及 SADX SDK 標頭檔。生成的資源已存在，因此該原始碼匯出檔不需要重新提取。

使用 Python 3、LLVM 18.1.8、Zig 0.13.0 和 RecompModTool。從包含 mod.toml 的目錄執行以下命令，將工具路徑替換為你的安裝路徑：

python tools/build.py --llvm "C:\tools\llvm18\bin" --mod-tool "C:\tools\RecompModTool.exe"
python tools/build.py --bridge --llvm "C:\tools\llvm18\bin" --mod-tool "C:\tools\RecompModTool.exe"
python tools/build_native.py --zig "C:\tools\zig-0.13.0\zig.exe" --sdk "dependencies/SADXModLoader/include"

這些會在 build/ 中產生兩個 .nrm 檔案，並在 build/native/ 中產生原生 DLL。編譯器二進位檔是重新建置的獨立先決條件；遊玩預先建置的模組不需要它們。

儲存庫簽出可能需要初始化其參考依賴項，並從本機 SADX 安裝生成其模型程式碼。匯出檔包含那些原始碼輸入。歷史測試和安裝腳本可能引用開發工作站或較舊的發行封存檔；使用前請調整那些路徑。

**此版本請勿使用 --restore-018-companion 建置：**該選項適用於較早的版本，且不包含後續的塔爾斯變更。

已知限制

這是實驗性整合。複雜表面、移動平台、水和某些攝影機角度上的碰撞仍需遊戲測試。大貓的釣竿和抓取線是程序生成的，且未實作完整釣魚機制。

角色攻擊與薩爾達的敵人傷害處理整合，但並非每個敵人或多頭目互動都已驗證。護盾、免疫、弱點和進度需求仍然適用。例如，使用林克和火焰箭解凍 Goht，然後再切換角色。

使用林克進行道具、面具和進度動作。兩款遊戲都必須保持運行。測試涵蓋橋接行為和受控原生移動，包括塔爾斯的第二次按鍵飛行和旋翼進度；它們不建立完整的遊戲對等性或視覺驗證薩爾達中的每個動畫。

致謝和原始碼聲明

專案程式碼隨附其 LICENSE。第三方程式碼、遊戲模型、動畫、音訊和其他資源保留其各自的所有權；專案授權不授予那些資源的權利。原始碼匯出檔包含生成的遊戲資源，因此將整個匯出檔發布到 GitHub 前請審查內容。將 ROM、遊戲執行檔、存檔和個人設定排除在儲存庫之外。

AI 免責聲明 - 此模組顯然是 AI 產物，且幾乎完全使用 CHATGPT AGENT MODE 製作，僅在你接受此點的情況下下載

授權與來源聲明

原始 README 與翻譯沿用 CC0-1.0 授權；本次修改為繁中翻譯、連結與排版調整。可修改的 Markdown、原始 README、LICENSE 與 NOTICE 收錄於頂部文件包。原作遊戲內容與商標不因此獲得授權。

LICENSE

Creative Commons Legal Code

CC0 1.0 Universal

    CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE
    LEGAL SERVICES. DISTRIBUTION OF THIS DOCUMENT DOES NOT CREATE AN
    ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS
    INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES
    REGARDING THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS
    PROVIDED HEREUNDER, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM
    THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS PROVIDED
    HEREUNDER.

Statement of Purpose

The laws of most jurisdictions throughout the world automatically confer
exclusive Copyright and Related Rights (defined below) upon the creator
and subsequent owner(s) (each and all, an "owner") of an original work of
authorship and/or a database (each, a "Work").

Certain owners wish to permanently relinquish those rights to a Work for
the purpose of contributing to a commons of creative, cultural and
scientific works ("Commons") that the public can reliably and without fear
of later claims of infringement build upon, modify, incorporate in other
works, reuse and redistribute as freely as possible in any form whatsoever
and for any purposes, including without limitation commercial purposes.
These owners may contribute to the Commons to promote the ideal of a free
culture and the further production of creative, cultural and scientific
works, or to gain reputation or greater distribution for their Work in
part through the use and efforts of others.

For these and/or other purposes and motivations, and without any
expectation of additional consideration or compensation, the person
associating CC0 with a Work (the "Affirmer"), to the extent that he or she
is an owner of Copyright and Related Rights in the Work, voluntarily
elects to apply CC0 to the Work and publicly distribute the Work under its
terms, with knowledge of his or her Copyright and Related Rights in the
Work and the meaning and intended legal effect of CC0 on those rights.

1. Copyright and Related Rights. A Work made available under CC0 may be
protected by copyright and related or neighboring rights ("Copyright and
Related Rights"). Copyright and Related Rights include, but are not
limited to, the following:

  i. the right to reproduce, adapt, distribute, perform, display,
     communicate, and translate a Work;
 ii. moral rights retained by the original author(s) and/or performer(s);
iii. publicity and privacy rights pertaining to a person's image or
     likeness depicted in a Work;
 iv. rights protecting against unfair competition in regards to a Work,
     subject to the limitations in paragraph 4(a), below;
  v. rights protecting the extraction, dissemination, use and reuse of data
     in a Work;
 vi. database rights (such as those arising under Directive 96/9/EC of the
     European Parliament and of the Council of 11 March 1996 on the legal
     protection of databases, and under any national implementation
     thereof, including any amended or successor version of such
     directive); and
vii. other similar, equivalent or corresponding rights throughout the
     world based on applicable law or treaty, and any national
     implementations thereof.

2. Waiver. To the greatest extent permitted by, but not in contravention
of, applicable law, Affirmer hereby overtly, fully, permanently,
irrevocably and unconditionally waives, abandons, and surrenders all of
Affirmer's Copyright and Related Rights and associated claims and causes
of action, whether now known or unknown (including existing as well as
future claims and causes of action), in the Work (i) in all territories
worldwide, (ii) for the maximum duration provided by applicable law or
treaty (including future time extensions), (iii) in any current or future
medium and for any number of copies, and (iv) for any purpose whatsoever,
including without limitation commercial, advertising or promotional
purposes (the "Waiver"). Affirmer makes the Waiver for the benefit of each
member of the public at large and to the detriment of Affirmer's heirs and
successors, fully intending that such Waiver shall not be subject to
revocation, rescission, cancellation, termination, or any other legal or
equitable action to disrupt the quiet enjoyment of the Work by the public
as contemplated by Affirmer's express Statement of Purpose.

3. Public License Fallback. Should any part of the Waiver for any reason
be judged legally invalid or ineffective under applicable law, then the
Waiver shall be preserved to the maximum extent permitted taking into
account Affirmer's express Statement of Purpose. In addition, to the
extent the Waiver is so judged Affirmer hereby grants to each affected
person a royalty-free, non transferable, non sublicensable, non exclusive,
irrevocable and unconditional license to exercise Affirmer's Copyright and
Related Rights in the Work (i) in all territories worldwide, (ii) for the
maximum duration provided by applicable law or treaty (including future
time extensions), (iii) in any current or future medium and for any number
of copies, and (iv) for any purpose whatsoever, including without
limitation commercial, advertising or promotional purposes (the
"License"). The License shall be deemed effective as of the date CC0 was
applied by Affirmer to the Work. Should any part of the License for any
reason be judged legally invalid or ineffective under applicable law, such
partial invalidity or ineffectiveness shall not invalidate the remainder
of the License, and in such case Affirmer hereby affirms that he or she
will not (i) exercise any of his or her remaining Copyright and Related
Rights in the Work or (ii) assert any associated claims and causes of
action with respect to the Work, in either case contrary to Affirmer's
express Statement of Purpose.

4. Limitations and Disclaimers.

 a. No trademark or patent rights held by Affirmer are waived, abandoned,
    surrendered, licensed or otherwise affected by this document.
 b. Affirmer offers the Work as-is and makes no representations or
    warranties of any kind concerning the Work, express, implied,
    statutory or otherwise, including without limitation warranties of
    title, merchantability, fitness for a particular purpose, non
    infringement, or the absence of latent or other defects, accuracy, or
    the present or absence of errors, whether or not discoverable, all to
    the greatest extent permissible under applicable law.
 c. Affirmer disclaims responsibility for clearing rights of other persons
    that may apply to the Work or any use thereof, including without
    limitation any person's Copyright and Related Rights in the Work.
    Further, Affirmer disclaims responsibility for obtaining any necessary
    consents, permissions or other rights required for any use of the
    Work.
 d. Affirmer understands and acknowledges that Creative Commons is not a
    party to this document and has no duty or obligation with respect to
    this CC0 or use of the Work.