Essentials Development Readme
The official repository is at: https://github.com/essentials/Essentials
We use NetBeans 7.3 for development.
Recommended NetBeans plugins:
- Git
- PMD & FindBugs ( http://kenai.com/projects/sqe/pages/Home )
Building
To build with Maven, use the command
mvn package dependency:copy
Jar files can then be found in the /jars folder
Commit Guidelines
Commits should fall into one of 3 areas:
-
[Feature]: Commits which are features should start with[Feature]and followed by a quick summary on the top line, followed by some extra details in the commit body. -
[Fix]: Commits which fix bugs, or minor improvements to existing features should start with[Fix]and followed by a quick summary on the top line, followed by some extra details in the commit body. -
Commits which fix bugs caused by previous commits (since last release), or otherwise make no functionality changes, should have no prefix. These will not be added to the project change log.
Coding Guidelines
Please follow the format guidelines that are saved in the project properties.
Windows users, please read this: http://help.github.com/line-endings/ The default line ending is LF.
To build all jars, select the EssentialsParent project and build that. You'll find all jars inside the jars folder.
Please only submit pull requests for the 2.x branch.
Bugs and issues can be submitted/found at https://essentials3.atlassian.net/
Other advice
Not all features are 'Essentials Ready'. Essentials is designed to cover the basic needs of Minecraft server administration, thus, we reject over 80% of feature requests that we deem are unsuitable.
Before developing an Essentials feature, we would recommend speaking to a developer in the Essentials IRC channel (#essentials on irc.esper.net). Click here if you have a IRC client.