AuryxDiscord

插件

· 作者 Sqrilizz

轻量级的 Minecraft-Discord 集成,无需 JDA。支持双向聊天同步、服务器事件、Webhook、嵌入消息和 HTTP 服务器。作为重型 Discord 机器人的现代替代方案,并集成了 AuryxCore。

0 本站下载 0 关注 更新于 1 年前

需要前置:AuryxCore

最新 1.0.0-SNAPSHOT · 1.21.10 · Bukkit / Folia

一键开服(送7天)

? AuryxDiscord - 轻量级 Minecraft-Discord 集成

AuryxDiscord 是一款轻量级、高性能的 Minecraft-Discord 集成插件,构建时未使用 JDA。它利用现代 HTTP 客户端(OkHttp + Jetty),以极低的资源消耗在您的 Minecraft 服务器和 Discord 之间提供无缝的双向通信。


✨ 主要特性

? 双向通信

  • Minecraft → Discord - 通过 Webhook 发送聊天消息、事件和通知
  • Discord → Minecraft - Discord 中的消息通过 HTTP 服务器显示在游戏中
  • 实时同步 - 异步处理实现即时消息传递
  • 无 JDA 依赖 - 仅基于 HTTP 的轻量级实现

? 服务器事件集成

  • 加入/离开消息 - 玩家连接通知,支持自定义格式
  • 死亡消息 - 带有死因和自定义格式的死亡通知
  • 聊天同步 - 完整的聊天集成,支持 AuryxChat
  • 处罚警报 - 封禁/静音/踢出通知,供管理团队使用
  • 服务器状态 - 启动/关闭通知

? 丰富的格式与自定义

  • Discord Embeds - 带有颜色和时间的精美富文本消息
  • 玩家头像 - 通过 Minotar 自动集成玩家头颅
  • 自定义格式 - 每种事件类型均可完全自定义的消息模板
  • 占位符支持 - PlaceholderAPI 和 AuryxCore 占位符集成
  • 表情符号支持 - ? 加入, ? 离开, ☠️ 死亡, ⚠️ 处罚

? 高级配置

  • 多个 Webhook - 为聊天、日志、死亡、处罚分别设置独立频道
  • 事件过滤 - 启用/禁用特定事件类型
  • 消息队列 - 可配置的队列限制以防止刷屏
  • HTTP 服务器 - 内置 Jetty 服务器用于 Discord → MC 通信

? 命令概览

命令 描述 权限
/auryxdiscord 插件主命令 auryxdiscord.admin
/auryxdiscord reload 重载配置 auryxdiscord.reload
/auryxdiscord test [message] 向 Discord 发送测试消息 auryxdiscord.test
/auryxdiscord info 查看插件状态和集成信息 auryxdiscord.info

? 工作原理

Minecraft → Discord 流程

  1. 事件检测 - 监听器捕获聊天、加入/离开、死亡事件
  2. 消息格式化 - 应用带有占位符的自定义模板
  3. Webhook 发送 - 通过 OkHttp 发送到 Discord Webhook URL
  4. 队列管理 - 异步处理防止服务器卡顿

Discord → Minecraft 流程

  1. HTTP 服务器 - 内置 Jetty 服务器接收 Discord Webhook
  2. 消息处理 - 解析并验证传入的 Discord 消息
  3. 聊天集成 - 转发到 AuryxChat 或直接广播
  4. 安全性 - Webhook 签名验证以确保安全

? 消息示例

Discord 通知

? **Sqrilizz** joined the server (Players: 5/20)
[MC] Sqrilizz: Hello everyone from Minecraft!
☠️ Sqrilizz was slain by Zombie
⚠️ **Admin** banned **Griefer**: Griefing spawn area
✅ **Server started** - Players can now join!

Minecraft 聊天

[Discord] DiscordUser: Hello from Discord!
[Discord] Moderator: Server restart in 5 minutes

