跳到正文
本頁目錄

Android 版 LeviLauncher 的功能與設置

安卓版 LeviLauncher 需要正版嗎?在微軟商店/PC(Java+基岩套裝)、iOS 上買的正版能用嗎?盜版或網上的“去驗證版”啟動器能用嗎?

需要。LeviLauncher 啟動器本身免費、開源,但安卓版會做正版驗證:設備上必須裝有從 Google Play 安裝的官方 Minecraft(包名 com.mojang.minecraftpe,1.21.80 或更高版本),啟動時會檢查它的安裝來源是否為 Google Play 商店,不滿足會提示“非正版MC,請確保設備上MC來自於谷歌商店”並拒絕啟動。基岩版各平臺單獨售賣,微軟商店/PC 版(包括 Java+基岩 PC 套裝)、iOS 的購買都不包含安卓版,需在 Google Play 另外購買(可用 Google Play 禮品卡等方式支付);買好後從 Google Play 安裝,最好先啟動一次。從論壇、網盤、mcapks 等渠道下載的破解版/改包 MC 無法通過驗證。LiteLDev 不提供任何跳過正版驗證的功能,第三方流傳的“去驗證/破解版”啟動器不受官方支持,相關問題不予處理,請只從 https://github.com/LiteLDev/LeviLauncher-Android/releases 下載官方版本。另外啟動器僅支持 ARM64 設備(32 位手機無法使用)。PC 版 LeviLauncher 同樣要求正版(微軟商店)。

適用版本:LeviLauncher-Android 當前所有版本(最新 v1.7.1)

LeviLauncher 安卓版是否依賴手機上已安裝的 Minecraft?對遊戲有什麼要求?

依賴。設備上必須裝有從 Google Play 安裝的官方 Minecraft 基岩版(1.21.80 或更高),啟動器會檢查它的安裝來源是否為 Google Play,改包/破解版或從其他渠道安裝的 MC 無法通過啟動器啟動。在此基礎上,啟動器還支持導入官方 Minecraft APK,在啟動器內運行其他遊戲版本而無需逐個安裝到系統(導入版本通常需要開啟版本隔離),但 Google Play 版本仍必須保留在設備上。項目地址:https://github.com/LiteLDev/LeviLauncher-Android。

適用版本:LeviLauncher-Android 當前所有版本(最新 v1.7.1)

安卓版 LeviLauncher 打開後原來 MC 裡的存檔和模組都不見了,怎麼把存檔、addon、資源包和 .so 模組導入到啟動器裡?

安卓端 LeviLauncher 使用自己的數據目錄,和 Minecraft 本體(Google Play 版直接啟動時)的數據相互隔離,所以啟動器裡看不到原來的存檔。導入方法:把存檔打包/改後綴為 .mcworld,addon 為 .mcaddon,資源包/皮膚包為 .mcpack,然後用“打開方式”選擇 LeviLauncher 即可導入;也可以在啟動器內的內容管理(世界、資源包)中導入、導出和備份。.so 原生模組(以及 .levipack 模組包)同樣可以用“打開方式”選擇 LeviLauncher,或在“模組”頁面添加。若開啟了版本隔離,不同版本之間的數據也互相獨立,導入時注意選對版本。

適用版本:LeviLauncher-Android 當前所有版本(最新 v1.7.1)

安卓 LeviLauncher 裡導入的“模組”是什麼格式?和 LeviLamina 模組有什麼區別?網盤裡的 apk 是模組嗎?

安卓版 LeviLauncher 的模組是 Android 原生模組:單個 .so 庫,或打包好的 .levipack(ZIP,內含 manifest.json、lib<名称>.so 和 config)/.mcmod/.zip 模組包,直接通過啟動器導入即可使用,由啟動器內置的 Preloader(preloader-android)加載,使用獨立的 pl:: API,不需要也不能使用 LeviLamina(LeviLamina 模組是 Windows 的 .dll,不能在安卓上運行)。它們也不是 addon。網上流傳的 apk 一般是已經內置了模組的改包遊戲安裝包,不是可單獨導入的模組,而且改包 MC 無法通過啟動器的 Google Play 正版驗證;啟動器的“導入 APK”只用於導入官方 Minecraft APK 作為額外版本。網盤裡若混有其他安卓啟動器的模組,需要找為 LeviLauncher 製作、且對應你遊戲版本的 .so/.levipack,再用啟動器導入。

適用版本:LeviLauncher-Android 當前所有版本(最新 v1.7.1)

