SparkQuest NPCs
SparkQuest NPCs are Non-Player Characters (NPCs) generated by the Citizens2 plugin for Spigot/Paper Minecraft server. NPCs fill various roles in the game, extending interactions and carrying elements of the story not practical for players. The roles for NPCs are diverse, including Trading NPCs, Guide NPCs, and more.
Creating New NPCs
Creating a NPC can be done easily with this simple command:
/npc create [name]
This will generate a player-type NPC near you labelled with whatever name your provided and with the default traits and behaviors.
The complete command attributes are:
/npc create | [name] ((-b,u) –at [x:y:z:world] –type [type] –trait [‘trait1, trait2…’] –b [behaviours]) |
–type: You can use many of MC’s person, animal, or monster EntityType for NPCs. Some of the more popular ones: VILLAGER, PILLAGER, PLAYER
Typical NPC Creation
- Create the NPC using:
/npc create [name]
–type [EntityType]. (Don’t include –type to use the default “human” player.) - Toggle the NPC to controllable using:
/npc controllable -y
. - Right click the NPC to mount it and “drive” it into starting/standing position.
- Toggle off NPC controllable with:
/npc controllable -n
. - Change the NPC’s skin using:
/npc skin --url [url]
. - Make the NPC look at nearby players:
/npc lookclose
. - Add optional traits like Trader, Sentinel…
Modifying an NPC
NPCs can be modified in numerous ways using commands or built-in editors.
Select A NPC
In order to modify an NPC, you have to select it. Do this with the command:
/npc select
This will select the NPC you’re closest to, so your position is important when using this command.
Using An Editor
There are three editors built in to work on NPCs: Text, Waypoint, and Equipment. See documentation on the editors on the Citizen Wiki.
- Text Editor: (
/npc text
) allows you to edit the dialog text of an NPC with several settings to control when and what kind of text the NPC puts in the chat. See Text Syntax for tips on colors and nodes that print things like the current player’s name. - Waypoint Editor: (
/npc path
) allows you to set waypoint that the NPC will move between and tweak settings governing NPC movements. - Equipment Editor: (
/npc equip
) allows you to add equipment to an NPC if they can wear armor or hold weapons, etc.
Changing Skins
The /npc skin command can be used to set the NPC’s skin. The [name] attribute will give the NPC the skin of that named player or character. A custom skin can be saved and called up by –url or -t [uuid/name].
For example:
/npc skin --url http://unusualkingdom.com/wp-content/uploads/2021/01/cookie_girl.png
…will change the selected NPC’s skin to the Cookie Girl using the skin hosted on this site.
The complete command is:
/npc skin | (-c -l(atest)) [name] (or –url [url] or -t [uuid/name] [data] [signature]) |
Controlling and Moving A NPC
You can ride around on most NPC of pretty much any type. This is useful when wanting to move a NPC around the map. To do toggle this on, select the NPC (see above), and use the following command:
/npc controllable -y
Right click on the NPC and you’ll move to over the NPC’s head and will be able to drive them around. For NPC of a type that is usually rideable, like horses, use:
/npc controllable -m
To remove the ability to ride an NPC use:
/npc controllable -n
You can also move NPCs by teleporting them to specific coords or to a player’s postion:
/npc moveto [00 00 00]