Skip to content

NPCs

NPCs are an essential part of every RPG for player ingame interactions. In BetonQuest, NPCs can be used to start conversations or act as a means for player interactions in various ways, as shown in the Scripting and Visual Effects section of the documentation.

Provided Integrations🔗

BetonQuest provides integrations for the following NPC plugins:

Referring an NPC🔗

NPCs are defined in the npcs section.

NPC Referencing Syntax
betonQuestNPCID: NPCSelector NPCID
You would then use the betonQuestNPCID for all NPC references within BetonQuest.

Example NPCs section
npcs:
  innkeeper: citizens 0
  mayorHans: citizens 4
  guard: citizens Guard byName

Use citizens for the NPC selector argument. To acquire the NPC's ID, select the NPC using /npc select, then run /npc id.

You can also get an NPC by its name with the byName argument. This is useful when you have multiple NPCs with the same name who should all start the same conversation or count together in the npcinteract and npckill objectives.

Example NPCs section
npcs:
  mayorHans: mythicmobs UUID b18af0c3-5db7-4878-9693-05fe1b2c5a2f
  innkeeper: mythicmobs MYTHIC_MOB inkeeper
  guard: mythicmobs FACTION guards

Use mythicmobs for the NPC selector argument. Use Entity UUIDs for the NPC ID argument. To acquire the NPCs UUID, use the /mm listactive command and copy the UUID from the NPC info. Alternatively, you can look at the NPC and use the /data get entity command to auto complete the UUID.

You can also get an NPC by its MythicMob Internal_Name or Faction. This is useful when you have multiple NPCs who should all start the same conversation or count together in the npcinteract and npckill objectives.

Example NPCs section
npcs:
  innkeeper: FancyNpcs dc8f2889-ed79-455e-944b-115dae978737
  mayorHans: FancyNpcs 72910823-c0c3-499d-adcc-d31cb75963c0
  guard: FancyNpcs Guard byName

UseFancyNpcs for the NPC selector argument. To acquire the NPCs ID, use the /npc nearby command and copy the UUID from the NPC info.

You can also get an NPC by its name with the byName argument. This is useful when you have multiple NPCs who should all start the same conversation or count together in the npcinteract and npckill objectives.

Example NPCs section
npcs:
  bernhard: ZNPCsPlus bernhard
  guard: ZNPCsPlus Guard10

Use ZNPCsPlus for the NPC selector argument. To acquire the NPCs ID, use the /npc near 5 command and copy the ID from the NPC info.

Multiple NPCs with the same name

If there is more than one NPC with the same name and you select multiple NPCs by name (such as when using Citizens byName option), certain events like npcteleport or objectives like npcrange might throw an exception.

Conversations🔗

You can start Conversations through NPC interactions from players by assigning them in the npc_conversations section of a quest package.

NPC Hiding: hide_npcs🔗

You can hide NPCs for certain players using conditions. You can find information about it here.