⚙️ 配置亮点

Webhook 设置 (config.yml)

webhooks:
  chat: "https://discord.com/api/webhooks/YOUR_CHAT_WEBHOOK"
  log: "https://discord.com/api/webhooks/YOUR_LOG_WEBHOOK"
  death: "https://discord.com/api/webhooks/YOUR_DEATH_WEBHOOK"
  punishment: "https://discord.com/api/webhooks/YOUR_MOD_WEBHOOK"

事件配置

events:
  join-leave: true
  deaths: true
  punishments: true
  console: false
  startup-shutdown: true

消息格式

formats:
  join: "? **{player}** joined the server (Players: {online}/{max})"
  leave: "? **{player}** left the server"
  death: "☠️ {death_message}"
  ban: "⚠️ **{staff}** banned **{player}**: {reason}"

HTTP 服务器 (Discord → MC)

server:
  enabled: true
  port: 8080
  path: "/discord-webhook"
  secret: "your-webhook-secret"

? 平台兼容性

平台 状态 功能
Paper ✅ 完全支持 所有功能可用
Folia ✅ 完全支持 线程安全实现
Spigot ✅ 兼容 核心功能正常
Bukkit ✅ 兼容 基本功能
Purpur ✅ 增强版 额外优化
Velocity ✅ 支持 跨服务器集成

? 集成与依赖

必需依赖

可选集成

  • AuryxChat - 增强的聊天格式和模式
  • PlaceholderAPI - 扩展的占位符支持
  • AuryxLink - Discord 账号绑定(计划中)

开发者 API

// 获取 AuryxDiscord API
AuryxDiscordAPI api = AuryxDiscord.getAPI();

// 向 Discord 发送消息
api.sendChatMessage(player, "Hello Discord!");
api.sendLogMessage("Server event occurred");
api.sendEmbed("Title", "Description", "#5865F2");

// 检查集成状态
boolean enabled = api.isDiscordEnabled();
boolean chatSync = api.isChatEnabled();

? 性能与技术细节

轻量级架构

  • 无需 JDA - 使用 OkHttp 发起 HTTP 请求(更轻量)
  • 异步处理 - 所有 Discord 操作均为非阻塞式
  • 智能队列 - 消息队列可防止刷屏和速率限制
  • 内存高效 - 与基于机器人的解决方案相比,内存占用极低

HTTP 组件

  • OkHttp 客户端 - 用于向 Discord 发送现代化、高效的 HTTP 请求
  • Jetty 服务器 - 用于接收 Discord 消息的内嵌 HTTP 服务器
  • Gson JSON - 用于 Webhook 负载的快速 JSON 处理
  • 依赖阴影化 - 避免与其他插件发生冲突

跨版本支持

  • 单 JAR 文件 - 适用于 Minecraft 1.8.8 至 1.21.10
  • API 兼容性 - 适配不同的 Bukkit/Paper API 版本
  • 旧版支持 - 保持与较旧服务器版本的兼容性

? 安装指南

1. 安装

  1. 下载 AuryxCore(必需)
  2. 从 Modrinth 下载 AuryxDiscord
  3. 将两个 JAR 文件放入 plugins/ 文件夹
  4. 重启服务器

2. Discord Webhook 设置

  1. 进入你的 Discord 服务器设置
  2. 导航至 集成 → Webhooks
  3. 为不同频道创建 webhooks:
    • #minecraft-chat - 用于玩家聊天消息
    • #server-logs - 用于加入/离开/死亡事件
    • #moderation - 用于处罚通知
  4. 将 webhook URL 复制到 config.yml

3. 配置

# 基本设置 - 只需添加你的 webhook URL
webhooks:
  chat: "https://discord.com/api/webhooks/123456789/abcdefg"
  log: "https://discord.com/api/webhooks/987654321/hijklmn"

# 启用所需的事件
events:
  join-leave: true
  deaths: true
  punishments: true

