Dialogs are the main conversation system in Easy NPC. They can be simple text popups, yes/no choices, or larger dialog trees with multiple entries, conditions, and button actions.

These placeholders work in dialog text:

Example:

Hello @initiator, my name is @npc.

Dialog text also supports the @score() macro:

If the scoreboard or value does not exist, the shown value falls back to 0.

Dialog text supports the color and formatting placeholders shown below.

Common examples:

• <red>Warning</red>
• <gold><bold>Quest Complete</bold></gold>
• <gray>Come back later.</gray>

Basic dialog is the fastest setup for short text. It is best for greetings, one-step hints, and simple information screens.

Yes/No dialog adds two buttons with separate actions. It works well for confirmations, quests, shop prompts, or simple branching.

Each button can have its own action list.

Advanced dialog supports multiple entries, multiple text variations, dialog buttons, conditions, and priorities.

If you expand a simpler dialog with extra entries or advanced button logic, it effectively becomes an advanced dialog setup.

The advanced dialog editor lets you manage:

• entry label
• default state
• dialog text
• button list
• conditions
• priority

Only one entry should normally act as the main automatic start point.

Dialog buttons can trigger multiple actions in order. This is where dialogs connect to commands, trading, and follow-up dialogs.

If no actions are defined, the button closes the dialog.

Easy NPC automatically prefers entries such as:

• default
• start
• main

You can also mark an entry as default in the editor.

Dialogs can be filtered and ordered with:

• scoreboard conditions
• execution-limit conditions
• priority values

This is useful when the same NPC should react differently depending on player progress.

Examples:

• first visit greeting
• quest-ready dialog
• fallback small talk
• hidden dialog only opened by action or command

Current default priority groups in the code are:

• Critical (100)
• High (10)
• Normal (5)
• Low (1)
• Fallback (0)
• Manual Only (-1)

Labels such as default, start, or welcome are treated as high-priority defaults by the current code. Labels such as main, help, or question default to normal priority. Labels such as bye, idle, or thanks default to low priority.

Dialogs with priority Manual Only are never selected automatically and must be opened through an action or command.

Open the current default dialog:

/easy_npc dialog open <NPC> <player>

Open a specific dialog by label:

/easy_npc dialog open <NPC> <player> <dialog_uuid_or_label>

Set a dialog priority:

/easy_npc dialog set priority <NPC> <dialog_uuid_or_label> <priority>

The dialog screen uses normal texture assets and can be changed with a standard resource pack. The current background textures are:

• assets/easy_npc/textures/gui/dialog/scene_small.png
• assets/easy_npc/textures/gui/dialog/scene_medium.png
• assets/easy_npc/textures/gui/dialog/scene_large.png

The dialog navigation and close buttons also use normal textures:

• assets/easy_npc/textures/gui/navigation_button.png
• assets/easy_npc/textures/gui/close_button.png

To change the look, place files with the same paths inside your resource pack and let them override the originals. You do not need to modify the mod jar.

Config UI backgrounds can be overridden in the same way with:

• assets/easy_npc_config_ui/textures/gui/config_screen/background.png
• assets/easy_npc_config_ui/textures/gui/config_screen/background_small.png

• easy_npc:give_dirt_or_stone_to_player
• easy_npc:professor_quiz