NoCheatPlus/README.md

76 lines
6.2 KiB
Markdown
Raw Normal View History

2014-11-29 23:09:50 +01:00
NoCheatPlus
2014-11-29 22:59:41 +01:00
---------
NoCheatPlus is a fork of the famous anti-cheat plugin [NoCheat] (http://dev.bukkit.org/server-mods/nocheat/) created by [Evenprime] (https://github.com/Evenprime). NoCheatPlus attempts to enforce "vanilla Minecraft" mechanics, as well as preventing players from abusing weaknesses in Minecraft or its protocol, making your server more safe. Organized in different sections, various checks are performed to test players doing, covering a wide range including flying and speeding, fighting hacks, fast block breaking and nukers, inventory hacks, chat spam and other types of malicious behaviour. For a more complete list have a look at the always outdated [Features Page] (https://github.com/NoCheatPlus/Docs/wiki/Features).
2013-01-11 21:58:04 +01:00
Installation
---------
* Get [CraftBukkit] (http://wiki.bukkit.org/Setting_up_a_server) or [Spigot] (https://www.spigotmc.org/threads/buildtools-updates-information.42865/)
2014-10-29 11:58:35 +01:00
* Download NoCheatPlus from either [BukkitDev (staff approved)] (http://dev.bukkit.org/server-mods/nocheatplus/files/) or [Jenkins (development versions)] (http://ci.md-5.net/job/NoCheatPlus/).
2013-01-12 01:53:51 +01:00
* Drop the NoCheatPlus.jar in to your plugins folder.
2016-03-14 10:51:20 +01:00
* Start your Spigot/CraftBukkit server. (Using /reload can have unwanted side effects with players still online, but also with complex plugins and cross-plugin dependencies, so we don't recommend it. Usually it should work with NCP.)
2013-01-11 21:58:04 +01:00
Tips
---------
2016-03-14 10:51:20 +01:00
* Be sure that your Spigot/CraftBukkit and NoCheatPlus versions match together.
2013-01-12 01:53:51 +01:00
* Don't use tabs in the config.yml file.
2016-03-14 10:51:20 +01:00
* Use [ProtocolLib] (http://dev.bukkit.org/bukkit-plugins/protocollib) for full efficiency of the fight checks and other. Using version of ProtocolLib that is supported by NCP is essential, as otherwise some checks will be disabled.
2013-01-12 01:53:51 +01:00
* For compatibility with other plugins such as mcMMO, citizens and more check out [CompatNoCheatPlus] (http://dev.bukkit.org/server-mods/compatnocheatplus-cncp/).
2013-01-11 21:58:04 +01:00
Compiling NoCheatPlus
2013-01-12 01:37:40 +01:00
---------
2016-03-14 10:51:20 +01:00
* NoCheatPlus is compiled for Java 6 (same as Minecraft/Spigot).
2013-01-12 01:53:51 +01:00
* We use [Maven] (http://maven.apache.org/download.cgi) 3 to handle the dependencies.
* You can compile with this Maven goal: `mvn clean package`, if you don't want any dedicated CraftBukkit modules, or if you are lacking the jar files - **for best performance and compatibility, choose the appropriate build profile(s) from below**. If you do have all the legacy dependencies, you can set the parameter `cbdedicated` to `true` and activate the profile `all` adding `-P all` to the maven goals. For more options, see the table below. If your specific needs are not met by the provided options, you can still build only using the compat module(s) that you need, e.g. by adjusting the build/dependency profiles or adding your own profile, which means changing/adding a profile both in the root pom.xml for modules to have and in NCPPlugin/pom.xml for the dependency inclusion. The preset profiles should be enough of a hint for that. If you add custom modules with a different package naming than `fr.neatmonster`, you might have to add the source inclusion to the NoCheatPlus/pom.xml as well.
2016-03-14 10:51:20 +01:00
* Jar files for the dedicated compat modules, which your local maven repository might be missing, can be installed manually.
2014-06-14 18:44:53 +02:00
Example for Eclipse with embedded maven:
Add a new maven build run configuration, name it appropriately, e.g. ```Install CB 1.7.5```.
Set goals to: ```install:install-file -Dfile=<PATH TO JAR> -DgroupId=org.bukkit -DartifactId=craftbukkit -Dversion=1.7.5-R0.1-SNAPSHOT -Dpackaging=jar```
On Windows the <PATH TO JAR> might look like: ```X:\...\craftbukkit\3042\craftbukkit-1.7.5-R0.1-20140408.020329-16.jar```
To let it run you might have to set the base directory, e.g. to ```${workspace_loc}```, it does not seem to have significance.
2016-03-14 10:35:35 +01:00
Do set the correct version alongside the file name. On newer version of maven, you might do with much simplified goals, because the pom files inside the jars are parsed.
2013-01-12 01:37:40 +01:00
2016-03-13 23:41:31 +01:00
All profiles for reference:
2016-03-13 23:43:24 +01:00
**As of now, you do need to activate the ncp_base profile in addition to whichever other profile you may be using.**
_For some building environments you might need to both set the profiles and set the build parameters - to be on the safe side, just set both._
2016-03-13 23:41:31 +01:00
| Profile | Parameter set to `true` | Description |
2016-03-13 23:44:21 +01:00
| :------------------ | :----------------------------- | :-------------- |
| `-P ncp_base` | `ncp_base` | Default profile without any of the native access modules, might pose compatibility issues with latest Minecraft versions. |
| `-P all-P ncp_base` | `cbdedicated` and `ncp_base` | All compatibility modules. |
2016-06-14 23:36:51 +02:00
| `-P spigot1_7_r4 -P ncp_base` | `spigot1_7_r4` and `ncp_base` | Just Spigot 1.7 R4 (MC 1.7.10). |
| `-P spigot1_8_r3 -P ncp_base` | `spigot1_8_r3` and `ncp_base` | Just Spigot 1.8 R3 (MC 1.8.4-1.8.8). |
| `-P spigot1_9_r1 -P ncp_base` | `spigot1_9_r1` and `ncp_base` | Just Spigot 1.9 R1 (MC 1.9-1.9.3). |
| `-P spigot1_9_r2 -P ncp_base` | `spigot1_9_r2` and `ncp_base` | Just Spigot 1.9 R2 (MC 1.9.4). |
| `-P spigot1_10_r1 -P ncp_base` | `spigot1_10_r1` and `ncp_base` | Just Spigot 1.10 R1 (MC 1.10). |
| `-P cbdev -P ncp_base` | `cbdev` and `ncp_base` | The latest version in development. |
(On the long run, only the latest module for a major Minecraft release may be be kept, such as 1_8_r3 for all of 1.8.x.)
2016-03-13 23:41:31 +01:00
2013-01-11 21:58:04 +01:00
Links
---------
2013-01-12 01:37:40 +01:00
Project
* [NoCheatPlus at BukkitDev] (http://dev.bukkit.org/server-mods/nocheatplus/)
2013-01-12 01:37:40 +01:00
Download
* [BukkitDev (staff approved)] (http://dev.bukkit.org/server-mods/nocheatplus/files/)
2014-10-29 11:58:35 +01:00
* [Jenkins (development versions)] (http://ci.md-5.net/job/NoCheatPlus/)
2013-01-12 01:37:40 +01:00
Support and Documentation
* [Issues/Tickets] (https://github.com/NoCheatPlus/Issues/issues)
* [Wiki] (https://github.com/NoCheatPlus/Docs/wiki)
* [Configuration] (https://github.com/NoCheatPlus/Docs/wiki/Configuration)
* [Permissions] (https://github.com/NoCheatPlus/Docs/wiki/Permissions)
* [Commands] (https://github.com/NoCheatPlus/Docs/wiki/Commands)
2013-01-12 01:53:51 +01:00
2013-01-12 01:37:40 +01:00
Developers
* [License (GPLv3)] (https://github.com/NoCheatPlus/NoCheatPlus/blob/master/LICENSE.txt)
* [API] (https://github.com/NoCheatPlus/Docs/wiki/API)
2015-10-23 19:52:56 +02:00
* [Contribute] (https://github.com/NoCheatPlus/NoCheatPlus/blob/master/CONTRIBUTING.md)
2013-02-03 23:21:22 +01:00
Related
2016-02-10 10:29:49 +01:00
* [ProtocolLib at BukkitDev] (http://dev.bukkit.org/bukkit-plugins/protocollib)
2013-02-03 23:22:46 +01:00
* [CompatNoCheatPlus at BukkitDev] (http://dev.bukkit.org/server-mods/compatnocheatplus-cncp/)