甜瓜裝載機

世界上第一個兼容Il2Cpp和Mono的Unity遊戲通用Mod加載器

---

---

一般信息：

• 調試模式用於開發目的。
  使用它來幫助開發和調試MelonLoader、插件和Mods。
  
  
• 所有日誌都是在創建的 甜瓜裝載機/原木
• 所有插件都放在創建的 插件
• 所有mod都放在創建的 模組 遊戲安裝文件夾中的文件夾。
  
  
• 官方維基
  
  
• 代理
• 啟動選項
• 調試
  
  
• Linux支持（葡萄酒/蒸汽質子/原生)
• Android和Oculus Quest支持（WIP)
  
  

使用指南：
安裝程序
手動使用

示例項目：
測試插件
測試模式

夜間構建：
master
阿爾法發展
普遍性

---

❤ ️ 特別感謝我們出色的贊助人 ❤ ️

• 吉沃
• 弗洛里安·法倫伯格
• Python
• 冷酷
• 斯利迪德夫

---

要求：

Il2Cpp遊戲：

• .NET 6.0桌面運行時

在Windows上，將自動安裝.NET 6.0桌面運行時

---

如何使用安裝程序：

1. 遵循下面鏈接的指南中的說明。

安裝指南：
安裝
更新
重新安裝
卸載

---

如何手動使用MELONLOADER：

更新/重新安裝：

1. 卸載
2. 按照以下步驟操作 安裝

安裝：

1. 在嘗試安裝之前，請確保遊戲已關閉且未運行。
2. 確保您擁有所有 要求 在嘗試安裝之前安裝。
3. 下載MelonLoader[x86][x64]
4. 將MelonLoader文件夾從MelonLoader Zip存檔解壓到遊戲的安裝文件夾中。
5. 將version.dll和dobby.dll從MelonLoader Zip存檔中提取到遊戲的安裝文件夾。

卸載：

1. 在嘗試卸載之前，請確保遊戲已關閉且未運行。
2. 從遊戲的安裝文件夾中刪除version.dll文件。
3. 從遊戲的安裝文件夾中刪除MelonLoader文件夾。

如果您想要完全卸載，下面的這些附加步驟是可選的。

1. 從遊戲的安裝文件夾中刪除插件文件夾。
2. 從遊戲的安裝文件夾中刪除Mods文件夾。
3. 從遊戲的安裝文件夾中刪除UserData文件夾。

---

配置：

MelonLoader有自己的配置文件 ./UserData/Loader.cfg （您需要至少運行一次MelonLoader才能出現）。

以下是當前配置選項（及其默認值）的列表：

