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

A lightweight NPC framework alternative to Citizens

  1. PulseBeat_02
    Native Minecraft Version:
    Tested Minecraft Versions:
    • 1.15
    • 1.16
    Source Code:
    Fefo6644, PulseBeat_02, Conclure
    Simple NPC Framework [1.15 - 1.16] [Lightweight NPC Framework]

    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:

    Code (Text):
    SimpleNPCFramework framework = new SimpleNPCFramework(plugin);
    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
    Code (Text):
    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:
    Code (Text):
    // NPC with no Hologram
    NPC normalNPC = framework.createNPC();

    // NPC with a Hologram
    NPC hologramNPC = framework.createNPC(Arrays.asList("Line 1", "Line 2");
    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
    Code (Text):
    NPC#setLocation(Location location)
    Creates the NPC
    Code (Text):
    Destroys the NPC and removes it from the internal registry
    Code (Text):
    Sets NPC visible to specific Player
    Code (Text):
    NPC#show(Player player)
    Sets NPC not visible to Specific Player
    Code (Text):
    NPC#hide(Player player)
    Returns the assigned ID for the NPC
    Code (Text):
    As for a code example:
    Code (Text):
    NPC npc = framework.createNPC(Arrays.asList("Hello!")); // Initialize NPC
    npc.setLocation(new Location(0, 0, 0)); // Set Location to (0, 0, 0)
    npc.show(Bukkit.getPlayer("PulseBeat_02")); // Set Visible to Player
    npc.create(); // Create the NPC
    System.out.println(npc.getId()); // Print out the ID asociated with the NPC
    In order to add skins for your NPC, we have added a Skin class which you can use
    Code (Text):
    NPC#setSkin(Skin skin)
    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.
    Code (Text):
    AsyncSkinFetcher.fetchSkinFromIdAsync(int id, skin -> {
        // Create your NPC.
    Code (Text):
    AsyncSkinFetcher.fetchSkinFromUUIDAsync(UUID uuid, skin -> {
        // Create your NPC.
    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.

    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!
    lokka30 likes this.