安卓版 LeviLauncher(原 LeviLaunchroid)的 API 和 LeviLamina 有多大區別?能用 LeviLamina 的頭文件開發嗎?

完全不同,不能直接用 LeviLamina 的頭文件。安卓版 LeviLauncher 不提供 LeviLamina 那樣的遊戲類頭文件和遊戲 API(事件、命令等);安卓原生模組基於啟動器內置的 Preloader SDK(LiteLDev/preloader-android),使用獨立的 pl:: API(生命週期、Hook、Signature 特徵碼查找、Patch、Config、Input、Mod Menu 等),遊戲函數需自己通過特徵碼/符號定位後 hook。模組寫法(load/enable/disable/getSelf,getSelf 返回 ll::mod::NativeMod)與 LeviLamina 模組形態相似。API 文檔見 https://levimc.org/zh-Hant/LeviLamina/developer_guides/android/api/mod/,入門教程見 https://levimc.org/zh-Hant/tutorials/develop/first-android-mod/,源碼見 https://github.com/LiteLDev/LeviLauncher-Android。

適用版本:LeviLauncher-Android 當前版本(最新 v1.7.1)

安卓版 LeviLauncher 如何加載渲染龍(RenderDragon)光影(如 Newb)?需要改包嗎?啟動器自帶 MBL 嗎?升級到 1.26.x 後材質變“滾木”/全白、開了光影沒效果或閃退怎麼辦?

不需要改 APK。安卓版 LeviLauncher 不內置光影加載器,需要自己添加一個 MaterialBin 加載器 mod(.so):

  1. mtbinloader2(MBL2):從 https://github.com/mcbegamerxx954/mtbinloader2/releases 下載最新版的 libmtbinloader2_aarch64-linux-android.so(目前為 v0.1.18,已適配 26.60),在啟動器“模組”裡導入;
  2. 或在啟動器的“外部模組”頁面直接下載 MaterialBinLoader(libmbl2.so,適用於 MC >=1.26.45.1)。

然後通過資源包導入光影(也可以在啟動器的 CurseForge 頁面搜索 newb 等光影下載),並在遊戲中啟用。

注意:舊版加載器不兼容新版 MC,會導致材質變滾木、全白或閃退,務必使用最新版加載器並把啟動器更新到最新。自 26.10 起 mtbinloader2 移除了自動修復(autofix),光影本身必須由作者適配對應 MC 版本;開了光影看不出效果通常是光影版本與遊戲版本不匹配或加載器沒啟用,更新光影即可。Android 上不能用 BetterRenderDragon 加載光影(它是 PC 端的)。PC 版 LeviLauncher 已移除“渲染龍光影”設置,PC 端請使用 BetterRenderDragon。

適用版本:LeviLauncher-Android v1.7.1;MC 1.26.x(含 26.60)

安卓 LeviLauncher 如何在不改包的情況下加載 4D 皮膚?4DSkin mod 從哪裡下載?

