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 版本。