ModsFinder

ChatDiag

by Lau6L

ChatDiag is a Fabric library that lets server owners play timed, non-interactive chat dialogs, such as monologues and event narration, on a server.

FabricServer required, client optionalMIT LicenseOpen source1.21 – 1.21.11

What it does

Dialogs are defined as data-driven JSON files under the chatdiag directory of a datapack or mod resources, using namespaced identifiers. Each dialog holds a list of lines, and each line can render text before or after it plays, play a sound, and wait for a delay. Timing is set in words per minute, with 120 as the default and values between 0.5 and 2.0 allowed as a multiplier.

When one dialog ends, the next one starts, which makes it possible to chain dialogs together. The chain shares a single completable future, so code waiting on it is only notified once the entire chain has finished. Dialog lines can also carry custom behaviors, and a defined custom behavior can override the settings of its parent dialog.

The mod requires Fabric API. The server must run it, while players may add it, so clients can join without installing ChatDiag. It is open source under the MIT License and is published for Fabric across 12 game versions, 1.21 – 1.21.11, with 1.0.0+1.21.11 for 1.21.11 as the latest file. Dialogs also work with datapacks, command blocks and other mod integrations.

Key features

  1. Timed line delivery

    Each line is delivered at a words-per-minute rate, with precise pacing set per line and a configurable delay between lines.

  2. Chained dialogs

    A Next command or a next-dialog field starts another dialog after the current one ends, so long sequences can be split into parts.

  3. Formatting and sounds

    Dialog text supports formatting codes, custom sounds, fonts and commands, which suits story scenes and map events.

  4. Custom behaviors

    Lines can be given a custom behavior object that overrides the dialog's own settings, letting map makers adjust individual steps.

Compatibility

Latest build for each game version and loader.

1.21.x12 of 12 versions with builds
1.21.111.0.0+1.21.11
1.21.101.0.0+(1.21.9-1.21.10)
1.21.91.0.0+(1.21.9-1.21.10)
1.21.81.0.0+(1.21.6-1.21.8)
1.21.71.0.0+(1.21.6-1.21.8)
1.21.61.0.0+(1.21.6-1.21.8)
1.21.51.0.0+(1.21.4-1.21.5)
1.21.41.0.0+(1.21.4-1.21.5)
1.21.31.0.0+(1.21-1.21.3)
1.21.21.0.0+(1.21-1.21.3)
1.21.11.0.0+(1.21-1.21.3)
1.211.0.0+(1.21-1.21.3)
ReleaseBetaAlphaNot available

Only full game releases are shown. This mod publishes no snapshot builds.

Requirements

Dependencies declared by the latest file for each loader.

Required 1

Fabric APILightweight and modular API providing common hooks and intercompatibility measures utilized by mods using the Fabric toolchain.
Required

How it compares

Full comparison

Dialog Teleport is open source under the GNU General Public License v2.0 only, and it runs on Fabric, Forge, NeoForge and Quilt for 1.21.6 – 1.21.11. The server is required and the client is optional there, so it covers more loaders than ChatDiag.

ModLoadersGame versionsEnvironmentUpdated
ChatDiagFabric1.21 – 1.21.11Server required, client optional2026-06-22
Dialog TeleportFabric, Forge, NeoForge and Quilt1.21.6 – 1.21.11Server required, client optional2025-12-09

Questions

Does ChatDiag need Fabric API?

Yes. Fabric API is a required dependency, so it must be installed next to ChatDiag on Fabric.

Does a player need ChatDiag to see dialogs?

No. The server must run the mod, while the client is optional, so players can join without installing it.

Where are dialog definitions placed?

Definitions must reside under the chatdiag directory as .json files in a datapack or in mod resources, and they load from a namespaced identifier.

Which game versions does ChatDiag support?

Files are published for 12 game versions, 1.21 – 1.21.11, with the latest Fabric file for 1.21.11.

In the catalog

ChatDiag is one of 3,514 Library mods on ModsFinder, and one of 2,348 Library mods for Fabric. 19,862 mods support Minecraft 1.21.11.

Library mods3,514Fabric modsMods for 1.21.1119,862

More from Lau6L

All projects
Totem of Allying1.21.5 – 1.21.11

Similar mods

Fabric API1.14 – 26.3Cloth Config API1.14 – 26.3YetAnotherConfigLib (YACL)1.19 – 26.3Architectury API1.16.5 – 26.3Just Enough Items (JEI)1.8 – 26.3Geckolib1.12.2 – 26.3

What the author says

This lightweight mod adds structured, timed messages to chat: create monologues with precise WPM timing and line-by-line delivery! ChatDiag's dialogs can be provided by datapacks, command blocks, player execution, or mod integration. They are specially designed for storytelling in server events and mapmaking.
Lau6L, on the Modrinth page

Official listing

Owner
Lau6L
Published
2026-04-23
Updated on Modrinth
2026-06-22
Facts verified
2026-10-15

Tags

Game mechanicsLibraryUtility
Open on ModrinthCompare