不需要改 APK。在啟動器的“外部模組”頁面直接下載 4DSkin(發佈頁 https://github.com/QYCottage/4DSkin-Release,以 4DSkin.levipack 形式提供),注意選擇與當前 MC 版本兼容的版本;然後把 4D 皮膚做成皮膚包導入即可。

適用版本:LeviLauncher-Android 當前版本

安卓手機上的 Minecraft 自動更新了/想玩舊版本 MC,如何在 LeviLauncher 中使用舊版本?apk/apks 怎麼裝?

不需要卸載 Google Play 安裝的 MC(啟動器要求設備上裝有 Play 商店版 MC)。在 LeviLauncher 中添加舊版本即可:

  1. 在“下載”頁面用已購買 Minecraft 的 Google 賬號登錄,從 Google Play 直接下載所需版本(可用“按版本號下載”指定版本代碼,例如 1.21.80.3 的版本代碼為 972108003;只能獲取該賬號仍可獲取的構建);
  2. 或自行獲取官方的 apk/apks 安裝包,在“下載”頁面點“導入APK”(支持 APK 和 APKS),不需要額外的安裝器。

導入的版本需要在實例設置中開啟“版本隔離”才能啟動。導入失敗或崩潰時先把 LeviLauncher 更新到最新版。注意啟動器不支持早於 1.21.80 的版本。

適用版本:LeviLauncher-Android v1.7.0 及以上(Google Play 下載);導入 APK 適用於當前版本

levimap 小地圖怎麼調整樣式、位置、大小?怎麼打開大地圖?

長按小地圖進入設置菜單:可以設成圓形、拖動位置,Zoom 調顯示縮放,Size 調小地圖尺寸。新版 levimap 雙擊小地圖展開大地圖,也可以在菜單裡點 Big Map。雙擊沒有反應說明 mod 版本太舊,請到 Discord 下載最新版(啟動器也要 1.5.4 及以上)。

適用版本:安卓 LeviLauncher 1.5.4 及以上;第三方 mod levimap。未能從源碼或文檔中直接證實,僅供參考。

新版安卓 LeviLauncher 的內置模組在哪裡查看、開啟?

進遊戲後點懸浮按鈕打開“模組菜單”,按“內置”篩選或看“內置功能”分組,裡面就是內置模組(快速丟棄、快速切換視角、隱藏界面、自動疾跑、縮放、FPS/CPS 顯示、陀螺儀、Pojav 控制等),按需開啟即可。模組菜單可以在實例設置裡開關(默認開啟)。

適用版本:安卓 LeviLauncher 新版(帶模組菜單的版本,至最新 v1.7.1)

安卓 LeviLauncher 有沒有能在遊戲內強制切換資源包的 mod?

有,第三方 mod BetterResourcePackManager 就是幹這個的,可以在 qycottage 的 Discord 頻道下載(已有 26.40 的版本)。

適用版本:安卓 LeviLauncher;第三方 mod BetterResourcePackManager(已有 MC 26.40 版本)。未能從源碼或文檔中直接證實,僅供參考。

安卓上 libBetterResourcePackManager 有什麼替代?

BetterResourcePackManager 主要有三個功能:加載 RenderDragon 光影、局內切換資源包、加載 4D 皮膚。替代方案:4D 皮膚用 4Dskin mod(在 qycottage 的 Discord 獲取),光影用 mtbinloader2;局內切換資源包沒有替代。Windows 上加載光影用 BetterRenderDragon。注意:2026-08 時 BetterResourcePackManager 已有 26.40 版本,可以先去 qycottage 的 Discord 看看有沒有適配你遊戲版本的新版。

適用版本:安卓 LeviLauncher;第三方 mod。未能從源碼或文檔中直接證實,僅供參考。

安卓版 LeviLauncher 怎麼導出結構?為什麼找不到以前的結構?

在啟動器的世界列表裡,點世界的操作菜單 →“提取結構”。啟動器只能找到存檔裡已經保存的結構:先通過這個啟動器進入該世界,放一個結構方塊並設為保存模式,命名後點保存,退出世界,再回來點“提取結構”,就可以單個導出或打包成 ZIP 導出。沒有用結構方塊保存進存檔的結構是找不到的。

適用版本:安卓 LeviLauncher 當前版本

用 LeviLauncher 怎麼實現紅石顯示/區塊顯示(紅顯區顯)?加了光影包為什麼不顯示?

這類效果是材質(material.bin)類光影包,必須先裝材質加載 mod 才會生效:安卓端加載 mtbinloader2(https://github.com/mcbegamerxx954/mtbinloader2),PC 端裝 BetterRenderDragon(BRD,https://github.com/QYCottage/BetterRenderDragon),然後再添加紅顯區顯的材質包。只加材質包、不裝加載器是沒有效果的。

適用版本:LeviLauncher(安卓/PC);第三方材質加載 mod。未能從源碼或文檔中直接證實,僅供參考。

能否把其他第三方客戶端(如 Flarial 安卓客戶端)的功能放到 LeviLauncher 安卓端裡使用?

可以嘗試:從該客戶端的安裝包(APK)中提取出 arm64 的 .so 文件,再在 LeviLauncher 的“模組”頁面導入(啟動器支持導入 .so、含 manifest.json 與 .so 的 .zip、.levipack/.mcmod 模組包),即可作為原生模組加載。能否正常工作取決於第三方客戶端本身:有用戶反饋 Flarial 1.139.3 提取的 .so 可用,較新版本可能導入後閃退(新版帶包名校驗),聯機時也可能閃退。此類第三方 .so 不受 LeviLauncher 官方支持,請只使用可信來源,並先在隔離版本中測試。

適用版本:LeviLauncher-Android 當前版本(v1.7.1);第三方客戶端兼容性視其版本而定。未能從源碼或文檔中直接證實,僅供參考。

用 LeviLauncher 安卓版啟動遊戲後幀率被鎖在 60 幀,手機明明支持 120Hz,怎麼辦?

幀率上限與啟動器無關,是遊戲自身的設置:在遊戲內“設置 → 視頻”中調高幀率上限即可(部分機型還受系統/廠商的刷新率策略限制)。啟動器內置的 FPS 顯示模組只負責顯示幀率,不會限制幀率。

適用版本:當前所有版本(取決於 Minecraft 自身設置與設備)。未能從源碼或文檔中直接證實,僅供參考。

新版 LeviLauncher 安卓端是否已經不能訪問自身應用目錄以外的文件?mod 配置文件放在 /storage/emulated/0/games/ 下還能讀到嗎?

是的。自 v1.5.27 起安卓端重構了存儲訪問與權限,已不再申請“所有文件訪問”(MANAGE_EXTERNAL_STORAGE)及 READ_EXTERNAL_STORAGE / WRITE_EXTERNAL_STORAGE 等存儲權限(維護者表示這是為了上架 Google Play),除啟動器自己的目錄(/storage/emulated/0/Android/media/org.levimc.launcher/、Android/data/org.levimc.launcher/ 及應用私有目錄)外無法直接訪問其他位置;導入文件改為通過系統文件選擇器授權。原來把配置放在 /storage/emulated/0/games/ 等公共目錄的 mod 需要改為使用啟動器可訪問的目錄(如對應實例的遊戲數據目錄)。

適用版本:LeviLauncher-Android v1.5.27 及以上

安卓 LeviLauncher 一定要開著模組菜單懸浮窗嗎?關掉以後內置模組(切換視角、CPS 等)也不顯示了?

是的。現在內置模組和使用啟動器統一 UI 接口的 mod 都掛在模組菜單上(以前 mod 各自用 imgui 畫界面),所以在實例設置裡關掉「模組菜單」以後,內置模組的懸浮窗和 HUD 都不會再顯示。不想讓它擋畫面,可以在模組菜單的常規設置裡開「僅暫停菜單顯示」(只在暫停界面顯示),或者調整懸浮按鈕的大小、透明度,以及鎖定位置。

適用版本:安卓 LeviLauncher 帶模組菜單的版本(至最新 v1.7.1)

LeviLauncher Android 加了資源包,遊戲裡卻看不到,怎麼辦?

通常是資源包放到了另一個存儲位置。在啟動器的內容管理(資源包頁面)裡用「選擇存儲」換一個位置再導入:原來是「外部」就換「內部」,原來是「內部」就換「外部」。如果這個實例開了版本隔離,要選「版本隔離(內部)」或「版本隔離(外部)」;都不行再試試開/關版本隔離。

適用版本:安卓 LeviLauncher 當前版本

LeviLauncher 安卓端 1.6.1 起“後臺持續運行”選項不見了嗎?切後臺後回來要重新加載怎麼辦?

v1.6.1 移除了啟動器的前臺服務(即原“後臺持續運行”選項)。現在該功能由 BedrockTools 模組提供:把 BedrockTools 更新到 v1.5.11 或更高(舊的 1.5.9 在 26.60 上不行),並在 BedrockTools 中開啟 No Disconnect,即可讓 Minecraft 在後臺保持運行,切回時不用重新加載。

適用版本:LeviLauncher-Android v1.6.1 及以上(當前 v1.7.1);BedrockTools v1.5.11+

LeviLauncher Android 用的是什麼 mod 加載器?有沒有安卓 mod 開發文檔或模板,從哪裡入手?

安卓版 LeviLauncher 沒有 LeviLamina 那樣的加載器,而是內置 Preloader SDK(https://github.com/LiteLDev/preloader-android),提供 pl:: API:模組生命週期(<pl/Mod.hpp>、PL_REGISTER_MOD)、Hook、Signature、Patch、Config、Input、Mod Menu 等。官方 API 文檔現已整合到 LeviLamina 文檔的“Android Native Mods API”部分:https://levimc.org/zh-Hant/LeviLamina/developer_guides/android/api/mod/(Mod/Hook/Signature/Patch/Config/Input/Mod Menu 等各頁);入門教程:https://levimc.org/zh-Hant/tutorials/develop/first-android-mod/。模板使用 https://github.com/QYCottage/levilauncher-android-mod-template(Use this template 創建倉庫,CMake+Ninja 構建出 .levipack,GitHub Actions 也可自動構建);完整示例見 LiteLDev/LeviLauncher-Android 倉庫中的 examples/full-cpp-mod。

適用版本:LeviLauncher-Android 當前版本(最新 v1.7.1)

用 LeviLauncher 安卓版啟動遊戲,玩一段時間後幀率被鎖到 10 幀左右(原版啟動沒這個問題),是什麼原因?

可能是啟動器不在手機廠商的遊戲/性能白名單裡,系統對其限頻鎖幀(啟動器側暫時無法解決)。用戶側可嘗試:清理後臺、在系統遊戲助手/性能模式中手動添加 LeviLauncher、更新遊戲與啟動器到最新版本、使用調度類工具緩解;低性能 SoC 本身也有影響。如仍復現,請附設備型號、Android 版本和啟動日誌到 GitHub Issues 反饋。

適用版本:當前所有版本(取決於設備廠商系統策略)。未能從源碼或文檔中直接證實,僅供參考。

LeviLauncher 安卓版用“導入 APK”創建的實例,啟動時長時間卡在 51%(清後臺後更慢),導入世界存檔也失敗,怎麼辦?

導入 APK 的實例在性能較低的設備上可能出現啟動緩慢的問題(首次啟動需解壓原生庫等)。可以先更新到最新版啟動器(v1.6.0/v1.6.1 做了大量性能和內容管理優化);仍有問題時可嘗試在實例設置中切換“版本隔離”後重試,或改用從 Google Play 正常安裝的版本。注意官方文檔說明導入版本通常需要啟用版本隔離才能啟動,如關閉後無法啟動請重新開啟。

適用版本:LeviLauncher-Android,導入 APK 的實例。未能從源碼或文檔中直接證實,僅供參考。

安卓版 LeviLauncher 導入資源包/模組非常慢,有什麼辦法?

包越大導入越慢,先更新到最新版(v1.6.1 優化了包導入速度)。嫌慢可以手動把包解壓到啟動器的數據目錄:

  • 未開啟版本隔離時為 /storage/emulated/0/Android/media/org.levimc.launcher/minecraft/_shared/external/games/com.mojang/resource_packs/;
  • 開啟版本隔離的實例則在 /storage/emulated/0/Android/media/org.levimc.launcher/minecraft/<实例目录>/external/games/com.mojang/resource_packs/。

然後直接啟動遊戲。一般情況下用啟動器內導入就夠了(導入後文件夾名是隨機的)。

適用版本:LeviLauncher-Android 當前版本(使用新共享存儲佈局時)

用安卓 LeviLauncher 玩 MC 一會卡一下,或 26.40 加載資源、進服務器生成世界異常慢,是什麼原因?

常見原因:

  1. 同時裝了大量 mod、開了靈動視效、連鎖等,負載過高,建議精簡 mod、關閉靈動視效;遊戲默認鎖 60 幀,可用 BedrockTool 等 mod 解鎖幀率。
  2. 26.40 首發時部分第三方版本庫提供的安裝包有問題(APKS 與 APK 包體問題),導致加載/生成世界很慢;Google Play 正版沒有該問題,換用正版安裝包即可(v1.7.0 起可在啟動器“下載”頁直接從 Google Play 下載)。

適用版本:LeviLauncher-Android;第 2 點針對 MC 26.40 首發期的第三方安裝包。未能從源碼或文檔中直接證實,僅供參考。

開發安卓原生 mod 時,一般用什麼工具分析 libminecraftpe.so?

常用的逆向分析工具有 IDA Pro、Ghidra、Binary Ninja、radare2/Cutter、Reko 等。libminecraftpe.so 函數數量極多(數百萬個),用 IDA 等工具打開分析會非常慢、佔用大量內存,甚至可能卡死或崩潰。定位到目標函數後,Android 原生 mod 通常用特徵碼(signature)在運行時解析地址,例如 PreLoader 提供的 pl::memory::resolveSignature("...", "libminecraftpe.so")。

適用版本:Android 原生 mod 開發(與啟動器版本無關)。未能從源碼或文檔中直接證實,僅供參考。

安卓 LeviLauncher 裝了一個 300 多 MB 的 MC 安裝包,佔用卻變成 700 多 MB,為什麼?

導入的安裝包,啟動器會在該版本的目錄裡保存一份副本(base.apk.levi,分包也會保存為 *.apk.levi),運行前還要從裡面解壓原生庫,所以佔用差不多是安裝包的兩倍。這是正常現象。

適用版本:安卓 LeviLauncher 導入/下載的版本