BuildCraft

歡迎來到 GitHub 上的 BuildCraft

報告問題

僅在以下情況下才請提出錯誤回報問題：

• 您確定該錯誤是由 BuildCraft 而不是任何其他 mod 引起的，
• 您至少具備以下條件之一：
  • 崩潰報告，
  • 重現相關錯誤的方法，
  • 螢幕截圖/影片/等。來示範該錯誤。

如果您不確定錯誤報告是否有效，請使用“尋求協助！”分論壇。

除非 BuildCraft 團隊另有指示，否則請僅使用官方 BuildCraft 版本來報告任何類型的錯誤。自訂建置（例如來自 Jenkins）不受支援，通常有錯誤，並且不會得到開發人員的任何支援。

請檢查是否已事先回報該錯誤。另外，提供使用的 BuildCraft 版本 - 如果它是從原始程式碼編譯的版本，請連結到您編譯的提交/樹。

請註明您是否使用 MCPC+、Cauldron、OptiFine、FastCraft 或任何其他優化或以其他方式嚴重修改 Minecraft 引擎功能的 mod。當嘗試重現錯誤時，這非常有幫助。

除非您是 BuildCraft 團隊的成員，否則請不要提出功能問題。為此，請使用“功能請求”子論壇。

BuildCraft 作為一個開源項目，如果特定修復或功能對您很重要，您有權提交拉取請求。但是，如果問題的變更較大，請提前聯繫團隊 - 我們希望防止浪費精力。

貢獻

如果您希望提交拉取請求來修復錯誤或損壞的行為，請隨時這樣做。如果您想新增功能或變更現有行為或平衡，請在提交 PR 之前在 Discord 上進行討論 (https://discord.gg/v4geqgA)。

不要提交僅“修復”格式的拉取請求。由於這些類型的更改通常會非常乾擾提交歷史記錄，並且每個人都有自己的想法什麼是“正確的格式”，因此它們應該由主要貢獻者之一來完成。如果更改確實對可讀性產生重大影響，請僅提交「程式碼清理」。

實作新功能或更改大部分程式碼的 PR 很有幫助。但如果你正在做這樣的改變並且被接受，請不要「解僱後忘記」。複雜的更改會引入錯誤，儘管測試和同行評審可能很徹底，但還是會出現錯誤。請在初次提交後繼續播放您的變更並修復殘留問題。對於其他人來說，花費數天時間來修復因未維護的提交而引入的回歸是非常令人沮喪的。

經常被報道

• java.lang.AbstractMethodError、java.lang.NoSuchMethodException
  • mod 尚未更新到目前的 BuildCraft API
  • 您沒有使用適合您的 Forge/Minecraft 版本的 BuildCraft 版本
  • 您正在普通遊戲實例上使用開發版本（反之亦然）
• 渲染問題（Quarry 導致閃爍）- 首先嘗試不使用 OptiFine！這是某些版本的 OptiFine 的已知問題。

編譯並打包BuildCraft

1. 確保Java （在此處找到）、 Git （在此處找到）已正確安裝在您的系統上。

• 可選：安裝Gradle （可在此處找到）。您可能想要安裝版本 4.3.1。

2. 為建置建立一個基本目錄
3. 將 BuildCraft 儲存庫複製到「baseDir/BuildCraft/」中
4. 使用“git submodule init”和“git submodule update”將子模組複製（並更新）到“baseDir/BuildCraft”中
5. 在 shell 中導航到 basedir/BuildCraft 並執行以下兩個命令之一：
   • ./gradlew setupCIWorkspace build僅建置目前的 jar （這可能需要一段時間）。
   • ./gradlew setupDecompWorkspace設定完整的開發環境。
   • 安裝Gradle後：使用gradle而不是./gradlew
   • 在 Windows 上：使用gradlew.bat而不是./gradlew
6. 編譯與混淆的模組 jar 將位於 'baseDir/BuildCraft/build/libs/<build number>/modules' 中

在運行 gradle 之前，你的目錄結構應該如下所示：

---

 baseDir
- BuildCraft
 |- buildcraft_resources
 |- common
 |- ...
 - BuildCraftAPI
  |- api
  |- ...
 - BuildCraft-Localization
  |- lang
  |- ...

---

運行 gradle 後像這樣：

---

 basedir
- BuildCraft
 |- .gradle
 |- build
 |- buildcraft_resources
 |- common
 |- ...
 - BuildCraftAPI
  |- api
  |- ...
 - BuildCraft-Localization
  |- lang
  |- ...

---

在地化

本地化版本可以在此處提交。針對此儲存庫的本地化 PR 將必須被拒絕。

取決於BuildCraft

可以在此處找到依賴 BC 7.1.x 的說明（針對 1.7.10）。

8.0.x 尚未完成，因此沒有依賴它的說明:(

以下說明適用於 BC 7.99.12 (1.12.2)：

將以下內容新增至您的 build.gradle 檔案：

 repositories {
    maven {
        name "BuildCraft"
        url = "https://mod-buildcraft.com/maven"
    }
}

如果您只想依賴 API，請執行以下操作：

 dependencies {
    deobfCompile "com.mod-buildcraft:buildcraft-api:7.99.12"
}

如果您只想依賴該庫，請執行以下操作：

 dependencies {
    deobfCompile "com.mod-buildcraft:buildcraft-lib:7.99.12"
}

如果您想依賴整個 buildcraft ，請執行以下操作：

 dependencies {
    deobfCompile "com.mod-buildcraft:buildcraft:7.99.12"
}

其中7.99.12是所需的 BuildCraft 版本。