The setup as described here is MUCH easier than what is described for eclipse/IDEA.
No more command line stuff, or even installing git on your pc!
Overview of steps:
1. Install netbeans
I tested this with netbeans 7.3.1, but any version supported by the gradle plugin and git plugin should work.
Make sure you have java 1.6 or 1.7 SDK, not JRE!
1.7 is preferred as the project is shifting towards 1.7.
link for combined package:
http://www.oracle.com/technetwork/java/javase/downloads/jdk-7-netbeans-download-432126.html
2. Install the gradle plugin
Open netbeans and go to:
Tools->Plugins
Then go to the Available plugins tab and search for gradle
Install the gradle plugin and its dependencies (groovy).
3. Clone git repository
WARNING: cloning just takes a long time! Have patience!
Make sure you have no open project selected (build and run buttons are greyed out), then:
Go to team->git->clone
Enter the terasology git reposity location: "https://github.com/MovingBlocks/Terasology.git"
Leave the user details blank, or fill in your github account if you really want to.
Select the branches you want to work on.
The next few windows all give you some obvious choices, such as location on disc, the branch to start working on, etc.
Once done you can open the gradle project with netbeans (or it is opened automatically if you selected to scan for projects after clone).
From here you can already run the project with the big green run button! Neat!
(First time running is a bit slow because of gradle setup.)
4. Push to your own repo/branch
This step will allow you to put your work on github. This is needed for pull-requests (request the devs of Terasology to accept your additions and changes) and to work on the project on multiple computers.
Roughly follow these steps:
- Create a github account.
- Fork the terasology repo (https://github.com/MovingBlocks/Terasology -> big fork button on the top-right, if you are logged in)
- Open netbeans, open the cloned project and select it
- Go to team->remote->push...
- Select "Specify Git repositiry location" and the location to your repository. It will look like: https://github.com/XXX/Terasology.git where XXX is replaced by you name on github.
- Enter your github name and password
- Select the branches of which you want the changes to be uploaded (usually only the branch you are working on). If your local branch has a new name, you will create a new online branch.
No more command line stuff, or even installing git on your pc!
Overview of steps:
- Install netbeans
- Install the gradle plugin for netbeans
- Clone the git repository with netbeans
- Push to your own repo/branch
1. Install netbeans
I tested this with netbeans 7.3.1, but any version supported by the gradle plugin and git plugin should work.
Make sure you have java 1.6 or 1.7 SDK, not JRE!
1.7 is preferred as the project is shifting towards 1.7.
link for combined package:
http://www.oracle.com/technetwork/java/javase/downloads/jdk-7-netbeans-download-432126.html
2. Install the gradle plugin
Open netbeans and go to:
Tools->Plugins
Then go to the Available plugins tab and search for gradle
Install the gradle plugin and its dependencies (groovy).
3. Clone git repository
WARNING: cloning just takes a long time! Have patience!
Make sure you have no open project selected (build and run buttons are greyed out), then:
Go to team->git->clone
Enter the terasology git reposity location: "https://github.com/MovingBlocks/Terasology.git"
Leave the user details blank, or fill in your github account if you really want to.
Select the branches you want to work on.
The next few windows all give you some obvious choices, such as location on disc, the branch to start working on, etc.
Once done you can open the gradle project with netbeans (or it is opened automatically if you selected to scan for projects after clone).
From here you can already run the project with the big green run button! Neat!
(First time running is a bit slow because of gradle setup.)
4. Push to your own repo/branch
This step will allow you to put your work on github. This is needed for pull-requests (request the devs of Terasology to accept your additions and changes) and to work on the project on multiple computers.
Roughly follow these steps:
- Create a github account.
- Fork the terasology repo (https://github.com/MovingBlocks/Terasology -> big fork button on the top-right, if you are logged in)
- Open netbeans, open the cloned project and select it
- Go to team->remote->push...
- Select "Specify Git repositiry location" and the location to your repository. It will look like: https://github.com/XXX/Terasology.git where XXX is replaced by you name on github.
- Enter your github name and password
- Select the branches of which you want the changes to be uploaded (usually only the branch you are working on). If your local branch has a new name, you will create a new online branch.
