DiscordStatus

插件

· 作者 Sh4dowking

一个轻量级的 Minecraft 插件,允许你通过专用的 Discord Bot 直接在 Discord 上显示和监控你的 Minecraft 服务器状态。

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

最新 1.3.0 · 1.21.11 · Paper / Purpur

一键开服(送7天)

说明

DiscordStatus 是一款轻量级的 Minecraft 服务器插件,可将您游戏内服务器活动与您的 Discord 社区连接起来。它专为希望获得可靠且始终更新的 Discord 状态存在(presence),而无需手动发布更新的服务器所有者设计。

该插件将专用的 Discord 状态消息与您的服务器状态保持同步,以便玩家能立即看到服务器是处于在线还是离线状态。它还会报告玩家活动事件,使 Discord 成为您 Minecraft 服务器的实用配套空间。

核心功能

  • 在 Discord 嵌入卡片中实时显示服务器在线/离线状态。
  • 自动在 Discord 中发送玩家加入和离开通知。
  • 可自定义在线和离线状态文本,包括:
    • 状态标题
    • 状态描述
    • 嵌入颜色
  • 可配置的嵌入部分,让每个服务器可以选择显示哪些内容:
    • 描述
    • 服务器图标缩略图
    • MOTD(每日公告)
    • 在线玩家数量
    • 玩家列表
    • 服务器版本
  • 基于斜杠命令的管理方式,用于设置状态文本、颜色和开关,允许快速更新而无需频繁编辑文件。

为服务器所有者带来的便利

  • 即使玩家不在游戏内,也能让他们实时了解社区动态。
  • 减少 Discord 中重复的人工公告工作。
  • 向玩家展示清晰且专业的服务器状态面板。
  • 根据服务器风格和隐私偏好,精确定制可见的状态详情。
  • 通过命令和配置快速管理展示效果和行为。

安装

安装插件 jar 包

  1. 从 Modrinth 下载最新版本。
  2. 将 DiscordStatus.jar 文件放入服务器的 plugins 文件夹中。
  3. 启动服务器一次以生成 plugins/DiscordStatus/config.yml。

创建 Discord 应用程序和机器人

  1. 打开 Discord 开发者门户:
  2. 点击“新建应用程序”并输入名称(例如 Status Bot)。
  3. 此时您应该处于可以配置应用程序的页面;如果不是,请点击刚才创建的应用程序。
  4. 转到左侧的“Bot”部分。
  5. 在 Token 下方,点击“重置令牌”(或“复制令牌”),然后将令牌粘贴到 plugins/DiscordStatus/config.yml 中 discordToken 的值里。
  6. 在同一应用程序的左侧导航中,进入 OAuth2 > OAuth2 URL Generator(OAuth2 URL 生成器)。
  7. 在 Scopes(作用域)下,选择:
    • bot
    • applications.commands
  8. 在 Bot Permissions(机器人权限)下,至少选择:
    • View Channels(查看频道)
    • Send Messages(发送消息)
    • Embed Links(嵌入链接)
    • Read Message History(读取消息历史)
    • Manage Messages(管理消息,用于刷新/替换状态消息时使用)
  9. 页面底部会生成一个 URL。打开生成的 URL 并将机器人邀请到您的服务器。

在 Discord 中启用开发者模式(用于复制 ID)

  1. 打开 Discord 设置。
  2. 进入 Advanced(高级)。
  3. 启用 Developer Mode(开发者模式)。

启用开发者模式后,右键点击并使用“复制服务器 ID”、“复制频道 ID”或“复制消息 ID”来填写 plugins/DiscordStatus/config.yml 中剩余的值。

  • discordServerID:右键点击您的服务器图标 > 复制服务器 ID
  • updatesChannelID:右键点击您的更新频道 > 复制频道 ID
  • statusChannelID:右键点击您的状态频道 > 复制频道 ID
  • statusMessageID:
    • 首次运行时可选
    • 您可以留空,让插件自动创建/存储它
    • 如果稍后需要,右键点击状态消息 > 复制消息 ID

提示:如果您愿意,updatesChannelID 和 statusChannelID 可以是同一个频道。

最后步骤

  1. 配置 plugins/DiscordStatus/config.yml 的其余部分(默认文件模板见下文)。
  2. 重启 Minecraft 服务器以使更改生效。
  3. 享受这款 Minecraft 插件吧 :)

配置

默认 config.yml:

discordToken: "YOUR_BOT_TOKEN"
discordServerID: "YOUR_DISCORD_SERVER_ID"
updatesChannelID: "YOUR_DISCORD_CHANNEL_ID"
statusChannelID: "YOUR_STATUS_CHANNEL_ID"
statusMessageID: "YOUR_STATUS_MESSAGE_ID"

sendJoinMessage: true
sendLeaveMessage: true
joinMessage: "`{player}` joined the Server!"
leaveMessage: "`{player}` left the Server!"

statusMessageTitleOnline: "? Server is Online"
statusMessageDescriptionOnline: "The Minecraft server is currently online and operational."
statusColorOnline: "#00FF00"

statusMessageTitleOffline: "? Server is Offline"
statusMessageDescriptionOffline: "The Minecraft server is currently offline, please check again later."
statusColorOffline: "#FF0000"

showDescription: true
showServerIcon: true
showMotd: true
showPlayersOnline: true
showPlayerList: true
showServerVersion: true

phraseMessageOfTheDay: "Message of the Day"
phrasePlayersOnline: "Players Online"
phrasePlayerList: "Player List"
phraseNoPlayersOnline: "No players online."
phraseServerVersion: "Server Version"
phraseStatusUpdated: "Status Updated"

注意事项:

  • statusColorOnline 和 statusColorOffline 必须使用 #RRGGBB 格式。
  • statusMessageID 可以留空,插件会自动创建/更新它。

如果您喜欢这个项目,请考虑在 GitHub 上给它一个 Star!您的支持对我意义重大,也激励我继续构建和改进此类项目! :)

~ Sh4dowking

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源