摘要
Simple Dialogue 是一个轻量级的 Paper 插件,用于构建简单的 NPC 对话树。
它通过自定义的 simple_dialogue 动作与 FancyNpcs 集成。将该动作添加到 NPC 的左键和右键触发器后,玩家即可通过点击 NPC 在分支式的 YAML 对话中前进。
对话文件为纯 YAML 格式,存储在 plugins/SimpleDialogue/dialogues/ 目录下,并支持在对话行中使用 MiniMessage。当玩家点击浏览对话树时,插件会将每个玩家的当前活跃对话节点保留在内存中。
这是 Simple Dialogue 的第一个稳定版本。
功能
- YAML 对话文件
- 左键和右键分支选项
- FancyNpcs 自定义动作:
simple_dialogue
- 控制台命令回退机制(使用
/sd click)
- 独立的玩家对话会话
- 支持 MiniMessage 格式的对话行
- 可配置的 NPC/玩家前缀
- RPG 风格的选项提示,支持
left-text 和 right-text
- 首次启动时包含示例对话
- 额外提供商人示例对话以供测试
- 管理员命令:创建对话、添加节点、自动推进引言、连接分支、执行节点命令以及标记结束点
/sd validate 命令用于检查对话树中的错误
要求
- Paper
26.1.2
- Java
25 或更高版本
- FancyNpcs
2.10.0 或兼容的新版本
不支持 Spigot。
设置
安装 Simple Dialogue 和 FancyNpcs 后,将两个动作都添加到你的 NPC 上:
/npc action guide LEFT_CLICK add simple_dialogue guide
/npc action guide RIGHT_CLICK add simple_dialogue guide
最后一个参数是 YAML 文件中的对话 ID,例如对于 plugins/SimpleDialogue/dialogues/guide.yml,ID 为 guide。
稳定版说明
- 插件重载或服务器重启后,对话会话将重置。
- 建议仍使用 YAML 编辑来审查大型对话树。
- 节点命令在主服务器线程上运行,即使是通过 FancyNpcs 触发也是如此。
链接
- 源代码:
- 问题反馈:
- 文档:
- 发布页面:
- 许可证:MIT
版本频道文本
v1.0.0 是第一个稳定版本。它包括 YAML 对话树、左右分支、next 引言节点、节点命令、/sd validate、完整的服务器命令编辑、FancyNpcs 的 simple_dialogue 动作、控制台命令回退机制,以及从 FancyNpcs 点击触发的线程安全节点命令执行。
手动版本清单
- 版本号:
v1.0.0
- 渠道:
Release
- 平台:Paper
- 平台版本:
26.1.2
- 文件:
simple-dialogue-1.0.0.jar
- 外部发布 URL:
https://github.com/Kcajpanda/simple_dialogue/releases/tag/v1.0.0
- 依赖项:FancyNpcs,必需
- 保存并发布该版本,然后在注销状态或使用隐私窗口登录时检查公共
/versions 页面。
Summary
Simple Dialogue is a lightweight Paper plugin for small NPC conversation trees.
It integrates with FancyNpcs through a custom simple_dialogue action. Add the action to an NPC's left-click and right-click triggers, then players can move through branching YAML dialogue by clicking the NPC.
Dialogue files are plain YAML, stored in plugins/SimpleDialogue/dialogues/, and support MiniMessage in dialogue lines. The plugin keeps each player's active conversation node in memory while they click through the tree.
This is the first stable release of Simple Dialogue.
Features
- YAML dialogue files
- Left-click and right-click branching
- FancyNpcs custom action:
simple_dialogue
- Console-command fallback with
/sd click
- Per-player active dialogue sessions
- MiniMessage dialogue lines
- Configurable NPC/player prefixes
- RPG-style choice prompts with
left-text and right-text
- Sample dialogue included on first startup
- Extra merchant example dialogue included for testing
- Admin commands for creating dialogues, adding nodes, auto-advancing intros, wiring branches, running node commands, and marking endings
/sd validate command for checking dialogue tree mistakes
Requirements
- Paper
26.1.2
- Java
25 or newer
- FancyNpcs
2.10.0 or compatible newer version
Spigot is not supported.
Setup
After installing Simple Dialogue and FancyNpcs, add both actions to your NPC:
/npc action guide LEFT_CLICK add simple_dialogue guide
/npc action guide RIGHT_CLICK add simple_dialogue guide
The last argument is the dialogue id from the YAML file, such as guide for plugins/SimpleDialogue/dialogues/guide.yml.
Stable Notes
- Dialogue sessions reset on plugin reload/server restart.
- YAML editing is still recommended for reviewing large trees.
- Node commands are run on the main server thread, including when triggered through FancyNpcs.
Links
- Source:
- Issues:
- Documentation:
- Release:
- License: MIT
Version Channel Text
v1.0.0 is the first stable release. It includes YAML dialogue trees, left/right branching, next intro nodes, node commands, /sd validate, complete server-command editing, FancyNpcs simple_dialogue actions, console-command fallback, and thread-safe node command execution from FancyNpcs clicks.
Manual Version Checklist
- Version name:
v1.0.0
- Channel:
Release
- Platform: Paper
- Platform versions:
26.1.2
- File:
simple-dialogue-1.0.0.jar
- External release URL:
https://github.com/Kcajpanda/simple_dialogue/releases/tag/v1.0.0
- Dependency: FancyNpcs, required
- Save/publish the version, then check the public
/versions page while logged out or in a private window.
评论 0
登录后参与评分
还没有评论,来抢沙发吧