NPCs & Dialogs - Lode Entities

NPCs

NPCs are mobs with type: npc, so they are spawned, looked up and contributed through mobs() like any other mob. LodeEntitiesAPI.npcs() is the same registry narrowed to them:

String npcId = LodeEntitiesAPI.npcs().npcId(clickedEntity);   // null if it isn't an NPC
boolean isNpc = LodeEntitiesAPI.npcs().isNpc(clickedEntity);
MobDefinition def = LodeEntitiesAPI.npcs().get("bob");        // null for a plain mob
Set<String> ids = LodeEntitiesAPI.npcs().ids();               // also all()
String dialog = def.getDialog();                              // also getLook(), isNpc()

To replace what a right-click does, cancel NpcInteractEvent: that skips the NPC’s dialog, while its own +onInteract lines still run.

Dialogs

Branching conversations from Dialogs/ can be driven from code: start one from an item use, a region enter, a quest step.

LodeEntitiesAPI.dialogs().start(player, "bob_talk", npcEntity, "&6Bob"); // npc and name optional
boolean talking = LodeEntitiesAPI.dialogs().isInDialog(player);
LodeEntitiesAPI.dialogs().end(player);

ids() and get(id) are there too. The NPC argument is optional, so a dialog doesn’t have to belong to an NPC at all.

Dialogs speak the same effect language

Custom conditions you register are immediately usable in dialog conditions: blocks, and custom mechanics in dialog node effects:. Nothing extra to wire up. See NPC Dialogs and Dialog Conditions for the config side.