Skip to content

Preparing for the contest

Kyle Clemens edited this page May 25, 2014 · 5 revisions

So you've just signed up on the ten.java site as a participant, and we've created a repository for you. What now? This guide hopes to consolidate a couple of things you should probably try to do before the contest starts.

Check your repository

Once you've signed up, you should be presented with a "thanks" page. This page will include a link to your very own repository. Go ahead and click the link to make sure the repository exists. If you've since closed the tab, try searching here. If everything worked without a hitch, you should now have your very own repository! ✨

Right now, your repository won't have a lot of content in it. Once we've finalized our repository template, we'll push a Maven skeleton to every repository. Simultaneously, we'll be revoking access to the repositories until the start of the contest.

Feel free to have a play around with your repository while you have access; you'll need git installed to do so (see below for more info on that). You can try committing a file, cloning it locally, etc., with the knowledge that all of it will be reset later on. On that note, please don't get too attached to anything in your repository - it'll be gone forever soon. 💥

Getting started with Git

If you don't already have Git installed, you'll want to follow one of the guides so you can start using it:

Once you have Git installed, you'll want to get a basic understanding of how things work. You can go through an interactive, command-line based tutorial or look into using a graphical program to help you use Git. Some IDEs have Git support integrated (IntelliJ IDEA, NetBeans, Eclipse, etc.), and you can also install one of the tools below:

Linux users may be interested in this AskUbuntu answer.

Maven and dependency management

For some participants, using something like Maven will be unfamiliar. I personally used the export functionality built into Eclipse for quite some time before I looked into Maven. For the contest, we've already set everything up, and by the time July 12 comes around, you'll have a skeleton in your repository which includes everything you need to build a simple plugin using Maven.

To take advantage of Maven, you'll need to install it. We have a few guides set up already:

Some IDEs ship with Maven integration, but it's very easy to get started. To compile your project, simply run the mvn command in the root directory of your repository. If everything went right, you'll see some downloading and a 'BUILD SUCCESSFUL' message. This will make you a JAR in a new folder called target, which you can then copy to your CraftBukkit directory for testing. After changing code, simply run the command again to get a new JAR file.

IDEs

Most users will probably have a favorite IDE they wish to use. For those who don't or who wish to consider alternatives, popular choices include:

If you have any questions (about the contest, git, Maven etc), please don't hesitate to send us a tweet @tenjava or ask in our IRC channel.

Clone this wiki locally