
chatbox
a chatbox in mc
Обновлён 3 июля 2026 г. · опубликован 14 мая 2025 г.
Mod Introduction
ChatBox is a dialog box mod designed for Minecraft, inspired by the dialog systems found in Galgames. You can configure it using data packs:
Pre-set multiple themes for dialog boxes and switch between them anytime using commands.
Customize the appearance, position, and size of dialog boxes, option boxes, history buttons, and character portraits.
Character portraits support multiple types: images, player avatars, and item textures. You can define custom entry animations for these portraits, with images having 3 preset animations.
Configure dialog text and multiple options for each line. Clicking options can trigger custom commands and jump to other dialogs.
All text elements (dialogs, options) support translation keys.
Since all dialog configurations are implemented through data packs, you can reload all dialog settings directly using the /reload command. Create beautiful dialog systems without modifying any code!
Built-in Commands
Switch themes:
/chatbox theme
Jump to a specific dialog:
/chatbox skip
Open dialog box:
/chatbox open
Event System
For KubeJS users, the mod provides predefined events:
//client_script
// Triggered BEFORE dialog rendering. Provides GuiGraphics for custom rendering. Cancellable.
ChatBoxEvents.renderPre(event=>{
let getGuiGraphics = event.getGuiGraphics()
event.cancel()
})
// Triggered AFTER dialog rendering. Provides GuiGraphics for custom rendering.
ChatBoxEvents.renderPost(event=>{
let getGuiGraphics = event.getGuiGraphics()
})
// Triggered when jumping to a dialog. Provides dialog metadata for custom functionality.
ChatBoxEvents.skipChat(event => {
let { chatBoxScreen, resourceLocation, group, index } = event
})
Additional Information
Example data packs and documentation are available on GitHub. Upcoming feature: The author is developing a web-based JSON generator to simplify dialog configuration. Stay tuned for its release!
Версии
| Версия | Канал | Игра | Загрузчики | Дата | Скачать |
|---|---|---|---|---|---|
| 1.1.4-forge-1.20.1 | Релиз | 1.20.1 | forge | 3 июля 2026 г. | Скачать (1.4 МБ) |
| 1.1.4-fabric-1.20.1 | Релиз | 1.20.1 | fabric | 3 июля 2026 г. | Скачать (1.4 МБ) |
| 1.1.4 | Релиз | 1.21.1 | neoforge | 3 июля 2026 г. | Скачать (1.4 МБ) |
| 1.1.4-fabric-1.21 | Релиз | 1.21, 1.21.1 | fabric | 3 июля 2026 г. | Скачать (1.4 МБ) |
| 1.1.3-forge-1.20.1 | Релиз | 1.20.1 | forge | 19 апреля 2026 г. | Скачать (1.4 МБ) |
| 1.1.3-fabric-1.20.1 | Релиз | 1.20.1 | fabric | 19 апреля 2026 г. | Скачать (1.4 МБ) |
| 1.1.3 | Релиз | 1.21.1 | neoforge | 19 апреля 2026 г. | Скачать (1.4 МБ) |
| 1.1.3-fabric-1.21 | Релиз | 1.21, 1.21.1 | fabric | 19 апреля 2026 г. | Скачать (1.4 МБ) |
| 1.1.2-forge-1.20.1 | Релиз | 1.20.1 | forge | 3 апреля 2026 г. | Скачать (1.4 МБ) |
| 1.1.2-fabric-1.20.1 | Релиз | 1.20.1 | fabric | 3 апреля 2026 г. | Скачать (1.4 МБ) |
| 1.1.2 | Релиз | 1.21.1 | neoforge | 3 апреля 2026 г. | Скачать (1.4 МБ) |
| 1.1.2-fabric-1.21 | Релиз | 1.21, 1.21.1 | fabric | 3 апреля 2026 г. | Скачать (1.4 МБ) |
| 1.1.1-forge-1.20.1 | Релиз | 1.20.1 | forge | 22 февраля 2026 г. | Скачать (709 КБ) |
| 1.1.1-fabric-1.20.1 | Релиз | 1.20.1 | fabric | 22 февраля 2026 г. | Скачать (703 КБ) |
| 1.1.1 | Релиз | 1.21.1 | neoforge | 22 февраля 2026 г. | Скачать (662 КБ) |
Показаны последние 15 из 51 версий.
Ченджлог
1.1.4-forge-1.20.1Релиз1.20.1 · 3 июля 2026 г.
-
优化历史记录界面的渲染
-
优化MVEL解析,详见扩展功能-MVEL文档,现在可以在对话文本中写
<<MVEL代码>>当做更加强大的占位符使用(需要代码执行后有返回值) -
对话文本配置新增字段:
-
bgm:用于控制背景音乐播放-
若值有效,只要玩家处于对话框界面,该音效就会循环播放
-
连续的对话若该字段值相同,背景音乐不会重新开始
-
填写空字符串会停止背景音乐(不想为了bgm再加个类似于stopBgm的字段)
-
如果不写该字段(即为null的情况),不会有任何操作(意思是你可以只在需要播放和停止背景音乐时才写这个字段)
-
-
stayTick:强制玩家在该对话停留时长,若未达到指定时长,玩家无法跳转下一句对话(默认值为0,填负数则不论过多久玩家都无法跳转,不影响选项的跳转)
-
-
修复无法正常检查音效是否正在播放的bug
1.1.4-fabric-1.20.1Релиз1.20.1 · 3 июля 2026 г.
-
优化历史记录界面的渲染
-
优化MVEL解析,详见扩展功能-MVEL文档,现在可以在对话文本中写
<<MVEL代码>>当做更加强大的占位符使用(需要代码执行后有返回值) -
对话文本配置新增字段:
-
bgm:用于控制背景音乐播放-
若值有效,只要玩家处于对话框界面,该音效就会循环播放
-
连续的对话若该字段值相同,背景音乐不会重新开始
-
填写空字符串会停止背景音乐(不想为了bgm再加个类似于stopBgm的字段)
-
如果不写该字段(即为null的情况),不会有任何操作(意思是你可以只在需要播放和停止背景音乐时才写这个字段)
-
-
stayTick:强制玩家在该对话停留时长,若未达到指定时长,玩家无法跳转下一句对话(默认值为0,填负数则不论过多久玩家都无法跳转,不影响选项的跳转)
-
-
修复无法正常检查音效是否正在播放的bug
1.1.4Релиз1.21.1 · 3 июля 2026 г.
-
优化历史记录界面的渲染
-
优化MVEL解析,详见扩展功能-MVEL文档,现在可以在对话文本中写
<<MVEL代码>>当做更加强大的占位符使用(需要代码执行后有返回值) -
对话文本配置新增字段:
-
bgm:用于控制背景音乐播放-
若值有效,只要玩家处于对话框界面,该音效就会循环播放
-
连续的对话若该字段值相同,背景音乐不会重新开始
-
填写空字符串会停止背景音乐(不想为了bgm再加个类似于stopBgm的字段)
-
如果不写该字段(即为null的情况),不会有任何操作(意思是你可以只在需要播放和停止背景音乐时才写这个字段)
-
-
stayTick:强制玩家在该对话停留时长,若未达到指定时长,玩家无法跳转下一句对话(默认值为0,填负数则不论过多久玩家都无法跳转,不影响选项的跳转)
-
-
修复无法正常检查音效是否正在播放的bug
1.1.4-fabric-1.21Релиз1.21, 1.21.1 · 3 июля 2026 г.
-
优化历史记录界面的渲染
-
优化MVEL解析,详见扩展功能-MVEL文档,现在可以在对话文本中写
<<MVEL代码>>当做更加强大的占位符使用(需要代码执行后有返回值) -
对话文本配置新增字段:
-
bgm:用于控制背景音乐播放-
若值有效,只要玩家处于对话框界面,该音效就会循环播放
-
连续的对话若该字段值相同,背景音乐不会重新开始
-
填写空字符串会停止背景音乐(不想为了bgm再加个类似于stopBgm的字段)
-
如果不写该字段(即为null的情况),不会有任何操作(意思是你可以只在需要播放和停止背景音乐时才写这个字段)
-
-
stayTick:强制玩家在该对话停留时长,若未达到指定时长,玩家无法跳转下一句对话(默认值为0,填负数则不论过多久玩家都无法跳转,不影响选项的跳转)
-
-
修复无法正常检查音效是否正在播放的bug
1.1.3-forge-1.20.1Релиз1.20.1 · 19 апреля 2026 г.
组件新增widthReference和heightReference字段,以保证在不同窗口尺寸下,图片的宽高比可以不变
修复了在跳转到一句新的对话时触发跳转对话(jump)事件会导致崩溃的bug
1.1.3-fabric-1.20.1Релиз1.20.1 · 19 апреля 2026 г.
组件新增widthReference和heightReference字段,以保证在不同窗口尺寸下,图片的宽高比可以不变
修复了在跳转到一句新的对话时触发跳转对话(jump)事件会导致崩溃的bug
1.1.3Релиз1.21.1 · 19 апреля 2026 г.
组件新增widthReference和heightReference字段,以保证在不同窗口尺寸下,图片的宽高比可以不变
修复了在跳转到一句新的对话时触发跳转对话(jump)事件会导致崩溃的bug
1.1.3-fabric-1.21Релиз1.21, 1.21.1 · 19 апреля 2026 г.
组件新增widthReference和heightReference字段,以保证在不同窗口尺寸下,图片的宽高比可以不变
修复了在跳转到一句新的对话时触发跳转对话(jump)事件会导致崩溃的bug
Комментарии
Загружаем…


