ADialogAPI
ADialogAPI 是一个现代化、高性能的 Minecraft 服务器交互式对话系统。它允许你使用简单的 YAML 或强大的 Java API 创建沉浸式的 RPG 风格对话、复杂的菜单和用户输入表单。
✨ 功能特性
- MiniMessage 集成: 完全支持现代格式化(RGB、渐变、悬停/点击事件)。
- 动作系统: 直接从对话按钮触发命令、音效、标题、药水效果和物品栏变更。
- 动态输入: 通过对话界面捕获玩家输入,并将其用于命令或消息中。
- 冷却支持: 防止对话刷屏,可在配置文件中定义每个玩家的冷却时间。
- 开发者 API: 提供自定义事件以处理打开、点击和关闭对话框,从而构建复杂逻辑。
? 快速开始(管理员)
1. 安装
- 从 Modrinth 下载最新的
.jar文件。 - 将其放入服务器的
plugins文件夹中。 - 重启服务器。
2. 配置示例
对话框存储在 dialogs/ 文件夹中。
基础对话框 YAML 示例
# ─────────────────────────────────────────────
# 对话框:通知示例
# 一个简单的信息窗口,带有一个“确定”按钮。
# 推荐用于公告、提示或欢迎信息。
# ─────────────────────────────────────────────
# 显示在对话框窗口顶部。
title: "<gold><bold>✦ 欢迎来到服务器!"
# true - 玩家可以按 ESC 键关闭对话框。
# false - 玩家必须点击“确定”按钮才能关闭。
can_close_with_escape: false
# 同一玩家再次打开此对话框前需要等待的秒数。
# 0 = 无冷却(默认值)。
cooldown: 0
# 对话框类型:
# - notice: 单个“确定”按钮
# - confirmation: “是”/“否”按钮
type: notice
# 可选:注册一个打开此对话框的命令。
# 留空 ("") 则跳过。
open_command: "welcome"
# 可选:使用 open_command 所需的权限。
# 留空 ("") 则允许所有玩家使用。
open_permission: ""
body:
# 对话框中的简单文本行。
- type: text
content: "<gray>你好,旅人!很高兴见到你。"
# 用作间距的空文本。
- type: text
content: ""
- type: text
content: "<yellow>探索、建造并享受乐趣吧!"
? 开发者 API(即将推出)
事件
监听自定义事件以将 ADialogAPI 与你的系统集成:
DialogOpenEvent: 当对话框即将打开时触发(可取消)。DialogButtonClickEvent: 捕获按钮点击及任何相关的用户输入。DialogCloseEvent: 当对话框关闭时触发(支持原因如 ESCAPE 或 PLUGIN)。
访问管理器
你可以通过 DialogManager 打开对话框:
ADialogAPI.getApi().showDialog(player, "dialog_id");
? 命令与权限
主命令为 /adialogapi(别名:/adapi)。
| 命令 | 描述 | 权限 |
|---|---|---|
/adialogapi help |
查看所有可用命令 | adialogapi.command.help |
/adialogapi show <id> [player] |
为自己或其他玩家打开对话框 | adialogapi.command.show |
/adialogapi list |
列出所有已加载的对话框 | adialogapi.command.list |
/adialogapi reload [id] |
重新加载所有或特定对话框 | adialogapi.command.reload |
/adialogapi create <id> |
创建新的对话框模板 | adialogapi.command.create |
/adialogapi delete <id> |
移除现有对话框 | adialogapi.command.delete |
/adialogapi info <id> |
查看对话框的详细信息 | adialogapi.command.info |
? 支持
- 问题反馈: 通过 GitHub Issues 报告错误或请求新功能。
- 讨论区: 在 Discussions 标签页中提问并分享你的配置。
- Discord 服务器: 我的官方 Discord 服务器,用于支持、错误报告和娱乐 - ArkaDarkTime Hub
⚖️ 许可证
本软件基于 GNU GPL v3 许可证 分发。详情请参阅 LICENSE。
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
27
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
可自定义玩家模型
tom5454
自定义你的Minecraft头像!
装饰社交
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
Vivecraft Spigot Extension
fayer3
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
前置实用
12
评论 0
登录后参与评分
还没有评论,来抢沙发吧