Chatbox for mc - Dialog System for Minecraft

This mod brings a complete dialog window system to Minecraft, inspired by popular visual novels. Everything is configured through data packs, allowing you to fully customize the visual style and functionality of dialogs.

Main Features

Create diverse themes for dialog boxes and instantly switch between them using simple commands. You can finely tune the appearance, positioning, and sizes of all interface elements: the dialog windows themselves, response selection panels, conversation history buttons, and character portraits.

Character portraits support three formats: standard images, player avatars, and item textures. For images, there are three built-in entrance animations available, plus the ability to create custom effects.

Dialog System

Configure branching dialogs with multiple response options. Each choice can execute custom commands or advance the character to other dialog branches. All text elements are compatible with Minecraft's translation system, simplifying content localization.

Since configuration is fully implemented through data packs, any changes can be instantly applied using the /reload command. Create complex dialog systems without writing a single line of code!

Built-in Commands

Theme switching:

/chatbox theme <data_pack_path : ResourceLocation>

Jump to specific dialog:

/chatbox skip <data_pack_path : ResourceLocation> <group : String> <index : int>

Open dialog box:

/chatbox open

Event System for Developers

For KubeJS users, the mod provides a comprehensive event system:

// Triggered BEFORE dialog rendering. Provides GuiGraphics for custom graphics. Can be cancelled.
let $ChatBoxRender$Post = Java.loadClass("com.zhenshiz.chatbox.event.ChatBoxRender$Post");
NativeEvents.onEvent($ChatBoxRender$Post, event => {
    let guiGraphics = event.getGuiGraphics();
});

// Triggered AFTER dialog rendering. Provides GuiGraphics for custom graphics.
let $ChatBoxRender$Pre = Java.loadClass("com.zhenshiz.chatbox.event.ChatBoxRender$Pre");
NativeEvents.onEvent($ChatBoxRender$Pre, event => {
    let guiGraphics = event.getGuiGraphics();
});

// Triggered when advancing to another dialog. Provides metadata for creating custom functionality.
let $SkipChatEvent = Java.loadClass("com.zhenshiz.chatbox.event.SkipChatEvent");
NativeEvents.onEvent($SkipChatEvent, event => {
    let { chatBoxScreen, resourceLocation, group, index } = event;
});

Example data packs and complete documentation are available on GitHub. Currently in development is a web-based tool for automatic JSON configuration generation, which will significantly simplify the dialog setup process.