2012-06-20 03:51:15 +02:00
|
|
|
## Welcome to Buildcraft on GitHub
|
|
|
|
|
|
2012-08-20 14:08:17 +02:00
|
|
|
### Contributing
|
2013-02-14 12:45:40 +01:00
|
|
|
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 with Sengir or Krapht before submiting the pull request.
|
2012-08-20 14:08:17 +02:00
|
|
|
|
2013-04-03 18:59:21 +02:00
|
|
|
### Reporting issues
|
|
|
|
|
Issues are for bugs/crashes, please do not use them to ask general questions.
|
|
|
|
|
Always include the version you are having trouble with. Or if you're building from source, which source you're building.
|
|
|
|
|
If you don't, we might assume that you are using latest-greatest and waste a bunch of time trying to reproduce
|
|
|
|
|
a problem that might have fixed been already. Such things makes for very grumpy devs. Grumpy devs spend
|
|
|
|
|
less time coding and more time doing stuff that makes them less grumpy.
|
|
|
|
|
|
2012-07-10 19:13:12 +02:00
|
|
|
### Compiling and packaging Buildcraft
|
2012-06-20 03:51:15 +02:00
|
|
|
1. Ensure that `Apache Ant` (found [here](http://ant.apache.org/)) is installed correctly on your system.
|
|
|
|
|
* Linux users will need the latest version of astyle installed as well.
|
|
|
|
|
1. Create a base directory for the build
|
2012-09-13 15:35:11 +02:00
|
|
|
1. Clone the Buildcraft repository into `basedir/BuildCraft/`
|
|
|
|
|
* Optional: Copy BuildCraft localization repository into `basedir/BuildCraft-Localization`
|
2012-09-14 01:58:38 +02:00
|
|
|
1. Navigate to basedir/Buildcraft in a shell and run `ant` (this will take 2-5 minutes)
|
2013-04-03 20:22:52 +02:00
|
|
|
1. The compiled and obfuscated jar will be in basedir/bin
|
2012-06-20 03:51:15 +02:00
|
|
|
|
2013-04-03 20:22:52 +02:00
|
|
|
Your directory structure should look like this before running ant:
|
2012-06-20 03:51:15 +02:00
|
|
|
***
|
|
|
|
|
|
|
|
|
|
basedir
|
2013-05-06 08:30:49 +02:00
|
|
|
\- buildcraft
|
2012-09-13 15:35:11 +02:00
|
|
|
|- buildcraft_resources
|
|
|
|
|
|- common
|
2012-06-20 03:51:15 +02:00
|
|
|
|- ...
|
2013-05-06 08:30:49 +02:00
|
|
|
\- buildcraft.localization
|
2012-09-13 15:35:11 +02:00
|
|
|
|- lang
|
2012-06-20 03:51:15 +02:00
|
|
|
|
2012-09-11 14:10:38 +02:00
|
|
|
***
|
|
|
|
|
|
2013-04-03 20:22:52 +02:00
|
|
|
And like this after running ant:
|
|
|
|
|
***
|
|
|
|
|
|
|
|
|
|
basedir
|
2013-05-06 08:30:49 +02:00
|
|
|
\- buildcraft
|
2013-04-03 20:22:52 +02:00
|
|
|
|- bin
|
|
|
|
|
|- build
|
|
|
|
|
|- buildcraft_resources
|
|
|
|
|
|- common
|
|
|
|
|
|- download
|
|
|
|
|
|- ...
|
2013-05-06 08:30:49 +02:00
|
|
|
\- buildcraft.localization
|
2013-04-03 20:22:52 +02:00
|
|
|
|- lang
|
|
|
|
|
|
|
|
|
|
***
|
|
|
|
|
|
2012-09-11 14:10:38 +02:00
|
|
|
### Localizations
|
|
|
|
|
|
2013-01-23 15:07:03 +01:00
|
|
|
Localizations can be submitted [here](https://github.com/BuildCraft/BuildCraft-Localization). Localization PRs against
|
|
|
|
|
this repository will have to be rejected.
|
