This is the official GitHub page for Biota!
###Compiling Biota
####Setup Java The Java JDK is used to compile Biota.
- Download and install the Java JDK.
- Windows/Mac download link. Scroll down, accept the
Oracle Binary Code License Agreement for Java SE
, and download it (if you have a 64-bit OS, please download the 64-bit version). - Linux: Installation methods for certain popular flavors of Linux are listed below. If your distribution is not listed, follow the instructions specific to your package manager or install it manually here.
- Gentoo:
emerge dev-java/oracle-jdk-bin
- Archlinux:
pacman -S jdk7-openjdk
- Ubuntu/Debian:
apt-get install openjdk-7-jdk
- Fedora:
yum install java-1.7.0-openjdk
- Gentoo:
- Windows/Mac download link. Scroll down, accept the
- Windows: Set environment variables for the JDK.
- Go to
Control Panel\System and Security\System
, and click onAdvanced System Settings
on the left-hand side. - Click on
Environment Variables
. - Under
System Variables
, clickNew
. - For
Variable Name
, inputJAVA_HOME
. - For
Variable Value
, input something similar toC:\Program Files\Java\jdk1.7.0_51
(or wherever your Java JDK installation is), and clickOk
. - Scroll down to a variable named
Path
, and double-click on it. - Append
;%JAVA_HOME%\bin
EXACTLY AS SHOWN and clickOk
. Make sure the location is correct; double-check just to make sure.
- Go to
- Open up your command line and run
javac
. If it spews out a bunch of possible options and the usage, then you're good to go. If not, try the steps again and make sure yourPath
variable is correct.
####Setup Git Git is used to clone Biota and update your local copy.
- Download and install Git here.
- Optional: Download and install a Git GUI client, such as Github for Windows/Mac, SmartGitHg, TortoiseGit, etc. A nice list is available here.
####Setup Biota This allows ForgeGradle to know what it's compiling.
- Open up your command line.
- Navigate to a place where you want to download Biota's source (eg
C:\Github\Biota\
) by executingmkdir [folder location]
and thencd [folder location]
. This location is known asmcdev
from now on. - Execute
git clone https://github.com/Dynious/Biota.git
. This will download Biota's source intomcdev
. - Your directory structure should now look like:
mcdev
\-gradle
\-src
\-main
\-java
\-resources
|-Other misc Biota files (should include `build.gradle`)
5.
Open a command line in your ForgeGradle folder and execute gradlew build
if using Windows.
* Note: If you have Gradle installed, use gradle
instead.
6.
Gradle will now install ForgeGradle, download all needed files and build Biota. This can take a while the first time.
7.
Find your fresh copy of Biota in mcdev/build/libs
!
###Contributing ####Submitting a Pull Request
- If you haven't already, create a Github account.
- Click the
Fork
icon at the top-right of this page (below your username). - Make the changes that you want to.
- Click
Pull Request
at the right-hand side of the gray bar directly below your fork's name. - Click
Click to create a pull request for this comparison
, enter your PR's title, and make a description of what's changed. - Click
Send pull request
, and you're done!
####Creating an issue
- Go to the issues page.
- Click
New Issue
right belowStar
andFork
. - Enter your Issue's title (something that summarizes your issue), and then create a detailed description.
- Click
Submit new issue
, and you're done!