DummyDialoguesNPC

DummyDialoguesNPC is a lightweight dialogue engine for NPC conversations, built to replace plain "chat spam" dialogues with a real typewriter-style dialogue box: a custom background image, pixel-perfect centered text, a voice that reacts to what's happening, and full control over pacing — all generated automatically from a single .png you drop in a folder.

No manual resource pack editing. No fighting with fonts. You bring the image, the plugin builds the rest.

✔ Auto-Generated Resource Pack
✔ Pixel-Perfect Centered Text (no "dancing" backgrounds)
✔ Fully Configurable Typewriter Effect
✔ Cutscene-Style Auto-Advancing Dialogues
✔ Dynamic Voice: Pitch, Volume, Custom Sounds
✔ Persistent Player Flags (Built-In Memory)
✔ Conditional Branching (Item / Permission / Tag / Team / Score / Flag)
✔ Punctuation-Aware Typing Pauses
✔ Simple, Readable YAML

Everything is configured through plain YAML files. No database. No unnecessary dependencies.

Set it up once, drop your images, and you're ready to go.


AUTO-GENERATED RESOURCE PACK
Drop a .png into the backgrounds folder and reload. DummyDialoguesNPC reads the image, generates the matching font entry, and builds a ready-to-host resource pack (folder or .zip) — no manual font.json editing, ever.

PIXEL-PERFECT, NON-"DANCING" TEXT
Text width is calculated letter by letter (not by character count), so your background image stays perfectly still while the text types itself out — centered, every single frame.

FULLY CUSTOMIZABLE TYPEWRITER
Control typing speed down to fractional ticks, or skip the effect entirely with instant_text (the "voice" keeps playing as if the NPC is still talking). Add natural breathing pauses on commas and periods with punctuation_pauses.

CUTSCENE MODE
Enable auto_skip to let dialogues play themselves out, no player input required — perfect for intros, story beats or cutscenes. Mix it freely with manual, player-paced lines in the very same dialogue.

VOICE WITH PERSONALITY
Randomized pitch variance so the typing "blip" doesn't sound robotic, per-line volume control (whisper or shout mid-conversation), support for both vanilla and custom resource-pack sounds, and the choice between a blip on every letter or a single sound per line.

THE NPC REMEMBERS
A built-in, persistent per-player flag system — no external plugin needed. Set a flag once something happens, and check for it later to write dialogues that evolve with each player's choices.

CONDITIONAL BRANCHING
then/else blocks driven by checks on items, permissions, scoreboard tags, teams, scores, or your own flags — build dialogue trees that react to each player.

RUN COMMANDS MID-DIALOGUE
Trigger console or player commands at any point in the conversation — give items, play effects, or hook into any other plugin your server runs.




/dd create <name>
Creates a new dialogue file with a ready-to-edit example template.

/dd start <dialogue> [player]
Starts the given dialogue for yourself, or for another player if you have admin permission.

/dd stop
Stops your own active dialogue.

/dd list
Lists every dialogue currently loaded.

/dd reload
Reloads every dialogue and regenerates the resource pack.


dummydialoguesnpc.admin
Allows creating, reloading, and starting dialogues for other players. (default: op)

dummydialoguesnpc.start
Allows a player to start/stop their own dialogues. (default: true)


Every dialogue is its own YAML file, with per-dialogue control over background, typing speed, sounds, volume, auto-skip, punctuation pauses, exit behavior and more. Backgrounds are tuned per-image (ascent, height, offset, text area width), auto-computed the first time they're loaded and fully editable by hand afterwards.

Comes bundled with two full interactive tutorials (English and Spanish) that teach the whole system in-game, no reading required.


1. Download DummyDialoguesNPC
Download the latest DummyDialoguesNPC.jar.

2. Install the plugin
Place the JAR inside your server's /plugins folder.

3. Start your server
Start or restart the server — DummyDialoguesNPC will generate its folders, config, and the built-in tutorials.

4. Create your dialogues
Use /dd create <name> and edit the generated YAML to build your own conversations.

5. Add your backgrounds
Drop your own .png images into /plugins/DummyDialoguesNPC/backgrounds and run /dd reload.

6. Host the resource pack
Point your server (or your resource-pack hosting plugin) to the pack generated in /plugins/DummyDialoguesNPC/generated (or resourcepack.zip) — same as with any resource pack.


That's it!


Built purely on the Paper API.


PlaceholderAPI is supported if installed (optional, not required).
NPC interaction works with any NPC plugin capable of running commands (e.g. Citizens) — DummyDialoguesNPC has no hard dependency on Citizens itself.



Found a bug or have an idea for DummyDialoguesNPC?
Feel free to leave a message on the resource discussion page with the issue or suggestion.

If you enjoy using DummyDialoguesNPC, consider leaving a rating or review — it helps support future updates.