# 可选:启用 Discord → Minecraft
server:
  enabled: true  # 允许 Discord 用户向 MC 发送消息
  port: 8080
  secret: "change-this-secret"

4. 测试

/auryxdiscord info     # 检查集成状态
/auryxdiscord test     # 向 Discord 发送测试消息

? 使用场景

? 角色扮演服务器

  • 为 RP 社区提供沉浸式的 Discord 集成
  • 角色死亡通知
  • 工作人员管理警报

? 生存服务器

  • 玩家活动监控
  • 社区聊天桥接
  • 成就分享

? 小游戏网络

  • 通过 Velocity 实现跨服务器公告
  • 锦标赛通知
  • 玩家统计数据共享

?️ moderated 社区

  • 实时处罚通知
  • 工作人员沟通桥梁
  • 服务器状态监控

? 高级功能

消息占位符

# 消息格式中可用的占位符:
{player}        # 玩家名称
{displayname}   # 玩家显示名称
{message}       # 聊天消息内容
{server}        # 服务器名称
{online}        # 当前在线玩家数
{max}           # 最大玩家数
{balance}       # 玩家余额 (AuryxCore)
{death_message} # 完整死亡消息
{staff}         # 工作人员名称
{reason}        # 处罚原因

# PlaceholderAPI 支持:
%player_name%           # 玩家名称
%server_online%         # 在线人数
%auryxcore_balance%     # 玩家余额
# + 1000+ 其他 PAPI 占位符

Webhook 安全性

  • 签名验证 - 验证传入的 Discord webhooks
  • 密钥 - 可配置的 webhook 密钥
  • IP 过滤 - HTTP 服务器的可选 IP 白名单
  • 速率限制 - 内置防刷屏保护

多通道设置

webhooks:
  chat: "https://discord.com/api/webhooks/chat-webhook"
  log: "https://discord.com/api/webhooks/log-webhook"
  death: "https://discord.com/api/webhooks/death-webhook"
  punishment: "https://discord.com/api/webhooks/mod-webhook"
  
# 事件自动路由到相应的频道
# 如果未配置特定 webhook,则回退到 'log' webhook

? 支持与社区


? 为什么选择 AuryxDiscord?

与传统 Discord 机器人对比:

  • ✅ 无需托管机器人 - 直接在 Minecraft 服务器上运行
  • ✅ 资源占用更低 - 无需 JDA,仅使用 HTTP 请求
  • ✅ 设置更简单 - 无需机器人令牌或权限
  • ✅ 更好的集成 - 直接访问服务器事件和数据

与其他 Discord 插件对比:

  • ✅ 现代架构 - 专为 Paper/Folia 构建,采用异步处理
  • ✅ 轻量级 - 6MB vs 基于 JDA 的插件的 20MB+
  • ✅ 双向通信 - 大多数插件仅支持 MC → Discord
  • ✅ 丰富的格式 - 嵌入卡片、头像和高级占位符

与 EssentialsX Discord 对比:

  • ✅ 更好的性能 - 异步处理和消息队列
  • ✅ 更多功能 - HTTP 服务器、多个 webhooks、嵌入卡片
  • ✅ 活跃开发 - 定期更新和新功能
  • ✅ 现代代码库 - Java 21、最新 API、整洁的架构

? 许可证

AuryxDiscord 遵循 MIT 许可证。详见 LICENSE。


由 Auryx Studio 用 ❤️ 制作

需要 AuryxCore 才能发挥全部功能。属于完整的 Auryx 服务器管理套件的一部分!


? 快速开始

  1. 安装:下载 AuryxCore + AuryxDiscord
  2. 配置:在配置文件中添加 Discord webhook URL
  3. 测试:使用 /auryxdiscord test 命令
  4. 享受:无缝的 Minecraft-Discord 集成!

今天就开始转变你的服务器通信吧! ??

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源