This is an API made specifically for spigot servers (Minecraft). Current supported versions: 1.8 - 1.14.4*. Lightweight replacement for Citizens. NPCLib only uses packets instead of registering the entity in the actual Minecraft server.
*You can find a version of NPCLib with basic support for 1.7.10 on the legacy branch. This branch is not actively maintained as the master branch. This version does not support multi-line text.
Preview (click to play video)
Alternatively, you can help the project by starring the repository or telling others about NPCLib.
There are multiple ways you can make use of NPCLib.
- The first option is to shade
npclib-plugin.jarin to your plugin.
- The second option is to put
pluginsfolder. By doing this, you no longer need to shade the API JAR. Though, do not forget to add
NPCLibas a dependency in your
- The third option (and the one I recommend most) is to shade the library using Maven. I recently added NPCLib to the OSSRH (OSS Repository Hosting) which allows you to easily import NPCLib into your project.
<repositories> <repository> <id>ossrh</id> <url>https://oss.sonatype.org/content/groups/public/</url> </repository> </repositories>
If you have NPCLib under your
plugins folder, you may use the following:
<dependencies> <dependency> <groupId>net.jitse</groupId> <artifactId>npclib-api</artifactId> <version>2.3-SNAPSHOT</version> <scope>compile</scope> </dependency> </dependencies>
If you do not want to have NPCLib in your
plugins folder, you need to use the
npclib-plugin artifact and shade it accordingly.
Click here to download the latest release.
Click here for an elaborate explanation on how to use NPCLib in your next project.
Building your own version
- Download or clone this repository.
- You can build the project using
mvn clean install.
The API JAR will be under
/api/target/ and the plugin JAR (which includes all necessary NMS code) will be under
License and plugins using NPCLib
NPCLib is licensed under the MIT license. Developers are free to use NPCLib for both private and commercial use. However, it would be nice to acknowledge me.
You (the developer) can also contact me if you wish to be added to the list below.
Plugin(s) using NPCLib:
- PremiumHub (by Vouchs).
We thank all those who have contributed to the creation of what NPCLib is today.
Please view the credits here.
Copyright (c) Jitse Boonstra 2018 All rights reserved.