Clone or download
Latest commit 403dc3d Nov 11, 2018
Failed to load latest commit information.
.github update invite link Apr 25, 2018
BuildCraft-Localization @ 3b3fa94 More work on filler stuffs. Jul 25, 2017
BuildCraftAPI @ 105ab7a Prepare the buildscript for allowing building inside of BCCompat. Nov 10, 2018
buildcraft_resources Fix #4300 Nov 11, 2018
common/buildcraft Fix #4300 Nov 11, 2018
common_old_license New filled template API Oct 31, 2017
gradle/wrapper Update gradle to 4.3.1, remove useless checkstyle module. Nov 26, 2017
guidelines Expand checkstyle rules to allow "___testing_" at the start of method… Apr 5, 2018
license_checker Work on filler patterns. May 18, 2017
misc Fix #3959 Jan 21, 2018
src/test/java/buildcraft/test Move a lot of the guide init code from gui open to resource reload. S… Aug 19, 2018
src_old_license/buildcraft merge upstream (part 1) Sep 29, 2017
sub_projects Stop including the expression subproject in built jars. Also push bac… Apr 3, 2018
tests/buildcraft/tests Merge remote-tracking branch 'origin/7.1.x' into alexiil-7.x-mc1.8-equal Dec 7, 2015
testsuite added test for robot pathfinding, for #1732 May 25, 2014
.gitattributes Step 2: The Rebirth Feb 17, 2014
.gitignore Large number of misc changes: Jan 15, 2017
.gitmodules Fix the BC submodule not working. Jan 29, 2017
.travis.yml Simplify the travis buildscript Nov 9, 2018
BuildCraftVersions.json A lot of stuff. Like, lots of stuff. May 6, 2016
Jenkinsfile Theoretically fix jenkins build. Jan 1, 2018
LICENSE relicense BuildCraft API to MIT, close #2248 Dec 9, 2014
LICENSE-NEW Work on particles + paint + rotation + sound. Jul 10, 2016 Fix BuildCraft name case in main Jan 9, 2018
build.gradle Theoretically fix build, attempt 3. Nov 10, 2018 Prepare the buildscript for allowing building inside of BCCompat. Nov 10, 2018
gradlew Regen wrapper. May 21, 2016
gradlew.bat Regen wrapper. May 21, 2016 Fix typos Jul 5, 2017
settings.gradle Make "sub_projects/expression" an actual gralde sub-project. Mar 11, 2018 Change "cpw.mods.fml" to "net.minecraftforge.fml" Jun 3, 2015

Welcome to BuildCraft on GitHub

Reporting an issue

Please open an issue for a bug report only if:

  • you are sure the bug is caused by BuildCraft and not by any other mod,
  • you have at least one of the following:
    • a crash report,
    • means of reproducing the bug in question,
    • screenshots/videos/etc. to demonstrate the bug.

If you are not sure if a bug report is valid, please use the "Ask Help!" subforum.

Please only use official BuildCraft releases for any kind of bug reports unless otherwise told to do by the BuildCraft team. Custom builds (for instance from Jenkins) are unsupported, often buggy and will not get any support from the developers.

Please check if the bug has been reported beforehand. Also, provide the version of BuildCraft used - if it's a version compiled from source, link to the commit/tree you complied from.

Please mention if you are using MCPC+, Cauldron, OptiFine, FastCraft or any other mods which optimize or otherwise severely modify the functioning of the Minecraft engine. That is very helpful when trying to reproduce a bug.

Please do not open issues for features unless you are a member of the BuildCraft team. For that, use the "Feature Requests" subforum.

BuildCraft, being an open-source project, gives you the right to submit a pull request if a particular fix or feature is important to you. However, if the change in question is major, please contact the team beforehand - we wish to prevent wasted effort.


If you wish to submit a pull request to fix bugs or broken behaviour feel free to do so. If you would like to add features or change existing behaviour or balance, please discuss it on discord before submitting a PR (

Do not submit pull requests which solely "fix" formatting. As these kinds of changes are usually very intrusive in commit history and everyone has their own idea what "proper formatting" is, they should be done by one of the main contributors. Please only submit "code cleanup", if the changes actually have a substantial impact on readability.

PR implementing new features or changing large portions of code are helpful. But if you're doing such a change and if it gets accepted, please don't "fire and forget". Complex changes are introducing bugs, and as thorough as testing and peer review may be, there will be bugs. Please carry on playing your changes after initial commit and fix residual issues. It is extremely frustrating for others to spend days fixing regressions introduced by unmaintained submissions.

Frequently reported

  • java.lang.AbstractMethodError, java.lang.NoSuchMethodException
    • A mod has not updated to the current BuildCraft API
    • You are not using the correct version of BuildCraft for your Forge/Minecraft versions
    • You are using the dev version on a normal game instance (or vice versa)
  • Render issue (Quarry causes flickering) - Try without OptiFine first! This is a known issue with some versions of OptiFine.

Compiling and packaging BuildCraft

  1. Ensure that Java (found here), Git (found here) are installed correctly on your system.
  • Optional: Install Gradle (found here)
  1. Create a base directory for the build
  2. Clone the BuildCraft repository into 'baseDir/BuildCraft/'
  3. Clone (and update) the submodules into 'baseDir/BuildCraft with 'git submodule init' and 'git submodule update'
  4. Navigate to basedir/BuildCraft in a shell and run one of two commands:
  • gradlew setupCIWorkspace build to just build a current jar (this may take a while).
  • gradlew setupDecompWorkspace to setup a complete development environment.
  • With Gradle installed: use gradle instead of gradlew
  • On Windows: use gradlew.bat instead of gradlew
  1. The compiles and obfuscated module jars will be in 'baseDir/BuildCraft/build/libs/<build number>/modules'

Your directory structure should look like this before running gradle:

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

And like this after running gradle:

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


Localizations can be submitted here. Localization PRs against this repository will have to be rejected.

Depending on BuildCraft

Instructions for depending on BC 7.1.x can be found here (for 1.7.10).

8.0.x hasn't been finished yet, so there are no instructions for depending on it :(

The following instructions are for BC 7.99.12 (1.12.2):

Add the following to your build.gradle file:

repositories {
    maven {
        name "BuildCraft"
        url = ""

If you want to depend on JUST the API then do this:

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

If you want to depend on JUST the lib then do this:

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

If you want to depend on the whole of buildcraft do this:

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

Where 7.99.12 is the desired version of BuildCraft.