簡介面向《殺戮尖塔》模組開發(fā)初學(xué)者的入門指南旨在幫助沒有Java與Mod經(jīng)驗的玩家從零搭建MOD開發(fā)環(huán)境并完成第一個可運行的MOD項目。教程圍繞modthespire、stslib和basemod三大支持庫展開清楚解釋它們?nèi)绾卧谟螒虮倔w與自定義代碼之間建立接口同時覆蓋IntelliJ IDEA安裝、Maven環(huán)境變量配置、pom.xml編輯與依賴聲明等關(guān)鍵環(huán)節(jié)。資源以1個PDF文檔封裝大小約1.5MB結(jié)構(gòu)緊湊包含游戲本體安裝、創(chuàng)意工坊支持庫訂閱、開發(fā)環(huán)境搭建、構(gòu)建步驟以及Java語法基礎(chǔ)等章節(jié)并配有控制臺輸出、變量、函數(shù)、類作用域、監(jiān)聽函數(shù)與繼承等示例講解。通過Maven構(gòu)建時如何指定Steam游戲庫路徑、如何引用BaseMod依賴等細(xì)節(jié)也有直觀展示適合希望快速入門的玩家邊看邊練。目前已有2121人學(xué)習(xí)下載能夠幫助讀者從環(huán)境準(zhǔn)備到代碼實現(xiàn)逐步建立起對MOD結(jié)構(gòu)的基本認(rèn)知適合作為殺戮尖塔Mod開發(fā)的第一份學(xué)習(xí)資料。1. 做殺戮尖塔Mod前先把三件事想清楚殺戮尖塔的Mod開發(fā)說到底是給一個Java 8時代的老游戲?qū)懲鈷齑a這句話決定了后面所有的版本選擇。很多第一次上手的人栽在同一個地方按最新教程裝了最新JDK和最新Maven結(jié)果ModTheSpire加載器根本不認(rèn)或者構(gòu)建出的jar包進(jìn)游戲就閃退?；艘煌砩献詈蟀l(fā)現(xiàn)是版本和路徑的問題。這篇教程把游戲本體、三大支持庫、IDE、Maven這一整條鏈路的安裝和配置走一遍所有參數(shù)都給你拆開講照著做就能把第一個能加載的jar跑出來。適合以前沒配過Java環(huán)境、對創(chuàng)意工坊目錄結(jié)構(gòu)不熟、或者卡在pom.xml上不知道怎么改的人。裝好這套環(huán)境你才能開始談寫卡牌、寫事件、改機制。2. 裝依賴游戲本體、ModTheSpire、BaseMod與stslib的下載與訂閱2.1 游戲本體買了不一定能馬上開發(fā)游戲本體是全部工作的基礎(chǔ)但“裝了游戲”和“能開發(fā)Mod”是兩回事。很多教程把這一步標(biāo)個“略”實際上這里有個前置條件至少用普通模式啟動過一次游戲讓Steam把游戲文件完整解壓落盤。新下載的游戲有時候文件還沒就緒直接開Mod加載器會報文件缺失。開發(fā)時我們需要的是游戲根目錄下的這個文件SteamLibrary/steamapps/common/SlayTheSpire/desktop-1.0.jar這是游戲的主程序jar也就是Mod要注入的目標(biāo)本體。后面的pom.xml會直接用系統(tǒng)路徑引用它所以在開工之前先找到你的SteamLibrary在哪。Steam默認(rèn)裝的路徑通常是C:\Program Files (x86)\Steam\steamapps但很多人的游戲庫在別的盤這個路徑記下來后面配置里要反復(fù)用。如果游戲剛裝好我的建議是先普通模式啟動一次看看能不能正常進(jìn)游戲。能進(jìn)再關(guān)掉繼續(xù)配環(huán)境。別一上來就想著上Mod先確認(rèn)本體是好的否則后面所有報錯你都沒法判斷是游戲問題還是Mod問題。2.2 創(chuàng)意工坊訂閱三大庫每個庫的職責(zé)先分清殺戮尖塔的Mod生態(tài)依賴三個Steam創(chuàng)意工坊模組ModTheSpire、BaseMod、stslib。這三者分工不同訂閱之前先把職責(zé)理清楚后面排查問題會省很多時間ModTheSpireMod加載器。沒有它游戲啟動時不會掃描和加載任何Mod jar。它負(fù)責(zé)識別ModTheSpire.json、執(zhí)行SpireInitializer注解、打印加載日志。也就是說你的Mod寫了代碼靠的是它來拉起。BaseModMod API支持庫。提供大量與游戲交互的接口比如監(jiān)聽抽牌事件、受傷事件、戰(zhàn)斗結(jié)束事件以及注冊卡牌、角色、藥水的API。寫Mod基本離不開它。stslib擴展庫。提供了不少現(xiàn)成的卡牌動作、UI組件和機制模板不是每個Mod都必須用但推薦先訂閱上一方面測試別人的Mod經(jīng)常需要它另一方面以后你用到特定功能時不用再回頭補。訂閱方式很簡單在Steam客戶端里打開《殺戮尖塔》的商店頁面進(jìn)入創(chuàng)意工坊分別搜索這三個名字點訂閱。等Steam自動下載完成即可。需要特別提醒一點訂閱只是加入下載隊列不等于已經(jīng)下載完成。Steam創(chuàng)意工坊的模組是異步下載的你得切到Steam的“下載”頁面確認(rèn)這三個都到了100%再去下一步。很多人卡在“我訂閱了為什么游戲里看不到”這個問題上原因往往就是下載根本沒完成。2.3 確認(rèn)三個jar的落盤位置創(chuàng)意工坊訂閱的模組下載完成后會落在SteamLibrary的workshop目錄里路徑規(guī)律是SteamLibrary/steamapps/workshop/content/646570/模組ID/模組文件.jar這里的646570是殺戮尖塔在Steam創(chuàng)意工坊的內(nèi)容ID。三個依賴庫中BaseMod和ModTheSpire的jar路徑在后續(xù)pom.xml里會直接用到必須提前確認(rèn)。下面是我這邊的路徑示例文件作用預(yù)期位置desktop-1.0.jar游戲本體SteamLibrary/steamapps/common/SlayTheSpire/desktop-1.0.jarBaseMod.jarMod APISteamLibrary/steamapps/workshop/content/646570/1605833019/BaseMod.jarModTheSpire.jarMod加載器SteamLibrary/steamapps/workshop/content/646570/1605060445/ModTheSpire.jarStSLib.jar擴展庫SteamLibrary/steamapps/workshop/content/646570/對應(yīng)ID/StSLib.jar注意1605833019和1605060445這兩個數(shù)字是BaseMod和ModTheSpire在創(chuàng)意工坊里的固定ID后面配置依賴時要用。stslib的ID不用強行記到時候在workshop目錄里翻一下就能找到但你要記住它存在。打開資源管理器把上面的路徑逐個走一遍確認(rèn)這些jar文件都真實存在。這一步偷懶不得——pom.xml里的systemPath寫的是絕對路徑路徑錯一個字符構(gòu)建就會報“系統(tǒng)找不到指定的路徑”而且報錯信息往往要到很后面才暴露排查起來相當(dāng)難受。如果你用的是Mac或Linux路徑結(jié)構(gòu)類似只是前綴從E:\SteamLibrary變成/home/你的用戶名/.steam/steam/steamapps之類的掛載位置原理完全一樣照著后面的邏輯替換即可。3. 搭開發(fā)環(huán)境JDK 8、IDEA社區(qū)版與Maven的Windows配置3.1 為什么選JDK 8而不是最新版殺戮尖塔本體是Java 8時代的工程Mod最終要注入到這個老工程里運行。官方推薦和大多數(shù)Mod作者使用的都是JDK 8你去看pom.xml里的編譯配置寫的是source 1.8和target 1.8意思就是編譯出Java 8版本的class文件。有人會問我用JDK 17編譯時把target設(shè)成1.8行不行行是行但沒必要給自己找麻煩。高版本JDK在編譯老項目時經(jīng)常報一些莫名其妙的警告和錯誤比如Invalid source release或者對某些廢棄API的報錯調(diào)試起來純屬浪費時間。配環(huán)境的原則是匹配目標(biāo)運行時不是追求工具最新版。下載JDK時選8系列的最新更新版本即可裝完后在命令行驗證java -version期望輸出java version 1.8.0_202如果輸出版本號還是1.8開頭說明裝對了。如果你機器上已經(jīng)裝了更高版本的JDK也不用卸載后面在IDEA里新建項目時單獨給這個項目指定JDK 8的路徑就行互不干擾。我已經(jīng)不止一次看到有人因為不想動原有環(huán)境用高版本JDK硬編結(jié)果在target 1.8和依賴包之間反復(fù)報錯最后還是乖乖裝了8。裝一次一勞永逸。3.2 IDEA社區(qū)版免費夠用Java開發(fā)的IDE基本就是在Eclipse和IntelliJ IDEA之間選兩個都有免費版本。這篇教程以IDEA為例因為它的Maven支持和代碼提示對新手更友好而且社區(qū)版已經(jīng)覆蓋了開發(fā)Mod需要的全部功能。到IDEA官網(wǎng)下載Community版本也就是社區(qū)版。安裝過程中按默認(rèn)選項走即可建議勾選“創(chuàng)建桌面快捷方式”和“添加到PATH”后面在命令行里執(zhí)行maven命令會更方便。安裝完成后先不要急著建項目下一步先把Maven配好因為IDEA新建Maven項目時要調(diào)用本機的Maven配置。3.3 Maven下載、解壓、配MAVEN_HOMEMaven是一個構(gòu)建工具負(fù)責(zé)拉依賴、編譯、打包、輸出jar。殺戮尖塔Mod項目里pom.xml描述了項目結(jié)構(gòu)Maven按這個文件去執(zhí)行構(gòu)建。Windows下的配置步驟如下下載Maven的二進(jìn)制壓縮包版本選3.3.9與這篇教程配套的pom.xml版本一致。解壓到一個路徑中不含中文、不含空格的目錄比如E:\Maven\apache-maven-3.3.9。含中文或空格的路徑在后續(xù)構(gòu)建時可能引發(fā)奇怪的報錯直接避掉比事后排查劃算。然后是設(shè)置環(huán)境變量右鍵“此電腦”選擇“屬性”進(jìn)入“高級系統(tǒng)設(shè)置”點擊“環(huán)境變量”。在系統(tǒng)變量區(qū)域點擊“新建”變量名填MAVEN_HOME變量值填Maven解壓后的完整路徑也就是E:\Maven\apache-maven-3.3.9。找到系統(tǒng)變量里的Path雙擊編輯點擊“新建”填入%MAVEN_HOME%\bin。點擊確定保存所有對話框然后新開一個命令行窗口。這里有個高頻翻車點很多人改完環(huán)境變量后在一個舊的命令行窗口里執(zhí)行命令發(fā)現(xiàn)mvn不存在就懷疑配置錯了。環(huán)境變量在舊窗口里不會刷新必須全部關(guān)掉重開才生效。新開窗口這一步不是儀式感是實打?qū)嵉目印?.4 組合驗證java與mvn一起跑打開新命令行窗口依次執(zhí)行java -version mvn -versionmvn -version的輸出應(yīng)該包含類似這樣的信息Apache Maven 3.3.9 Java version: 1.8.0_202只要這兩條都能正常輸出開發(fā)環(huán)境就通了。記住這個組合命令以后排查環(huán)境問題第一條就是它。Java和Maven任何一個輸出異常你的Mod項目整個就沒法構(gòu)建所以先把這兩行跑順再往下走。4. 建項目pom.xml依賴注入與ModTheSpire.json注冊4.1 在IDEA里新建Maven項目打開IDEA創(chuàng)建新項目選擇Maven類型。這里有一步容易困惑IDEA會問你要不要選archetype模板這里是不要勾選任何archetype的直接按最簡單的骨架創(chuàng)建。填寫項目信息GroupId填org.exampleArtifactId填tutorial項目名取tutorial。ArtifactId會作為工程標(biāo)識的一部分后面生成的jar包默認(rèn)也叫這個名字建議取一個不帶空格、全小寫的名字避免后續(xù)路徑和文件名出問題。創(chuàng)建完成后IDEA右下角通常會彈出一個提示說檢測到Maven配置發(fā)生變化這時點擊“Import Changes”或“Enable Auto-Import”。如果你沒看到提示等Maven自動導(dǎo)入完成也可以。這時候項目目錄結(jié)構(gòu)大致是這樣的tutorial/ ├── .idea/ # IDE輔助文件不用管 ├── src/ │ ├── main/ │ │ ├── java/ # 存放Java代碼 │ │ └── resources/ # 存放json、圖片等素材 │ └── test/ # Maven自動生成的測試目錄 └── pom.xml # Maven構(gòu)建配置.idea文件夾是IDEA自己的與Mod無關(guān)。src/main/java是你寫代碼的地方src/main/resources放ModTheSpire.json這類資源文件。Maven會自動處理test目錄相關(guān)的細(xì)節(jié)暫時不用管。4.2 pom.xml逐塊拆解路徑、依賴、構(gòu)建pom.xml是這個項目的命根子它負(fù)責(zé)告訴Maven三件事依賴哪些jar、編譯成什么版本、構(gòu)建完把jar復(fù)制到哪里。下面這個是我配好的完整配置注意steam.path用的是正斜杠?xml version1.0 encodingUTF-8? project xmlnshttp://maven.apache.org/POM/4.0.0 xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:schemaLocationhttp://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd modelVersion4.0.0/modelVersion groupIdorg.example/groupId artifactIdtutorial/artifactId version0.1/version packagingjar/packaging nametutorialMod/name descriptiontutorial/description properties project.build.sourceEncodingUTF-8/project.build.sourceEncoding steam.pathE:/SteamLibrary/steamapps/steam.path /properties dependencies dependency groupIdbin/groupId artifactIdBaseMod/artifactId scopesystem/scope version1.0/version systemPath${steam.path}/workshop/content/646570/1605833019/BaseMod.jar/systemPath /dependency dependency groupIdbin/groupId artifactIdSlayTheSpire/artifactId scopesystem/scope version1.0/version systemPath${steam.path}/common/SlayTheSpire/desktop-1.0.jar/systemPath /dependency dependency groupIdbin/groupId artifactIdModTheSpire/artifactId scopesystem/scope version1.0/version systemPath${steam.path}/workshop/content/646570/1605060445/ModTheSpire.jar/systemPath /dependency /dependencies build finalNametutorialMod/finalName plugins plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-compiler-plugin/artifactId version3.7.0/version configuration source1.8/source target1.8/target /configuration /plugin plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-antrun-plugin/artifactId version1.8/version executions execution phasepackage/phase goals goalrun/goal /goals configuration target copy filetarget/tutorialMod.jar tofile${steam.path}/common/SlayTheSpire/mods/tutorialMod.jar/ /target /configuration /execution /executions /plugin /plugins /build /project逐塊說明一下關(guān)鍵參數(shù)。properties里的steam.path是整個配置文件的基礎(chǔ)路徑后面所有系統(tǒng)依賴都用${steam.path}拼接。這個值要填你的Steam庫根目錄路徑分隔符建議用正斜杠。Windows下很多人習(xí)慣寫E:\SteamLibrary\steamapps但在XML里反斜杠是轉(zhuǎn)義符與后面的字符組合后可能被解析成別的東西。寫成E:/SteamLibrary/steamapps是更穩(wěn)妥的寫法能少踩一個坑。dependencies里三個依賴是Mod開發(fā)的基石BaseMod.jar提供API接口desktop-1.0.jar是游戲本體ModTheSpire.jar是加載器。注意這里沒有引入stslib因為它不是每個Mod都直接用到。等你后續(xù)代碼里真的要調(diào)用stslib里的類時再把它的jar路徑以同樣方式追加一條依賴即可。三個依賴的scope都標(biāo)為system意思是Maven不走中央倉庫拉取直接讀你本機的文件。version填1.0只是占位符system范圍下的依賴版本號不會被實際校驗。build里的finalName決定了輸出jar的名字這里填tutorialMod。maven-compiler-plugin配置了source和target都是1.8即編譯產(chǎn)物的Java版本。maven-antrun-plugin則是把package階段輸出的jar文件復(fù)制到游戲的mods目錄這樣構(gòu)建完直接啟動游戲就能在加載器里看到。這里的tofile路徑后半段common/SlayTheSpire/mods需要你在游戲根目錄下手動創(chuàng)建一個mods文件夾否則antrun復(fù)制時會報目標(biāo)路徑不存在。所有依賴的路徑都要和你在2.3節(jié)里實際確認(rèn)過的位置一一對應(yīng)。尤其是workshop/content/646570/后面的數(shù)字ID不能憑記憶寫去資源管理器里親眼確認(rèn)過再填進(jìn)配置。4.3 ModTheSpire.json讓加載器認(rèn)識你的Mod打開src/main/resources目錄在里面新建一個文件命名為ModTheSpire.json。這個文件的作用是告訴ModTheSpire加載器我這個Mod叫什么、是誰寫的、依賴誰、版本是多少。內(nèi)容如下{ modid: tutorial, name: tutorialMod, author_list: [A, B], description: 新手教程mod, version: 0.0.1, sts_version: 03-29-2018, mts_version: 2.6.0, dependencies: [basemod] }各字段的含義modid是這個Mod的唯一標(biāo)識加載器靠它區(qū)分不同的Mod所以全小寫且不要有空格。它最好和你在4.1節(jié)里填的ArtifactId保持一致后面寫代碼時包名也會用到它三者對齊能省很多不必要的加載報錯。name是顯示在ModTheSpire加載列表里的名字可以隨意。author_list是一個數(shù)組可以寫多個作者用方括號和逗號分隔。description是一段文本描述會顯示在游戲的Mod菜單里。version和mts_version代表你的Mod版本號和ModTheSpire的版本號。dependencies數(shù)組里寫basemod表示你的Mod在加載時要先加載BaseMod這在游戲里會表現(xiàn)成加載順序的依賴關(guān)系。sts_version對應(yīng)的是游戲版本這里填的是教程所用的示例版本。你實際填的時候可以打開ModTheSpire的加載日志里面會顯示它識別到的游戲版本信息以日志為準(zhǔn)。JSON格式的注意點集中在括號配對花括號{}表示對象方括號[]表示數(shù)組逗號分隔同級元素。寫錯了IDE會直接標(biāo)紅但如果IDE沒標(biāo)紅也不代表沒問題——這個文件里如果有多個對象漏一個逗號這種錯誤IDE經(jīng)常能發(fā)現(xiàn)。4.4 執(zhí)行package構(gòu)建并確認(rèn)產(chǎn)物所有配置寫完開始構(gòu)建測試。在IDEA右側(cè)找到Maven面板展開Lifecycle雙擊package。這個操作會按順序走完validate、compile、test、package整個生命周期最終在target目錄下生成jar文件。也可以直接在IDEA的Terminal里執(zhí)行mvn package兩種方式等價區(qū)別僅是前者用的是IDEA內(nèi)置的Maven配置后者用的是你命令行里配置的獨立Maven。我一般直接用mvn package這樣環(huán)境變量對不對一目了然不會被IDEA內(nèi)置配置掩蓋問題。構(gòu)建成功后檢查兩個地方target/tutorialMod.jar是否生成——這是Maven的輸出產(chǎn)物。游戲根目錄的mods文件夾里是否出現(xiàn)同名jar——這是antrun插件復(fù)制過去的結(jié)果。只要這兩個文件都存在配置就通了。然后啟動游戲注意要用withmod模式的啟動方式進(jìn)入。在ModTheSpire的加載界面里勾選BaseMod、ModTheSpire和你剛輸出的tutorialMod點運行。進(jìn)入游戲后打開Mod菜單應(yīng)該能看到你在ModTheSpire.json里寫的名稱和描述信息。此時這個Mod還沒有任何功能只是個空殼但它已經(jīng)證明整條鏈路是通的。接下來全部的工作就是往這個殼里寫邏輯。5. 避坑排查環(huán)境配置與構(gòu)建環(huán)節(jié)的常見問題5.1 構(gòu)建顯示BUILD SUCCESS但游戲里看不到我的Mod現(xiàn)象mvn package跑完日志輸出BUILD SUCCESSIDEA的target目錄里jar也存在但啟動游戲后ModTheSpire界面里根本沒有這個Mod的選項。原因最典型的兩個。一是jar沒有被復(fù)制到ModTheSpire實際掃描的目錄里。你要確認(rèn)加載器到底掃的是哪個目錄——大多數(shù)情況下是游戲根目錄下的mods文件夾但如果你把jar直接扔到結(jié)合了創(chuàng)意工坊的目錄里掃描范圍可能會被加載器配置影響。二是ModTheSpire.json沒被正確打進(jìn)jar包內(nèi)部或者json格式有誤加載器解析失敗后直接跳過。解決先解開jar看內(nèi)部結(jié)構(gòu)。把jar用壓縮軟件打開確認(rèn)ModTheSpire.json在jar包的根目錄下而不是躺在某個子文件夾里。然后檢查游戲mods目錄下的jar文件是否真的存在且大小與target下的產(chǎn)物一致。最后在游戲里點運行時注意看加載日志它會打印每個Mod的加載狀態(tài)被跳過的項目會顯示具體原因這是最直接的判據(jù)。日志里記載的信息遠(yuǎn)比IDE里那行BUILD SUCCESS真實。5.2 路徑里用反斜杠Maven報“系統(tǒng)找不到指定的路徑”現(xiàn)象pom.xml里steam.path寫的是E:\SteamLibrary\steamapps構(gòu)建時提示找不到路徑但是資源管理器里路徑明明存在。原因XML規(guī)范里反斜杠是轉(zhuǎn)義字符后面跟著的字符會被組合解析。\S、\s這類組合在XML解析時行為不穩(wěn)定路徑就這樣被悄悄改寫了。這個問題在Windows用戶里極其常見。解決把steam.path里的反斜杠全部改成正斜杠E:/SteamLibrary/steamapps。Maven在Windows下完全支持正斜杠路徑。如果你特別想用反斜杠那就寫成E:\\SteamLibrary\\steamapps雙反斜杠是XML里的正確轉(zhuǎn)義方式但可讀性差得多。從這以后我凡是寫XML里的路徑一律正斜杠不是玄學(xué)是避免解釋器做多余事。5.3 命令行執(zhí)行mvn提示“不是內(nèi)部或外部命令”現(xiàn)象新開一個CMD窗口執(zhí)行mvn -version系統(tǒng)提示mvn不是內(nèi)部或外部命令也不是可運行的程序。原因Maven的bin目錄沒有正確加入Path環(huán)境變量。這一步常見的錯誤有MAVEN_HOME變量名拼錯、Path里寫成了%MAVEN_HOME%\bin;多余的分號、或者是修改環(huán)境變量后沒有新開終端窗口直接就在舊窗口里跑了。解決重新打開環(huán)境變量編輯界面確認(rèn)MAVEN_HOME指向Maven解壓目錄本身不是bin目錄確認(rèn)Path里的條目是%MAVEN_HOME%\bin然后徹底關(guān)掉所有命令行窗口重新打開一個再試。這個問題的排查順序永遠(yuǎn)是先看變量值再看窗口是否新開。我見過最離譜的情況是用戶把MAVEN_HOME直接設(shè)成了E:\Maven\apache-maven-3.3.9\bin然后又在Path里加了一次bin雙重疊加后果就是mvn執(zhí)行時報找不到某個文件排查起來繞了很大一圈。5.4 修改pom.xml后IDEA報依賴錯誤右側(cè)Maven面板一片紅現(xiàn)象復(fù)制教程的pom.xml后IDEA的Maven面板刷新時顯示一堆依賴錯誤日志右鍵項目跑package直接報錯。原因多數(shù)情況下是依賴路徑里的jar文件不存在。system scope的依賴不會自動從遠(yuǎn)程下載路徑只要有一點偏差I(lǐng)DE就會顯示紅色報錯。另外有可能是復(fù)制XML時漏了標(biāo)簽比如properties里少寫了一個閉合標(biāo)簽整個pom結(jié)構(gòu)就崩了。解決先看IDEA的Event Log或Maven面板的輸出它會具體報告哪個依賴的哪條路徑失效?；厝ブ鹨缓藢?.3節(jié)里那張表格尤其是workshop目錄下的兩個數(shù)字ID最常錯的就是這里。XML結(jié)構(gòu)問題則借助格式化工具或者直接在IDEA里打開pom.xmlIDE的XML解析器會告訴你第幾行有語法錯誤。改完之后點Maven面板頂部的刷新按鈕重新導(dǎo)入而不是直接跑構(gòu)建。5.5 加載Mod后日志顯示類找不到或版本不匹配現(xiàn)象ModTheSpire加載時日志打印ClassNotFoundException或者提示某個類的方法簽名對不上。原因最可能的是ModTheSpire和BaseMod的版本與你當(dāng)前游戲版本不匹配。游戲更新后創(chuàng)意工坊里的BaseMod和ModTheSpire如果沒有同步更新Mod運行時會引用到過期的API。另一種可能是你的jar包里混入了編譯期打包進(jìn)去的舊依賴類干擾了類加載。解決把創(chuàng)意工坊里的三個庫重新訂閱并強制更新到最新版同時確認(rèn)你的sts_version和mts_version與日志中顯示的實際版本一致。這個不用修改代碼就能解決純粹是環(huán)境匹配問題。6. 驗證跑通從加載日志到第一個監(jiān)聽函數(shù)構(gòu)建成功只是一個開始真正證明Mod活著要看游戲里跑起來之后的行為。我每次裝完環(huán)境都會先做一次空殼驗證再寫一段代碼做交互驗證。先寫第一個能產(chǎn)生輸出的小類在src/main/java下建一個包名字取小寫的modid然后在包里新建一個類文件比如Tutorial.javapackage tutorial; import com.evacipated.cardcrawl.modthespire.lib.SpireInitializer; SpireInitializer public class Tutorial { public Tutorial() { } public static void initialize() { new Tutorial(); System.out.print(hello world! 5*630); System.out.print(5 * 6 30); System.out.print(end of line!\n22 4); } }這段代碼里SpireInitializer注解告訴ModTheSpire這個類的initialize()方法是整個Mod的入口。initialize()里new Tutorial()是調(diào)構(gòu)造函數(shù)創(chuàng)建對象然后連續(xù)三行輸出打印字符串和表達(dá)式計算結(jié)果。這段代碼加載成功后ModTheSpire的日志框里能看到hello world! 5*63060這樣的輸出開頭還會帶一個類似2ms的時間標(biāo)記表示加載這個類花了多長時間?？吹竭@個log環(huán)境才叫真正的通。在IDEA里執(zhí)行mvn package把新jar構(gòu)建并復(fù)制到游戲mods目錄然后以withmod模式啟動游戲。這次留意ModTheSpire的日志面板或游戲的log輸出窗口。如果控制臺出現(xiàn)了這些輸出無腦下一步即可。光有輸出還不夠我要再驗證一步Mod是否真的在和游戲里的對象互動。把類改成這樣package tutorial; import basemod.BaseMod; import basemod.interfaces.PostDrawSubscriber; import com.evacipated.cardcrawl.modthespire.lib.SpireInitializer; import com.megacrit.cardcrawl.cards.AbstractCard; SpireInitializer public class Tutorial implements PostDrawSubscriber { public Tutorial() { BaseMod.subscribe(this); } public static void initialize() { new Tutorial(); } Override public void receivePostDraw(AbstractCard abstractCard) { System.out.println(abstractCard.name); } }PostDrawSubscriber是BaseMod提供的一個接口Mod實現(xiàn)了它并在構(gòu)造函數(shù)里BaseMod.subscribe(this)完成訂閱之后每次玩家抽牌游戲都會調(diào)用receivePostDraw方法參數(shù)就是被抽到的那張牌的對象。abstractCard.name是這張卡的名字輸出到log里。如果你進(jìn)了游戲抽一張牌日志里就出現(xiàn)這張牌的名字說明你的Mod已經(jīng)能接收游戲事件、讀取游戲?qū)ο笳麄€開發(fā)鏈路徹底打通了。從這以后每次新配環(huán)境我強制自己走一遍固定驗證流程先跑java -version和mvn -version確認(rèn)基礎(chǔ)環(huán)境再構(gòu)建空殼Mod確認(rèn)加載最后用監(jiān)聽函數(shù)確認(rèn)事件互動三關(guān)全部過了才放心開始寫正式代碼。這套流程救過我很多次——有次我把ModTheSpire.json里的modid改了一個字母構(gòu)建日志一點錯沒有但游戲里出現(xiàn)了兩個Mod條目舊的那個怎么都加載不出代碼排查到最后才發(fā)現(xiàn)是modid、包名、類名三者沒對齊。從那以后每次構(gòu)建前我都會把modid、包名、類名這三樣?xùn)|西對照著讀一遍再走一遍上面的驗證清單。希望幫到你。本文還有配套的精品資源點擊獲取