BRNTalk
BRNTalk 是一款专注于对话的 Minecraft(NeoForge)模组,专为 RPG 服务器、任务地图和整合包打造。
它通过将 NPC 对话、分支叙事和面向玩家的消息流统一到一个系统中,以更简洁、更具沉浸感的方式呈现故事内容。
用途
- 构建 NPC 剧情对话 和 分支任务指引
- 为玩家提供更一致的 消息中心风格 UI
- 在关键节点暂停并稍后继续,以匹配任务进度
- 在脚本中运行简单命令以获取反馈,或使用提供的 API 执行更复杂的操作。
有关完整的技术细节(脚本结构、命令、JSON 格式和开发者 API),请参阅仓库 README。
亮点
- IM 风格 UI:BRNTalk 的感觉更接近现代即时通讯应用的信息流,而非 Galgame 式的立绘 + 大文本框布局,也不是直接与世界实体点击交互。
- 按玩家分线程的对话追踪
- 沉浸式阅读 UI:拥有专用的聊天屏幕和新消息通知;提供齿轮风格或原版风格可选
- 分支与等待节点:支持阶段性的任务和叙事流程
- 可配置的体验(打字速度、滚动手感、UI 风格、通知位置等)
- 对服务器友好的设计:适用于多人世界中管理剧情进度,因为脚本分发和进度存储均在服务端进行
- 支持 /reload 热重载:可用于脚本
- 灵活的 API:允许与其他模组或 KubeJS 脚本集成
快速开始
- 安装 BRNTalk 并启动游戏。
- 确认客户端可以打开 BRNTalk 的消息/聊天 UI。
- 加载示例对话内容(
/brntalk start test_demo)或你自己的对话资源。 - 在游戏中触发对话并验证完整流程:
- 自动推进文本
- 分支选项
- 等待节点继续
- 调整 UI 和通知设置以匹配你的游玩风格。
有关对话节点、分支逻辑和集成的高级自定义,请参阅仓库 README。
适用场景
- RPG 生存服务器的新手引导
- 冒险地图的主线/支线剧情讲述
- 整合包中的阶段性指引
- 社区活动章节和角色扮演对话
兼容性与环境
- 平台:NeoForge
- Minecraft 版本:请参见本项目页面/发布文件中列出的版本
- 可选集成:Cloth Config / JEI / FTB Library
更多信息
- 本项目部分架构设计和代码实现借助 AI 工具完成
- 许可协议:基于 MIT 协议开源
- 完整使用文档、开发笔记及脚本结构:请参阅仓库 README 和内部演示对话 json
- 问题与建议:欢迎在项目仓库中提交 Issue
BRNTalk
BRNTalk is a dialogue-focused Minecraft (NeoForge) mod built for RPG servers, quest maps, and modpacks.
It helps you deliver story content in a cleaner, more immersive way by unifying NPC conversations, branching narrative, and player-facing message flow in one system.
What can you use it for?
- Build NPC story conversations and branching quest guidance
- Provide a more consistent message-center style UI for players
- Pause at key nodes and continue later to match quest progression
- Run simple command in scripts for feedback, or conduct more complex operations with provided APIs.
For full technical details (script structure, commands, JSON format, and developer API), please check the repository README.
Highlights
- IM-style UI approach: BRNTalk feels closer to a modern messaging app feed, not a Galgame portrait + big textbox layout, and not direct world-entity click interaction.
- Multi-thread conversation tracking per player
- Immersive reading UI with dedicated talk screen + new message notifications; cogwork-style or vanilla-style is available
- Branching + wait nodes for staged quest and narrative flows
- Configurable experience (typing speed, scrolling feel, UI style, notification placement)
- Server-friendly design for managing story progression in multiplayer worlds, as scripts distribution and progress storage are all server-sided
- Hot-reloading with /reload is available for scripts
- Flexible API that allows integrations with other mods or KubeJS Scripts
Quick Start
- Install BRNTalk and launch the game.
- Confirm the BRNTalk message/talk UI can be opened on the client.
- Load sample dialogue content (/brntalk start test_demo) or your own dialogue resources.
- Trigger a conversation in-game and verify the full flow:
- Auto-advanced text
- Branching choices
- Wait node continuation
- Tune UI and notification settings to match your gameplay style.
For advanced customization of dialogue nodes, branching logic, and integrations, see the repository README.
Good Fit For
- RPG survival server onboarding
- Adventure map main/sub quest storytelling
- Stage-based guidance in modpacks
- Community event chapters and roleplay dialogue
Compatibility & Environment
- Platform: NeoForge
- Minecraft version: follow the versions listed on this project page / release files
- Optional integrations: Cloth Config / JEI / FTB Library
More Information
- For this project, parts of the architecture design and code implementation were created with AI tooling support
- Licensing: open-sourced with MIT license
- Full usage docs, development notes, and script structure: see the repository README and internal demo conversation json
- Issues and suggestions: feel free to open an Issue in the project repository
下载 BRNTalk
下载 BRNTalk
下载 BRNTalk
下载 BRNTalk
下载 BRNTalk
下载 BRNTalk
下载 BRNTalk
下载 BRNTalk
下载 BRNTalk
下载 BRNTalk
中文
本次更新适用于 Minecraft 1.21.1 NeoForge。网络协议升级至 2,客户端与服务端需要同步更新。
改动
- 对话选择:按钮绑定显示时的会话和消息位置,拒绝重复或过期请求,避免误答下一题或重复执行剧情动作。
- 剧本重载:全部候选剧本通过校验后统一生效;语法错误、断链和重复 ID 会保留旧剧本及进行中的对话,合法删除仍可生效。
- 历史同步:全量历史、新对话和追加消息按最多 32 KiB 分片传输,收齐后更新界面;单次传输上限为 64 MiB,编码失败会提示并保留存档,超时或断线时清理未完成传输。
- 客户端状态:退出服务器时清理对话状态;全量同步替换会话后清理旧已读请求,避免旧请求影响新会话。
技术性更改
- 对话操作:统一启动、选择、继续和清除流程,集中协调存档、消息事件、完成判定与客户端同步;操作结果使用独立消息快照。
- 运行数据与恢复:分离剧本仓库、玩家线程存储与历史恢复流程,合并登录时重复的线程重建和全量同步,并补齐玩家退出、服务器停止时的清理。程序化剧本注册也会校验完整候选集合,无效候选抛出
IllegalArgumentException并保留原活动集合。 - 界面职责:分离选项区域和已读请求协调,使按钮布局、点击上下文及已读确认可以独立维护。
English
Minecraft 1.21.1 NeoForge only. Network protocol 2 requires both clients and servers to update.
Changed
- Dialogue choices: bind buttons to the session and message position displayed when they were created. Reject duplicate or stale requests to prevent answering the next question or repeating dialogue actions.
- Script reloads: activate the full candidate set only after validation succeeds. Syntax errors, broken links and duplicate IDs retain the previous scripts and live conversations; intentional deletion still applies.
- History synchronization: transfer full history, new threads and appended messages in frames of at most 32 KiB, applying only complete transfers. Each transfer is limited to 64 MiB; encoding failures display a message and preserve saved history, while timeouts and disconnects clear incomplete transfers.
- Client state: clear dialogue state when leaving a server and discard pending read requests from old sessions after full synchronization replaces them.
Technical Changes
- Conversation operations: centralize start, choice, resume and clear flows, including persistence, message events, completion checks and client synchronization. Operation results use independent message snapshots.
- Runtime data and recovery: separate the script repository, player thread storage and history restoration. Consolidate duplicate login rebuilds and full synchronization, and clean up runtime state on player logout and server shutdown. Programmatic script registration also validates the complete candidate set; invalid candidates throw
IllegalArgumentExceptionand retain the active set. - UI responsibilities: separate the choice area and read-request coordinator so button layout, click context and read acknowledgements can be maintained independently.
中文
BRNQuest 联动仅适用于 Minecraft 1.21.1 NeoForge,要求 BRNQuest 1.0.2 或更新版本。Minecraft 1.20.1 Forge 同步提供下述对话完成状态与 API 更新。
新增
- 对话完成状态会随玩家存档保存;新增
BrntalkAPI.hasCompleted查询与PlayerCompletedConversationEvent完成事件,清除对话时同步清除完成状态。 - [1.21.1 NeoForge] 新增 BRNQuest“到达对话消息”和“完成对话”目标。
- [1.21.1 NeoForge] 新增“开始对话”“继续对话”和“打开对话界面”奖励,可用于独立奖励及组合、随机、选择奖励表。
English
BRNQuest integration is available only on Minecraft 1.21.1 NeoForge and requires BRNQuest 1.0.2 or newer. Minecraft 1.20.1 Forge also receives the conversation-completion state and API updates below.
Added
- Conversation completion is saved with player data, with a new
BrntalkAPI.hasCompletedquery andPlayerCompletedConversationEventcompletion event. Clearing a conversation also clears its completion state. - [1.21.1 NeoForge] Added BRNQuest objectives for reaching a dialogue message and completing a conversation.
- [1.21.1 NeoForge] Added rewards for starting or resuming a conversation and opening the dialogue screen, usable individually or in grouped, random and choice reward tables.
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
AE2:一款流行的自动化与存储模组
评论 0
登录后参与评分
还没有评论,来抢沙发吧