Discord-support

插件

· 作者 Valival

Minecraft 与 Discord 之间的网关,用于支持系统

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

最新 2.1.0 · 1.21.11 · Paper

一键开服(送7天)

? DiscordSupport v2.0

最完整且专业的 Discord/Minecraft 支持系统

通过互动式 Discord 工单、私有频道和即时双向通信,提升你的服务器支持体验!


✨ 主要功能

? 两种工单模式

? 公共工单

  • 所有工单集中在一个 Discord 频道中
  • 适合小型服务器
  • 配置极其简单

? 私有工单 ⭐ 新增!

  • 每个工单拥有专用的 Discord 频道
  • 仅工作人员可见(基于角色权限)
  • 关闭后自动删除
  • 私密且安全的沟通方式

? 双向通信

Discord → Minecraft

  • 工作人员在 Discord 中的消息直接发送给游戏内的玩家
  • “发送消息”按钮,带有集成弹窗
  • 支持长消息(500 个字符)

Minecraft → Discord

  • 使用 /commandsend <message> 从游戏中回复
  • 仅在存在活跃工单时有效
  • 格式化并带时间戳的消息

? 互动按钮

点击即可立即执行操作:

  • ? TP Spawn - 传送玩家到出生点
  • ?️ Clear Inventory - 清空物品栏
  • ❤️ Heal - 恢复生命值和饥饿值
  • ? Give Food - 立即给予 64 个牛排
  • ? Moderator Arriving - 通知玩家工作人员正在赶来
  • ? Ban Player - 带确认和理由的封禁
  • ? Send Message - 自定义消息弹窗
  • ? Close Ticket - 归档/删除工单

所有操作均为临时显示:只有点击者能看到确认信息!

? 多语言支持

  • ?? English (complete version)

? 截图

Private Discord Ticket

Private Ticket 带有操作按钮的自动私有频道

Real-Time Communication

Messages 工作人员 ↔ 玩家即时通讯


⚡ 快速安装

1️⃣ 创建 Discord Bot

  1. 访问
  2. 创建应用程序 → Bot
  3. 复制 Token
  4. 重要:在“Bot”设置中启用以下意图:
    • ✅ MESSAGE CONTENT INTENT
    • ✅ SERVER MEMBERS INTENT
  5. OAuth2 → URL Generator:
    • 勾选 bot 和 applications.commands
    • 权限:查看频道、发送消息、管理频道、管理权限
  6. 邀请 Bot 到你的服务器

2️⃣ 安装插件

  1. 下载 DiscordSupport-v2.0.jar
  2. 放入 /plugins/ 目录
  3. 重启服务器
  4. 编辑 plugins/DiscordSupport/config.yml
  5. 运行 /supportreload

3️⃣ 最小化配置

公共工单(简单):

discord:
  bot-token: "YOUR_TOKEN_HERE"
  public-tickets:
    enabled: true
    channel-id: "123456789012345678"  # 你的 #support 频道 ID

私有工单(推荐):

discord:
  bot-token: "YOUR_TOKEN_HERE"
  private-tickets:
    enabled: true
    category-id: "123456789012345678"  # 你的分类 ID
    allowed-roles: "987654321098765432,111222333444555666"  # 工作人员、管理员
    delete-on-close: true

? 命令

命令 描述 权限
/support <problem> 创建工单 discordsupport.use
/commandsend <message> 回复支持请求 discordsupport.use
/supportreload 重载配置 discordsupport.admin
/supportsend <test> 测试连接 discordsupport.admin

? 高级配置

自定义按钮

action-buttons:
  teleport-spawn:
    enabled: true
    label: "? TP Spawn"
    command: "tp %player% 0 100 0"
  
  heal-player:
    enabled: true
    label: "❤️ Heal"
    command: "heal %player%"

防刷屏冷却

cooldown:
  enabled: true
  time: 60  # 每次工单之间的秒数

自定义消息

messages:
  support-sent: "&a&l✔ &aTicket sent successfully!"
  no-active-ticket: "&c&l✘ &cYou don't have an active ticket."

? 使用示例

玩家创建工单

Player: /support I'm stuck in a wall

Discord - 创建私有频道

? New Support Ticket

Player: Valival_
UUID: 123e4567-e89b-12d3-a456-426614174000
Problem: I'm stuck in a wall
Location: X: 150, Y: 64, Z: -230 (world)
Time: 18:30:42

[Buttons] ? TP Spawn | ?️ Clear | ❤️ Heal | ? Food | ? Message | ? Arriving | ? Ban | ? Close

工作人员回复

Staff (Discord): Clicks "Send Message"
→ Popup: "I'll teleport you to spawn"
Player (Minecraft): Receives "[Support] I'll teleport you to spawn"

工作人员点击“TP Spawn”

Player: [Teleported to spawn]
Staff sees (only them): "✅ Action TP Spawn executed for Valival_"

玩家回复

Player: /commandsend Thanks, it's fixed!
Discord: "? Message from Valival_: Thanks, it's fixed!"

工作人员关闭工单

Staff: Clicks "Close Ticket"
Player: Receives "Your ticket has been closed"
Discord Channel: Deleted after 5 seconds

?️ 安全与性能

✅ 线程安全 - 使用 ConcurrentHashMap
✅ 异步处理 - 无服务器卡顿
✅ Discord 权限 - 基于角色的访问控制
✅ 防刷屏 - 可配置的冷却时间
✅ 完整日志 - 追踪所有操作
✅ 验证机制 - Bot 状态验证


? 兼容性

  • Minecraft: 1.20.5 - 1.21.4+
  • Server: Paper, Spigot, Purpur
  • Java: 17+
  • Discord: JDA 5.0 (included)

? 下载

French Version: Configuration and messages in French
English Version: Configuration and messages in English

Both versions are 100% functional and identical in terms of features.


? 支持与联系

  • ? Bugs: Use the "Issues" tab on Modrinth
  • ? Suggestions: Share your ideas!
  • ⭐ Reviews: Leave a review if you like the plugin

? Changelog v2.0

主要新功能:

  • ✨ 带有专用频道的私有票务系统
  • ? Discord ↔ Minecraft 双向通信
  • ? “管理员即将到达”按钮,用于通知玩家
  • ? “封禁”按钮,支持确认和填写原因
  • ? 完整的法语/英语支持
  • ⚡ 异步初始化(无卡顿)
  • ?️ 创建前验证机器人状态

改进项:

  • 临时消息(仅点击者可见)
  • 改进了错误处理
  • 更清晰、信息更丰富的日志
  • 完整的文档

修复项:

  • 修复了初始化期间的服务器卡死问题
  • 修复了“公会没有自成员 (self member)”的问题
  • 修复了 Discord Intents 的处理逻辑

? 为什么选择 DiscordSupport?

之前

玩家:“我被卡住了!”
→ 工作人员必须进入游戏
→ 浪费时间
→ 玩家需要等待很长时间

使用 DiscordSupport 后

玩家:/support I'm stuck
→ 即时生成 Discord 工单
→ 工作人员查看位置、问题和信息
→ 点击“传送至出生点”
→ 玩家在 2 秒内被传送
→ 问题解决!

节省时间:90%
玩家满意度:+200%
员工开心:无价 ?


? 许可证

MIT 许可证 - 可免费使用和修改


由 Valival_ ❤️ 制作

如果此插件对您有帮助,请留下 ⭐ 评论!

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源