⭐ Simple NPC Framework ⭐ - Lightweight Easy to Use [1.15 - 1.16]

Simple NPC Framework [1.15 - 1.16] [Lightweight NPC Framework]

Introduction
Tired of coding NPC's? Annoyed to find that there are little to no outdated tutorials that you find over the internet on how you code these fake players? Need something lightweight? Well then Simple NPC Framework is the framework you should use. Although the Citizens API is very useful, I find it very heavy and bulky in terms of size, so we have decided to create a more lightweight framework for developers to use.

Simple NPC Framework is a fork of the original known lightweight framework NPCLib a very useful API. After the developer decided to discontinue development for the API, we have decided to take over and continue to add support for the newer Minecraft versions that will be coming out. We will not support older versions, as NPCLib can be used for those versions and we want to respect the authors.

Developer API
If you want to use this API, we recommend you to clone the repository and run mvn install to install the repository to your local dependencies.

To start off, define an instance of this library using the constructor which accepts an instance of Plugin as its parameters like so:

Do not create multiple instances of SimpleNPCFramework in many classes! Instead, use dependency injection or create a getter method in your main plugin class to reference the same instance of the library.

In order to create your first NPC, we will use the method, which can accept either a List<String>of lines which would be a hologram on top of the NPC, or nothing if you want a plain NPC. As an example:
The other methods that can be used to customize your NPC can be found here with descriptions of what each method performs, however some of the most commonly used include:

Sets the location of an NPC
Creates the NPC
Destroys the NPC and removes it from the internal registry
Sets NPC visible to specific Player
Sets NPC not visible to Specific Player
Returns the assigned ID for the NPC
As for a code example:
In order to add skins for your NPC, we have added a Skin class which you can use for. Skin takes in two parameters in the constructor, a String value and a String signature for the skin. More information about what these two values represent can be found here.

For your convenience, we have added a class called AsyncSkinFetcher.
OR
It has a Mineskin feature where it can accept an integer for its arguments like ( https://mineskin.org/725954 has ID 725954), or you can just pass in a UUID and it will retrieve the skin using the identifier. It should be noted that the method fetchSkinFromUsernameAsync is deprecated for a reason, as the player name can change many times. Thus, the UUID is the ideal option you should use.

In addition to the skins and methods of NPC's, there are also events your plugin can listen to as well. These events include a NPCShowEvent, NPCHideEvent, and NPCInteractEvent.

As for examples, you can take a look at this class I written here which stores the person who created NPC's and sends them as a message to the player if they have interacted.

Conclusion
And that's pretty much it. We will be adding more features as we go on, but check out our organization's website located at https://ponclure.github.io, which contains all of our projects and source code made by collaborative developers. I hope this API is useful!