Unciv模組制作教程01-模組介紹
寫在前面
如果你有一定的英語水平，可以去看官網的模組制作教程https://yairm210.github.io/Unciv/Modders/Mods/
模組是英文module的音譯詞，故不再區(qū)分“模組”“mod”和“module”。
人們往往希望向Unciv中添加一些新東西，但很可惜的是，Unciv只理解代碼而不能看懂自然語言，所以mod是Unciv作者團隊為那些不擅長編程的人提供修改游戲內容的新方式。
Mod可以添加、替換和刪除游戲的基本定義，比如單位(Unit)、國家(Nation)、建筑(Building)、改良(lmprovement)、資源(Resource)和地形(Terrain)。加載了這些mod的游戲會根據mod的定義來運行。
游戲只會識別現有的uniques，所以你不能增加新的uniques能力到國家Nation/Unit/Building等，只能與現有的東西進行交互。
Mod主要有三種類型：
擴展模組(Extension mods)?- 它向基本規(guī)則集添加新的Nation/Unit/Building/Resource，可以添加到默認規(guī)則集中，也可以添加到基本規(guī)則集模組中。它易于制作，可能是初學者的一個不錯的起點 - 比方說，創(chuàng)建一個新國家。
基本規(guī)則集模組(Base Ruleset mods)?- 它替換整個現有的規(guī)則集 - 技術樹、單位、策略、國家等 - 以提供與基礎游戲完全不同的體驗。這些通常需要相當多的工作，但可以提供全新的體驗，因此是最受歡迎的。
其他類型的模組(Ruleset-agnostic mods) - 它不包含任何與規(guī)則集相關的json文件，而是包含其他內容。視聽模組（包括Tileset/地塊材質包、Unitset/單位材質包和UI皮膚）和地圖模組都屬于這一類別。
附：不建議在Android上創(chuàng)建和編輯mod - 使用Windows要容易得多！(Apple?游戲本體都不支持還提它干什么doge)
模組昵稱
眾所周知，Unciv模組的官方發(fā)布平臺是Github，因此模組名稱需要符合GitHub倉庫命名規(guī)則(自行搜索了解)，同時也要保證簡潔性，只使用字母、數字和破折號(-)。在Unciv中顯示和使用時，破折號會自動轉換為空格。許多標點符號或擴展的Unicode字符也可能有效，但也僅僅是可能有效，很多時候會因為格式轉化變成亂碼。
模組文件的結構
mods文件夾位于Desktop的/mods目錄中，應該緊鄰您的jar文件，如圖。
1個模組文件夾通常包含2個子文件夾：
jsons - 在此文件夾中放置文件，這些文件會改變游戲對象的數據，文件的順序與基礎json文件中的順序相同。詳情見---（寫完教程全集后補上鏈接）
Images - 在此文件夾中放置游戲圖像(png格式)。
為了從游戲中刪除對象，您需要在/jsons子文件夾中創(chuàng)建一個ModOptions.json文件。詳情見---（寫完教程全集后補上鏈接）
基本規(guī)則集模組是“從頭開始”的mod - 所有原始對象都被剔除，然而也只有原始對象被剔除。
上述過程是通過在您的ModOptions文件中添加一個{"isBaseRuleset"：true}的配置來實現的。
圖像與音效/音樂拓展
除了拓展原始規(guī)則集內容或新增規(guī)則集之外 - 或者根本不進行更改 - mod也可以覆蓋現有的圖形或聲音，或添加音樂曲目。詳情見---（寫完教程全集后補上鏈接）
自定義Tileset和Unitset是這種模組的子集。詳情見---（寫完教程全集后補上鏈接）
這種mod可以通過Mod管理器上的“永久可見”開關來實現非裝載時啟用它。請注意，打開這個開關會讓在安裝這種mod以前啟動的所有游戲也啟用所選mod的圖像或聲音。
對于既更改規(guī)則又提供新的圖像/聲音內容的mod，“永久可見”功能只會讓這個mod的圖像/聲音部分永久啟用，而規(guī)則集部分仍然需要在新游戲選擇該mod。
關于圖像和atlas文件的一些信息
當在Desktop上運行模組時，所有圖像在游戲啟動時會被合并到一個新的大型圖像文件中，該文件具有相應的文件，即game.png和game.atlas。
這意味著，如果你制作的模組是針對Unciv的Android版本(強烈不支持在Android上寫模組!)的，則無法生成這些圖像文件-你務必找到某個方式來在Windows上運行模組來獲取上一段提及的game.png和game.atlas。
對于圖像顯示器來說，單個圖像并不重要-只有組合的圖像才會加載到游戲中，因此你需要將它們包含在您的Github存儲庫中并隨時更新它們。
實際上省略原始圖像(即在發(fā)布時省略Images文件夾)對分享游玩來說是可行的，但仍然建議保留Images文件夾，以便Unciv底層開發(fā)者訪問。
圖像極其密集的mod
如果你制作的mod包含大量小圖像（或少量大圖像），這些圖片可能會“溢出”到其他圖片".png"文件中-單個圖片的像素最大值為2048x2048。
圖像過多對性能不利，這就是為什么游戲內置規(guī)則集會控制一些類型的圖像組合成一個圖片文件（也就是圖集）。
對于mod，若創(chuàng)建一個不止一個Images文件夾，而是創(chuàng)建多個，那么請把其中額外的文件夾命名為“Images.xyz”，其中xyz將成為附加圖片文件的文件名（不要同時使用Images和Images.game，這會發(fā)生沖突）。
為了盡可能避免圖像顯示器反復開關（這會浪費性能），請盡量按游戲中的使用情況對它們進行分組。你可以按文件夾進行分組，當然，在好幾個“Images.xyz”文件夾下擁有相同名稱的子文件夾并在它們之間分組圖像也能湊效。
往mod中添加地圖
你可以向mod中添加地圖，這樣下載你的mod的玩家就可以使用這些地圖。
如果你只想分享您的地圖，那么mod也可以僅包含地圖。
當你在地圖編輯器中完成您的地圖時，保存它，它將被保存在你游戲的/maps文件夾中。
將它復制到你的mod的/maps文件夾中，就完成了！
如果你沒有要求你的模組能夠在游戲內置模組界面搜索下載的意愿，請忽略“發(fā)布你的mod”這一章節(jié)。
發(fā)布你的mod
為了使任何人都可以下載你的mod，你需要創(chuàng)建一個Github倉庫（說明在這里）
Images和jsons文件夾需要放在倉庫的根目錄中-例如，可以查看Create a repo - GitHub Docs
然后你可以手動從Unciv的Mod管理器中下載mod：
從Unciv的主屏幕點擊“模組”按鈕
點擊“從URL下載mod”，并輸入你的Github頁面位置
游戲將自動下載并解壓你的mod，它就可以使用了！
一旦你已經測試過你的mod可以被下載，并且一旦下載就可以正常運行，那么你就可以進入最后階段-讓其他人自動下載它。
要做到這一點，你所需要做的就是：
前往你的Github頁面
點擊頁面右上角“關于”旁邊的齒輪圖標
在“topic”中添加“unciv-mod”
你也可以添加以下主題中的一個或多個來界定你的mod屬性：
unciv-mod-rulesets（基本規(guī)則集mod）
unciv-mod-expansions（擴展mod - 請使用這個，而不是unciv-mod-expansion）
unciv-mod-graphics（修改圖形的mod）
unciv-mod-audio（提供音樂或修改音效的mod）
unciv-mod-maps（包含地圖的mod）
unciv-mod-fun（趣味性或者惡搞性的mod）
unciv-mod-modsofmods（擴展另一個mod的mod）
當你打開Unciv的Mod管理器時，它將查詢Github上帶有該主題的倉庫列表，現在你的倉庫將出現在那里。這些屬性將作為mod按鈕上的注釋出現，玩家可以根據它們進行過濾。而游戲不需要這些屬性來加載內容-例如，你仍然可以從缺少unciv-mod-maps屬性的mod中加載地圖。如果您想要新的類別，Github會接受任何主題，但你需要問Unciv作者團隊是否在游戲中啟用它們。
如果你覺得游戲中應該支持其他屬性，那么可以采取以下步驟：
你可以按照Github的規(guī)定向您的倉庫中添加屬性，但是如果您希望它們成為Unciv支持的屬性，它們必須以“unciv-mod-”開頭。
一旦完成，您可以選擇：
等待至少一個版本更新，檢查您的主題是否出現在ModCategories.json中，并為此文件打開一個更改拉取請求，刪除“hidden”屬性，并確切說明該主題對整個社區(qū)有益的原因。
或者，向我們提交一個指向你的帶有新屬性的mod的提案，請求我們?yōu)槟鷪?zhí)行上述操作，并再次告訴我們原因。
我已經制作好一個mod了，然后該怎么辦？
mod的主要用途是在啟動新游戲或配置地圖時添加它們。這意味著mod的規(guī)則集和圖像都將在特定游戲/地圖中使用。
對于以圖像和聲音為主的mod，還有第二種用途-通過mod管理器，您可以將它們設置為永久可見。這意味著mod中的圖像和聲音將替換游戲中的原始媒體，并且包含的音樂也可以在游戲內欣賞。詳情見---（寫完教程全集后補上鏈接）
如何手動加載mod
手動加載mod是不合適的 - 這不僅不流暢，而且更容易出錯。除非你有非常特殊的用處，不然不應該這樣做。
在Android中，它們應該進入Android/data/com.unciv.app/files/mods目錄。
在Chromebook中，轉到“Play文件”，應該在窗口左側的側邊欄下“我的文件”中。點擊窗口底部3個垂直點，在右上角。如果選項“顯示所有Play文件夾”旁邊沒有復選標記，請單擊它。你應該會在屏幕上看到一些新文件。然后就導航到Android/data/com.unciv.app/files/mods。
加載mod時，它需要位于/mods文件夾中自己的文件夾中-這是編輯mod時你務必使用的方式。
補充說明
你可以通過添加“preview.jpg”或“preview.png”文件，讓玩家在Mod管理器中看到你添加的圖像。
接下來該怎么辦？
現在你可以創(chuàng)建你的第一個mod！
建議你從添加新國家作為mod開始，來熟悉這個過程。
