ADialogAPI

插件

· 作者 arkadarktime

一个灵活的对话框 API,适用于 Minecraft 插件,支持可配置的按钮和操作。

0 本站下载 0 关注 更新于 8 个月前

最新 1.0.2 · 1.21.11 · Paper / Purpur

一键开服(送7天)

ADialogAPI

ADialogAPI 是一个现代化、高性能的 Minecraft 服务器交互式对话系统。它允许你使用简单的 YAML 或强大的 Java API 创建沉浸式的 RPG 风格对话、复杂的菜单和用户输入表单。


✨ 功能特性

  • MiniMessage 集成: 完全支持现代格式化(RGB、渐变、悬停/点击事件)。
  • 动作系统: 直接从对话按钮触发命令、音效、标题、药水效果和物品栏变更。
  • 动态输入: 通过对话界面捕获玩家输入,并将其用于命令或消息中。
  • 冷却支持: 防止对话刷屏,可在配置文件中定义每个玩家的冷却时间。
  • 开发者 API: 提供自定义事件以处理打开、点击和关闭对话框,从而构建复杂逻辑。

? 快速开始(管理员)

1. 安装

  1. 从 Modrinth 下载最新的 .jar 文件。
  2. 将其放入服务器的 plugins 文件夹中。
  3. 重启服务器。

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。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源