NPCDestinations - Create Living NPC's 2.6.10

Tested Minecraft Versions:

• 1.8
• 1.9
• 1.10
• 1.11
• 1.12
• 1.13
• 1.14
• 1.15
• 1.16
• 1.17
• 1.18

{ Documentation | GitHub | Discord Channel | YouTube | Donate }
​

About the plugin:
This one provides mechanics to give your NPC's some creature comforts. Rather than having them sit out in the cold dark night's you can now let them go home and sit next to a nice pixelated fireplace. Think how excited they will be now!

• Automated pathfinding system that adapts to your environment
• All configuration is stored on the NPC itself, no need to edit any config files
• Ability to provide multiple locations for an NPC to walk to, based on time, commands, or environmental factors
• Auto Citizens saves.yml backup system with storage settings.
• Ability to just walk on anything, or define their allowed path surfaces
• Build custom paths based on blocks under the surface (# down, or level 0)
• Random movement based on locations
• Set a different NPC skin per location
• Change your NPCs equipment per location
• Random walking configurations per location defined
• Use commands to set an NPC's current location (With duration's)
• Detailed permission's to control each command's access
• Ability to allow a user access to edit any or only owned NPC's
• Built-in debugging and visual path system Quickly debug any path issues with this system
• Extensive Jason chat management system. Save time by clicking chat items!
• Customizable language files and language flags
• Custom worldguard flag for chunk management (ndest-forcechunk)
  • preload chunks upon server startup and keep them active
  • Prevent chunks from unloading based on regions
• API for interacting with the plugin itself

Required Plugins:

1. Citizens2 (NPC base mechanics)

Optional Supported Plugins:

