Essentials/README.md

72 lines
2.7 KiB
Markdown
Raw Normal View History

![](https://i.imgur.com/CP4SZpB.png)
2011-06-07 23:01:28 +02:00
[![Downloads](https://i.imgur.com/MMc0PJY.png)](http://ci.ender.zone/job/EssentialsX/)
2015-06-16 23:01:21 +02:00
2018-02-06 05:00:36 +01:00
[![Discord](https://imgur.com/MFRRBn4.png)](https://discord.gg/casfFyh)
2017-10-22 19:11:43 +02:00
2015-04-20 21:51:56 +02:00
This is a fork of Essentials called EssentialsX.
2011-06-07 23:01:28 +02:00
2015-04-20 21:51:56 +02:00
If you are using this, do **NOT** ask Essentials for support.
2011-06-07 23:01:28 +02:00
2015-04-20 21:51:56 +02:00
The official upstream repository is at https://github.com/Essentials/Essentials
2011-06-07 23:01:28 +02:00
2015-06-02 20:09:24 +02:00
Why you should use it
--------
2017-12-14 20:55:28 +01:00
EssentialsX provides several performance enhancements and fixes that are currently not available in Essentials and Spigot-Essentials, most notably mob spawner support for 1.8+ servers and buy/trade sign support for 1.9+ servers. [See the wiki for details.](https://github.com/EssentialsX/Essentials/wiki)
2015-06-02 20:09:24 +02:00
2015-06-03 18:06:29 +02:00
EssentialsX is almost a completely drop-in replacement for Essentials. However, it has different requirements:
* **EssentialsX requires [Vault](http://dev.bukkit.org/bukkit-plugins/vault/) to enable chat prefix/suffixes and group support if you have a supported permissions plugin.**
2015-07-02 06:53:52 +02:00
* **If you have an unsupported permissions plugin but still wish to use wildcards, enable `use-bukkit-permissions` in the configuration. Otherwise, the plugin will fall back to config-based permissions.**
2015-07-02 06:53:10 +02:00
* **EssentialsX requires Java 7 or higher.**
2015-06-02 20:21:46 +02:00
* **1.7.10 is no longer supported.**
2017-12-14 21:30:13 +01:00
* **1.13 will be supported!**
2013-10-18 13:49:03 +02:00
Building
--------
2015-08-12 03:51:58 +02:00
Because EssentialsX builds against the Spigot/CraftBukkit server software for legacy support, you need to run Spigot's BuildTools for several versions in order to get it to compile.
```
java -jar BuildTools.jar --rev 1.8
java -jar BuildTools.jar --rev 1.8.3
2016-03-11 00:20:17 +01:00
java -jar BuildTools.jar --rev 1.9
2016-05-21 22:46:49 +02:00
java -jar BuildTools.jar --rev 1.9.4
2015-08-12 03:51:58 +02:00
```
Then, to build with Maven, use the command
2013-10-18 13:49:03 +02:00
```
2015-08-12 03:51:58 +02:00
mvn clean install
2013-10-18 13:49:03 +02:00
```
2015-08-12 03:51:58 +02:00
Jar files can then be found in the /target folder for each module.
2013-10-18 13:49:03 +02:00
2013-02-20 02:39:04 +01:00
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.
2013-02-20 02:39:04 +01:00
- `[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.
2013-02-20 02:39:04 +01:00
- 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.
2013-02-20 02:39:04 +01:00
2011-06-07 23:01:28 +02:00
2015-04-21 01:26:03 +02:00
Other Info
2015-04-20 21:51:56 +02:00
-----------------
2011-07-03 00:12:43 +02:00
2015-04-21 01:26:03 +02:00
This is an unofficial fork of Essentials. It will be consistently updated and maintained with the latest Minecraft and Spigot versions.
2013-10-07 02:34:42 +02:00
2015-04-20 21:51:56 +02:00
Support
2013-10-07 02:34:42 +02:00
-----------------
2017-12-14 20:55:28 +01:00
[Issue Tracker](https://github.com/EssentialsX/Essentials/issues)
2013-10-07 02:34:42 +02:00
2017-12-14 21:26:16 +01:00
[Live Support](https://discord.gg/F7gexAQ)