[loader]#禁用MelonLoader。 相當於“--no-mods”啟動選項disable=false#相當於“--melonloader.de bug”啟動選項debug_mode=true#將所有Unity player日誌捕獲到melonloader的日誌中，即使遊戲禁用了它們。 注意：根據遊戲或Unity版本，這些日誌可能會過於冗長。 相當於'--melonloader.ca ptureplayerlogs'啟動選項capture_player_logs=true#要捕獲到melonloader日誌中的最大和諧日誌詳細度。 按詳細順序排列的可能值是：“無”、“錯誤”、“警告”、“信息”、“調試”或“IL”。 相當於'--melonloader.harmonyloglevel'啟動選項harmony_log_level="Warn"#僅當遊戲在嘗試退出時凍結時使用此選項。 相當於“--quitfix”啟動選項force_quit=false#禁用開始屏幕。 相當於“--melonloader.disablestartscreen”啟動選項disable_start_screen=false#在Windows上啟動dotnet調試器並等待它被連接，或者只是等待一個被連接而不在其他操作系統上啟動（僅適用於Il2Cpp遊戲）。 相當於“--melonloader.launchdebugger”啟動選項launch_debugger=false#設置加載程序主題。 目前，唯一可用的主題是“正常”和“檸檬”。 相當於’-melonloader.consolemode’啟動選項（0代表正常，4代表檸檬）theme=”Normal”【console】#隱藏顯示的警告。 相當於“--melonloader.hidewarnings”啟動選項hide_warnings=false#隱藏控制台。 相當於“--melonloader.hideconsole”啟動選項hide_console=false#強制控制台始終保持在所有其他應用程序之上。 相當於“--melonloader.consoleontop”啟動選項console_on_top=false#將控制台標題保持為原始標題。 相當於'--melonloader.consoledst'啟動選項dont_set_title=false[logs]#設置logs文件夾中日誌文件的最大數量（默認值：10）。 相當於'--melonloader.maxlogs'啟動選項max_logs=10[mono_debug_server]#當debug_mode為true時，讓mono調試服務器等待，直到調試器被附加（僅適用於mono遊戲）。 相當於'--melonloader.de bugsuspend'啟動選項debug_suspend=false#當debug_mode為true時，Mono調試服務器將監聽的IP地址（僅適用於Mono遊戲）。 相當於'--melonloader.de bugipaddress'啟動選項debug_ip_address="127.0.0.1"#當debug_mode為true時，Mono調試服務器將監聽的端口（僅適用於Mono遊戲）。 相當於'--melonloader.de bugport'啟動選項debug_port=55555[UnityEngine]#覆蓋檢測到的UnityEngine版本。 相當於'--melonloader.unityversion'啟動選項version_override=""#禁用控制台日誌清理器（僅適用於Il2Cpp遊戲）。 相當於“--melonloader.disableunityclc”啟動選項disable_console_log_cleaner=false#強制Il2Cpp程序集生成器在不聯繫遠程API的情況下運行。 相當於“--melonloader.agfoffline”啟動選項force_offline_generation=false#強制Il2Cpp程序集生成器使用指定的正則表達式。 相當於'--melonloader.agfregex'啟動選項force_generator_regex=""#強制Il2Cpp程序集生成器使用指定的Il2Cpp轉儲器版本。 相當於'--melonloader.agfvdumper'啟動選項force_il2cpp_dumper_version=""#強制il2cpp程序集生成器始終重新生成程序集。 相當於“--melonloader.agfregenerate”啟動選項force_regeneration=false#為Cpp2IL啟用CallAnalyzer處理器。 相當於“--cpp2il.ca llanalyzer”啟動選項enable_cpp2il_call_analyzer=false#為cpp2il啟用NativeMethodDetector處理器。 相當於“--cpp2il.nativemethoddetector”啟動選項enable_cpp2il_native_method_detector=false

---

啟動選項：

• 這些是MelonLoader添加到遊戲中的額外啟動選項。
• 這些可以用來操縱MelonLoader的工作方式。

論據	說明
-no-mods	無需加載任何插件或mod即可啟動遊戲
——quitfix	修正了某些遊戲的掛起進程問題
——甜瓜加載器.consolemode	更改控制台的主題顯示模式[Default=0]
——甜瓜裝載機.consoleontop	強制控制台始終保持在所有其他應用程序之上
——甜瓜裝載機.控制台	保持控制台標題為原始標題
——甜瓜裝載機.hideconsole	隱藏控制台
——甜瓜裝載機.hidewarnings	隱藏顯示的警告
——甜瓜加載器.debug	調試模式
——甜瓜加載器.captureplayerlogs	將所有Unity玩家日誌捕獲到MelonLoader的日誌中，即使遊戲禁用了它們。 注意：根據遊戲或Unity版本的不同，這些日誌可能過於冗長
——甜瓜裝載機.harmonyloglevel	要捕獲到MelonLoader日誌中的最大和諧日誌詳細度。 按詳細順序排列的可能值有：“無”、“錯誤”、“警告”、“信息”、“調試”或“IL”
——甜瓜加載器.debugsuspend	讓Mono調試服務器在調試模式下等待調試器連接（僅適用於Mono遊戲）
——甜瓜加載器.debugipaddress	Mono調試服務器在調試模式下將監聽的IP地址（僅適用於Mono遊戲）
——甜瓜加載器.調試端口	Mono調試服務器在調試模式下將監聽的端口（僅適用於Mono遊戲）
——甜瓜加載器.maxlogs	最大日誌文件數[默認值：10][NoCap：0]
——甜瓜加載器.loadmodeplugins	插件的加載模式[默認值：0]
--melonloader.loadmodemods	Mods的加載模式[默認值：0]
——甜瓜裝載機。基地	更改引導程序的代理加載目錄
——甜瓜加載器.disablestartscreen	禁用開始屏幕

