ChatBox

ChatBox is a Minecraft mod that implements a complete dialog box system similar to those found in visual novels. Its main advantage is full customization through data packs without the need to modify code.

Main Features

Customize the appearance of dialog boxes to your liking: choose from pre-made themes, adjust the size and positioning of interface elements. The interface includes a dialog box, option selection panel, message history button, and character portraits.

Character portraits support three display types: custom images, player avatars, and item textures. Each portrait can be accompanied by an entry animation - for images, three ready-made options are available that are easy to configure.

Create branching dialogs with multiple choice responses. Each option can trigger custom commands and guide the conversation to different topics. All text elements support the localization system through translation keys.

Command Usage

Changing appearance theme:

/chatbox theme <file_path>

Jumping to a specific dialog:

/chatbox skip <file_path> <group> <index>

Opening the dialog box:

/chatbox open

For Developers

KubeJS users have access to the event system:

// Client custom script

// Triggers BEFORE dialog rendering. Provides access to the graphics context.
ChatBoxEvents.renderPre(event => {
  let graphics = event.getGuiGraphics()
  event.cancel() // Interrupt rendering
})

// Triggers AFTER dialog rendering.
ChatBoxEvents.renderPost(event => {
  let graphics = event.getGuiGraphics()
})

// Triggers when jumping to a new dialog.
ChatBoxEvents.skipChat(event => {
  let { chatBoxScreen, resourceLocation, group, index } = event
})

Since all configuration is implemented through data packs, you can quickly apply changes using the /reload command. The developer is working on a web-based JSON generator that will simplify dialog creation.