• Quests (Ability to interact with Quests)
• JobsReborn (NPC locations can be toggled based on users in jobs)
• LightAPI (Equip an NPC with a torch (Normal or redstone) and it will light the area around the NPC at night.
• PlotSquared (Allow users to give their NPC's a little extra life in their plots)
• BetonQuest (Provides conditions, and events for controlling NPCs from BetonQuest)
  [Example BetonQuest Package]

Addon Plugins:

• Destinations Farmer Add-on - Harvest crops and re-plant them.
• Destinations Animations Add-on - Enable animations at different locations.
• Destinations Rancher Add-on - Allow your NPC to ranch and manage animals.

Quick Tutorial:

• Download the latest version of the plugin and place it into your plugins folder.
• Start the server
• Create an NPC
• type /nd autoset
• Go to the location you want your NPC to stand at
• type /npcdest addlocation {time of day / sunset / or sunrise}
• Go to the second location you want the NPC to visit
• type /npcdest addlocation {time of day / sunset / or sunrise}
• Change the time of day, they should change locations.

Permissions:

Spoiler: Permissions

npcdestinations.info:

• Show NPC information, debugging, and status's
• Included Permissions:
  • npcdestinations.debug.set
  • npcdestinations.debug.own
  • npcdestinations.debug.all
  • npcdestinations.enginestatus
  • npcdestinations.allstatus
  • npcdestinations.info
  • npcdestinations.backup

npcdestinations.settings:

• Ability to change NPC configuration
• Included Permissions:
  • npcdestinations.editall.info
  • npcdestinations.editall.autoset
  • npcdestinations.editall.goloc
  • npcdestinations.editall.blockstick
  • npcdestinations.editall.addlocation
  • npcdestinations.editall.removelocation
  • npcdestinations.editall.addblock
  • npcdestinations.editall.removeblock
  • npcdestinations.editall.removeallblocks
  • npcdestinations.editall.pauseplayer
  • npcdestinations.editall.oneblockdown
  • npcdestinations.editall.opengates
  • npcdestinations.editall.openwooddoors
  • npcdestinations.editall.openmetaldoors
  • npcdestinations.editall.locmax
  • npcdestinations.editall.locprob
  • npcdestinations.editall.locwand
  • npcdestinations.editall.loctime
  • npcdestinations.editall.locloc
  • npcdestinations.editall.localias
  • npcdestinations.editall.locskin
  • npcdestinations.editall.locjobs
  • npcdestinations.editall.locsentinel
  • npcdestinations.editall.locweather

npcdestinations.debug.*:

• Give access to all debug levels
• Included Permissions:
  • npcdestinations.debug.set
  • npcdestinations.debug.npc
  • npcdestinations.debug.all

npcdestinations.editall.*:

• Ability to change any NPC configuration
• Included Permissions:
  • npcdestinations.editall.info
  • npcdestinations.editall.autoset
  • npcdestinations.editall.goloc
  • npcdestinations.editall.blockstick
  • npcdestinations.editall.addlocation
  • npcdestinations.editall.removelocation
  • npcdestinations.editall.addblock
  • npcdestinations.editall.removeblock
  • npcdestinations.editall.removeallblocks
  • npcdestinations.editall.pauseplayer
  • npcdestinations.editall.oneblockdown
  • npcdestinations.editall.opengates
  • npcdestinations.editall.openwooddoors
  • npcdestinations.editall.openmetaldoors
  • npcdestinations.editall.locmax
  • npcdestinations.editall.locprob
  • npcdestinations.editall.locwand
  • npcdestinations.editall.loctime
  • npcdestinations.editall.locloc
  • npcdestinations.editall.localias
  • npcdestinations.editall.locskin
  • npcdestinations.editall.locjobs
  • npcdestinations.editall.locsentinel
  • npcdestinations.editall.locweather

npcdestinations.editown.*:

• Ability to change only owned NPC configurations
• Included Permissions:
  • npcdestinations.editown.info
  • npcdestinations.editown.autoset
  • npcdestinations.editown.goloc
  • npcdestinations.editown.blockstick
  • npcdestinations.editown.addlocation
  • npcdestinations.editown.removelocation
  • npcdestinations.editown.addblock
  • npcdestinations.editown.removeblock
  • npcdestinations.editown.removeallblocks
  • npcdestinations.editown.pauseplayer
  • npcdestinations.editown.oneblockdown
  • npcdestinations.editown.opengates
  • npcdestinations.editown.openwooddoors
  • npcdestinations.editown.openmetaldoors
  • npcdestinations.editown.locmax
  • npcdestinations.editown.locprob
  • npcdestinations.editown.locwand
  • npcdestinations.editown.loctime
  • npcdestinations.editown.locloc
  • npcdestinations.editown.localias
  • npcdestinations.editown.locskin
  • npcdestinations.editown.locjobs
  • npcdestinations.editown.locsentinel
  • npcdestinations.editown.locweather

English Tutorial Videos:

Spoiler: NPC Destinations V 1.0 - Tutorial [Allowed blocks / Demo Video]

Spoiler: NPC Destinations V 1.0 - Tutorial [Subsurface allowed blocks]

Spoiler: NPC Destinations V 1.0 - Tutorial [no blocks - aka free range chicken mode]

Spoiler: NPC Destinations V 1.15 - Tutorial [Debugging why an NPC refuses to find a path]

Spoiler: NPC Destinations V 1.16+ - Tutorial [Armor / Equipment]

Spoiler: NPC Destinations V 1.20 - Tutorial [Alias Usage examples]

Spoiler: NPC Destinations V 1.29 - Tutorial [Weather]

Spoiler: NPC Destinations V 1.33 - Tutorial [Skins]

External Plugin Integration's:

Spoiler: NPC Destinations V 1.31 - Tutorial [JobsReborn]

Spoiler: NPC Destinations V 1.39 - Tutorial [Sentinel]

Servers Running NPC Destinations:
Medieval-Craft (medieval-craft.my-serv.com)

Spoiler: Medieval-Craft Examples

http://www.livecar.net/random/mecraft.gif

Future Additions:

• NPC Groups
  • Continue what I started with NPCGroups
• Path cache
  • If a destination has been solved from # to #, cache it and only check for changes before searching a new one.
• Allowing Blocks with Data
  • Right now it's a set to a material. I am going to make it so that you can use all type of that block, or a single one. Slabs are the prime reason for this one.
• Better door control
  • Right now it's kind of hokey. Going to make it use the NPC's view perspective for it.
• More BetonQuest integration.
  • Stacked locations. Stack a set of locations for the NPC to move around to. Aka visit #1,{wait 5 sec}, Visit #3, {Wait 30}, Return to #2.
  • If you can think of things you would like to allow access to from beton, let me know.

Source:
My GitHub

Stats:

Enjoy!

* The A* Path finding is a modified version of a* Lib from Adamki11, the original code can be found here.

* This plugin uses the plugin Metrics system. If you want to disable it, follow this link and look to the bottom right. Mostly for my curiosity




Special Thanks:
While I cannot write about everyone here, I want to give some thanks to recognition to people who have gone the extra distance for me in the Spigot community.
@Co0sh: Giving us Benton quest and actually starting my quest to write more plugins (Indirectly).
@bbayu: For always giving me feedback about the plugin and helping others out with issues and to understand this thing.
@Superola: While it's been a bit, just overall sticking with me on some earlier issues and pushing me to keep at it.
@Bundabrg: General help with random things and overall just a good guy in the community.