• 以下是Unity引擎特定的啟動選項。

論據	說明
——甜瓜加載器.unityversion	允許您指定Unity引擎的版本
——甜瓜裝載機.agfoffline	強制程序集生成器在不聯繫遠程API的情況下運行
——甜瓜加載器.agfregenerate	強制組件再生
——甜瓜裝載機.agfregex	強制程序集生成器使用指定的正則表達式
——甜瓜裝載機.agfvdumper	強制程序集生成器使用指定版本的轉儲器
——melonloader.disableunityclc	禁用Unity控制台日誌清理器
——甜瓜裝載機.monosearchpathoverride	Mono將優先搜索mscorlib和核心庫的路徑列表，然後是託管文件夾和Melon包含的核心庫集。 列表在Windows上用分號(;)分隔，在Linux上用冒號(：)分隔

• 以下是CPPP2IL特定的啟動選項。

論據	說明
——cpp2il.ca llanalyzer	啟用CallAnalyzer處理器
--cpp2il.nativemethoddetector	啟用NativeMethodDetector處理器

---

代理：

MelonLoader使用代理DLL欺騙遊戲在啟動時自行加載。 這僅適用於Windows。

• 代理DLL可以重命名為下面的兼容文件名。
• 默認情況下，代理名為“version.dll”。
• 對於大多數遊戲來說，默認文件名應該可以正常工作。
• 根據架構、操作系統、遊戲使用的引擎版本等，某些遊戲可能會讓您使用不同的代理文件名。

文件名：
版本.dll
winhttp.dll
winmm.dll
輸入.dll
dinput8.dll
dsound.dll
d3d8.dll
d3d9.dll
d3d10.dll
d3d11.dll
d3d12.dll
ddraw.dll
msacm32.dll

---

許可和信用：

MelonLoader是在Apache許可證2.0版下許可的。 見

用作源代碼和/或以二進制形式捆綁的第三方庫：

• 多比 是在Apache許可證2.0版下許可的。 見 為了完整的許可證。
• plthook 是在2條款BSD許可證下許可的。 見 許可證 完整許可證文件頂部的文本。
• 單聲道 在多個許可證下獲得許可。 見 了解全部細節。
• HarmonyX
• MonoMod
• Mono.Cecil 是根據麻省理工學院的許可證授權的。 見 許可證 為了完整的許可證。
• 牛頓軟件.Json
• 蒂尼傑森
• 湯姆萊特
• ASM解析器 是根據麻省理工學院的許可證授權的。 見 許可證 為了完整的許可證。
• 夏普齊普利布
• Semver
• 幻覺插件架構
• MuseDashModLoader 是根據麻省理工學院的許可證授權的。 見 許可證 為了完整的許可證。
• mgGif
• AssetsTools.NET
• AssetRipper.VersionUtilities 是根據麻省理工學院的許可證授權的。 見 許可證 為了完整的許可證。
• Steam庫、VDF和ACF解析自 蒸汽探測器.cs 由 傘氧 和 達萊特.
• 觸覺圖書館
• 索引範圍
• 價值雙橋 許可證 為了完整的許可證。
• WebSocketDotNet 是根據麻省理工學院的許可證授權的。 見
• 粉彩
• IL2CPP互操作 根據LGPLv3許可證獲得許可。 見

運行時下載和使用的外部庫和工具：

• Cpp2IL 是根據麻省理工學院的許可證授權的。 見 許可證 為了完整的許可證。
• Unity運行時庫來自 甜瓜裝載機.UnityDependencies 是Unity軟件的一部分。
  它們的使用受 Unity服務條款，包括 Unity軟件附加條款.
• .NET運行時 是根據麻省理工學院的許可證授權的。 見 許可證 為了完整的許可證。

見 MelonLoader維基 為了全部學分。

MelonLoader不是由Unity Technologies或其附屬公司贊助、附屬或認可的。
“Unity”是Unity Technologies或其附屬公司在美國和其他地方的商標或註冊商標。