社區模組框架與菜單 / Community Mod Framework - 1.3 Pavia
模組介紹 作者原文
社區模組框架 (CMF) 是一個工具類模組,旨在提高模組間的兼容性,併爲模組作者提供創建新功能的工具。
CMF 應放在您模組加載順序的首位。
如有任何疑問,請隨時通過 EU5 Mod Coop Discord 聯繫:
功能
社區模組菜單 (CMM):[github.com] 一個共享的遊戲內模組菜單。模組作者可以通過簡單的 API 動態註冊設置,無需構建自定義設置界面。
開關、按鈕、數值、滑塊(雙擊可拖動)、下拉菜單、文本(僅限單人模式)和列表設置
支持各個模組獨立的標籤頁、分組和搜索功能
全局設置,在多人模式下僅限房主編輯
重置爲默認值
可拖動窗口
可以從遊戲內的退出菜單(Esc 菜單)中打開,或通過快捷鍵打開(默認爲“m”,可重新綁定)。
CMM 可視化編輯器[github.com]:用於創建模組菜單的瀏覽器端工具
自定義提醒:[github.com] 通過本地化鍵位在提醒欄中創建並顯示自定義提醒。
動作欄:[github.com] 使用本地化鍵位添加自定義動作欄按鈕。
國家轉移:[github.com] 切換國家(Tag 切換、繼承等)時,CMM 設置會自動轉移。
is_host 觸發器:[github.com] 檢查當前國家是否由房主玩家控制。
不受限工具開關:[github.com] 通過“開啓不受限工具”設置(cmf_can_use_unrestricted_tools 觸發器,cmm_set_requires_unrestricted_tools_enabled 單項設置標記)來限制特定功能。在多人模式下僅房主可用。
模組檢測:[github.com] 使用 cmf_is_mod_active 觸發器檢查另一個模組是否處於激活狀態。
cmf_suppress 效果:[github.com] 通過單次效果調用來抑制引擎中“已使用但從未設置”和“已設置但從未使用”的警告。
GUI 宏:[github.com] Nand、Nor 和 Xor 邏輯運算符宏。
On-Action 鉤子:[github.com] 大廳後遊戲開始和存檔加載鉤子(on_game_start_after_lobby、on_game_load、on_game_load_after_lobby)以及玩家國家變體。還包括針對人類玩家的共享年度和月度脈衝(Pulses)。
變量映射工具:[github.com] 安全的變量映射(Variable Map)更改輔助工具(cmf_change_variable_map 及其本地/全局變體),可原子化地處理“先刪除後添加”操作。
模組動作日誌:[github.com] 全局遊戲內日誌,用於記錄模組動作(例如多人模式下的房主工具動作,因爲該日誌在多人模式下無法清除)。
社區模組工具箱 (CMT):[github.com] 一套配套的開發工具,例如模組模板、創意工坊上傳器和模組翻譯器。
文檔
GitHub Wiki[github.com]:完整文檔
EU5 Paradox Wiki[eu5.paradoxwikis.com]:快速參考
GitHub 倉庫[github.com]
貢獻者
Bahmut
CaesarVincens
Conner
Glorp
Pickle
RomanImperator
正在使用 CMF 的模組
請參閱 使用 Community Mod Framework 的模組合集
更新日誌:
請參閱 創意工坊頁面上的更新說明。
報告問題前請閱讀:
如果您使用的是 1.3 公測版,請禁用本模組並確認在沒有它的情況下問題是否依然存在。公測版存在大量問題,這些問題需要向 Paradox 報告,而不是向 CMF 報告。
此外,無論是報告 1.2 還是 1.3 版本的問題,請務必附帶您的遊戲版本號。CMF 兼容這兩個版本,但我們需要知道您所使用的版本以便解決相關問題。
安裝與使用 安裝:按包內說明操作
- 解壓本站下載的壓縮包,先讀包內的 readme / 說明檔案。
- 這類遊戲沒有通用的模組管理器:有的模組直接替換遊戲檔案、有的放進遊戲專屬的 Mods 資料夾、有的要先裝遊戲對應的社群載入器或工具,以包內說明為準。
- 嚴格按說明放置檔案;標註「前置依賴」的模組需要把依賴一併裝好。
- 啟動遊戲確認載入成功;部分遊戲需要在設定或模組選單裡手動啟用。
不同遊戲、不同模組的安裝位置差異很大,包內說明是最可靠的依據。