Aviel Dialogue Mod

About

Aviel Dialogue Mod is a dialogue framework for Minecraft mods and modpacks. It adds a flexible JSON-based system for creating NPC conversations, branching dialogue, quest-like interactions, and story scenes without hardcoding every conversation in Java.

The mod is designed for creators who want dialogue in their worlds. You can create simple one-line conversations, multi-step branching dialogue trees, conditional choices, item exchanges, remembered player decisions, random starting lines, styled text, and dialogue sounds.

Main features

Branching conversations
Each dialogue can contain multiple nodes and choices. A player can move between dialogue branches, close the conversation, unlock new options, or trigger different outcomes.

Dialogue sounds
Dialogues support both repeating text sounds and full voice/audio sounds. You can play a small sound per letter, use a full sound for a dialogue line, or trigger sounds from inline text tags.

Custom styling
Dialogue windows can be customized with different text colors, background colors, button colors, hover colors, and other visual settings, so the UI can better match the style of your mod or modpack.

NPC and entity support
The mod includes dialogue NPC support, but it is also built so modders can attach dialogues to other entities. This makes it useful not only for custom NPCs, but also for existing mobs, bosses, villagers, or scripted encounters.

For developers

ADM is built to be useful as both a standalone mod and a developer-facing dialogue library. Other modders can create dialogue files, define reusable NPC templates, attach dialogues to entities, and build custom interactions around the dialogue system.

The system is intended to reduce the amount of hardcoded conversation logic needed in mods. Instead of writing every dialogue branch directly in Java, developers can describe dialogue behavior through JSON and connect it to their own entities, NPCs, quests, or progression systems.

Why download it?

It is useful for story-driven mods and modpacks, adventure maps, modded servers, quest packs, and modpacks that need more immersive character interactions.

The goal of ADM is to be both usable for simple dialogue and powerful enough for larger narrative systems. A small NPC can have a few lines, while a larger project can use flags, conditions, choices, item checks, commands, sounds, and templates to create connected questlines.

Useful Information

Wiki and documentation

You can find setup instructions, JSON examples, dialogue syntax, template usage, and developer notes here:

ADM Wiki

Important note

This mod is still under development. Some features may change as the API and configuration format improve. If you find a bug or need help, please visit the GitHub page.