2011-01-03 19:32:42 +01:00
|
|
|
CraftBukkit
|
|
|
|
|
===========
|
|
|
|
|
|
|
|
|
|
A Bukkit (Minecraft Server API) implementation
|
|
|
|
|
|
2011-03-25 23:26:44 +01:00
|
|
|
Website: [http://bukkit.org](http://bukkit.org)
|
|
|
|
|
Bugs/Suggestions: [http://leaky.bukkit.org](http://leaky.bukkit.org)
|
|
|
|
|
|
2011-01-03 19:32:42 +01:00
|
|
|
Compilation
|
|
|
|
|
-----------
|
|
|
|
|
|
|
|
|
|
We use maven to handle our dependencies.
|
|
|
|
|
|
|
|
|
|
* Install [Maven 3](http://maven.apache.org/download.html)
|
|
|
|
|
* Check out and install [Bukkit](http://github.com/Bukkit/Bukkit)
|
2011-01-15 01:24:18 +01:00
|
|
|
* *Note*: this is not needed as the repository we use has Bukkit too, but you might have a newer one (with your own changes :D)
|
2011-01-03 19:32:42 +01:00
|
|
|
* Check out this repo and: `mvn clean package`
|
2011-02-05 15:58:03 +01:00
|
|
|
|
2011-02-18 23:15:19 +01:00
|
|
|
Coding and Pull Request Conventions
|
2011-02-05 15:58:03 +01:00
|
|
|
-----------
|
|
|
|
|
|
|
|
|
|
* We generally follow the Sun/Oracle coding standards.
|
|
|
|
|
* No tabs; use 4 spaces instead.
|
|
|
|
|
* No trailing whitespaces.
|
2011-04-25 12:51:53 +02:00
|
|
|
* No CRLF lineendigs, LF only, put your gits 'core.autocrlf' on 'true'
|
2011-02-05 15:58:03 +01:00
|
|
|
* No 80 column limit or 'weird' midstatement newlines.
|
2011-02-18 23:15:19 +01:00
|
|
|
* The number of commits in a pull request should be kept to a minimum (squish them into one most of the time - use common sense!).
|
|
|
|
|
* No merges should be included in pull requests unless the pull request's purpose is a merge.
|
|
|
|
|
* Pull requests should be tested (does it compile? AND does it work?) before submission.
|
2011-02-05 15:58:03 +01:00
|
|
|
|
|
|
|
|
If you make changes or add net.minecraft.server classes it is mandatory to:
|
|
|
|
|
|
|
|
|
|
* Get the files from the [mc-dev repo](https://github.com/Bukkit/mc-dev) - make sure you have the last version!
|
|
|
|
|
* Mark your changes with:
|
|
|
|
|
* 1 line; add a trailing: `// CraftBukkit [- Optional reason]`
|
|
|
|
|
* 2+ lines; add
|
|
|
|
|
* Before: `// CraftBukkit start [- Optional comment]`
|
|
|
|
|
* After: `// CraftBukkit end`
|
|
|
|
|
* Keep the diffs to a minimum (*really* important)
|
|
|
|
|
|
|
|
|
|
Follow the above conventions if you want your pull requests accepted.
|
