Skip to content
The resources for the guide book, used in buildcraft 7.99.x and later.
Branch: 8.0.x-1.12
Clone or download
Latest commit 14ea770 Jul 28, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
guide_resources Move all of the guide book content over from the main repository, and… Jul 27, 2019
setup_guide Move all of the guide book content over from the main repository, and… Jul 27, 2019
LICENSE Initial commit Jul 21, 2019
README.md Update README Jul 27, 2019

README.md

BuildCraftGuide

The resources for the guide book, used in buildcraft for minecraft 1.12.2 and later.

Testing

There are two ways to test forks of this repository: either the simple way or the better (but more complex) way.

Both of the options need git installed, or one of the GUI based git alternatives.

The simple way

  1. Create a new nearly-empty profile in your minecraft launcher, which points to a separate folder for running the game in.
    • (This should use minecraft 1.12.2)
  2. Install the recommended versions of forge and buildcraft for 1.12.2.
    • (Generally it's simpler if the only installed mod is buildcraft and related mods).
  3. Clone this repository using the command git clone https://github.com/BuildCraft/BuildCraftGuide.git into a completely different folder
    • This should create a folder called "BuildCraftGuide", which contains a few files and a "guide_resources" folder
  4. Copy the "guide_resources" folder into the "resourcepacks" folder in the newly-created profile.
  5. Enable that resource pack in the resource pack selection screen, which should look something like this:

Guide setup screenshot

The better way

This is identical to the simple way, but uses a symbolic link (wikipedia) rather than copying the folder across. (This saves time when testing out changes to the git repository, as modifications to the git-tracked directory will also update the symbolic linked directory).

Note that a symbolic link is not the same as a windows shortcut, as they work in different ways.

  1. Create a new nearly-empty profile in your minecraft launcher, which points to a separate folder for running the game in.
    • (This should use minecraft 1.12.2)
  2. Install the recommended versions of forge and buildcraft for 1.12.2.
    • (Generally it's simpler if the only installed mod is buildcraft and related mods).
  3. Clone this repository using the command git clone https://github.com/BuildCraft/BuildCraftGuide.git into a completely different folder
    • This should create a folder called "BuildCraftGuide", which contains a few files and a "guide_resources" folder
  4. Create a symbolink link in the "resourcepacks" folder in the newly-created profile, which points to the "guide_resources" folder
    • In Mac OSX or Linux you'll need to run the following commands in a terminal: cd /the_profile_directory/resourcepacks/ ln -s /the_cloned_directory/BuildCraftGuide/guide_resources
    • In Windows the process is a bit more of a pain, but (apparently) still possible in an (administrator) command prompt: cd C:\the_profile_directory\resourcepacks\ mklink /D Link
  5. Enable that resource pack in the resource pack selection screen, which should look the same as the simple way's screenshot.

Contributing

Unlike testing there are a few additional steps you need to take to contribute to this repository. You'll need a github account, and a fork of this repository. You'll also need reasonable knowledge of working with git itself (to update your forked version to the latest version on github, pushing your own changes, switching brances, etc).

While it's possible to contribute directly through github's website please limit this to only minor changes - as you won't be able to test your changes.

Unlike when testing you'll need to clone your forked repository and add the original repository as an additional remote (or clone the original repository and add your fork as an additional remote).

Adding content

The simplest content to add is just to improve an existing markdown page - so any file that ends with ".md".

Most of the time you can just write text normally (or prefix a chapter with # hashes), however for anything special (like links, colours, recipes, etc) you'll need to refer to the Guide Page File Format page.

New pages

Adding additional pages also requires a few more things:

Translations

Currently no translations are accepted - at least not until a page has a fully-correct english page that it can be translated from.

You can’t perform that action at this time.