? AetherLink: 完整的 Discord ↔ Minecraft 桥接插件
让你的服务器实时接入 Discord。聊天、控制台、事件、经济系统和 Moderation(管理),一个插件全搞定。
AetherLink 通过单个机器人将你的 Paper 或 Folia 服务器与 Discord 连接。它涵盖实时状态、双向聊天、控制台访问、事件推送、管理员斜杠命令、抽奖活动和安全的账号绑定,且所有功能均可配置。
✨ 功能特性
? 实时状态仪表盘
- 一个嵌入卡片就地自动编辑,默认每 3 秒刷新一次。绝不会刷屏你的频道。
- ? 在线 / ? 离线 指示器,并配有匹配的嵌入颜色
- 在线玩家数(可选显示玩家列表)、TPS、MSPT、延迟、服务器版本以及你的真实服务器图标
- 机器人自身的 Discord 状态会显示实时玩家数量
- 可开启或关闭每个字段,并可更改颜色和刷新率
? 双向聊天桥接
- Minecraft 聊天内容会同步到 Discord,Discord 的消息也会显示在游戏中
- 消息通过 Webhook 发送,因此每条消息都会显示玩家的真实皮肤头像和名字
- 可自定义格式和频道
?️ 控制台桥接
- 实时服务器控制台输出流式传输到 Discord 频道
- 输出内容会被批量处理并进行速率限制,以符合 Discord 的限制要求
- 可直接从 Discord 运行控制台命令,仅限你指定的角色使用
? 事件推送
- 加入/离开 嵌入卡片,包含玩家头像和当前在线人数
- 死亡和进度达成有独立的频道,也可以合并到一个频道中
- 完全可编辑的消息模板(支持 MiniMessage)
? 安全的账号绑定
- 在游戏中运行
/connect,然后 DM(私聊)机器人 并运行 /link <code>
- 验证码为单次使用,过期时间短且生成过程安全
- 每个 Discord 账号仅对应一个 Minecraft 账号,并设有尝试次数限制
- 随时可通过
/unlink 解绑
- 绑定仅用于证明身份。命令权限仍会单独检查。
? 经济系统集成
- 兼容 Vault 和 MarketCore
- 提供
/balance、/pay、/daily-reward,以及管理员专用的 /addmoney 和 /removemoney
/shop 和 /auction 会在 Discord 中显示 MarketCore 的实时商品列表
- 自动检测你的经济系统提供商,即使其加载较晚也能识别
/aetherlink debug economy 可查看已挂钩的经济系统提供商
? 抽奖活动
- 在 Discord 中创建抽奖活动,设置奖品、中奖人数和持续时间
- 基于按钮参与,带有实时参与人数计数器
- 首先 @通知中奖者,随后发布一条公告嵌入卡片
- 可通过嵌入页脚显示的 ID 结束、编辑或重新抽取任何抽奖活动
?️ 来自 Discord 的管理功能
- 封禁、解封、临时封禁、踢出玩家以及查看封禁列表
- 传送玩家、检查坐标以及查询详细的玩家信息
- 向服务器广播消息和发送自定义嵌入卡片
- 所有操作均记录在审计日志中
? 精美的嵌入卡片
- 机器人的每条回复都是嵌入卡片,配色方案一致:绿色表示成功,红色表示错误,蓝紫色表示信息,金色表示抽奖活动
- 针对特定玩家的嵌入卡片会显示实际的皮肤头像
- 丰富的
/playerinfo 显示游戏时长、余额、在线状态、上次上线时间和绑定的 Discord 账号
⚙️ 全面配置
- 每个频道、命令和状态字段都可以独立启用或禁用
- 每个命令都有角色要求
- 可编辑
messages.yml
- 运行
/aetherlink reload 即可应用更改,无需重启服务器
? Discord 斜杠命令
| 命令 |
描述 |
/balance [player] |
查看余额 |
/pay <player> <amount> |
转账 |
/daily-reward |
领取每日奖励 |
/shop |
浏览商店商品 |
/auction |
浏览拍卖行 |
/addmoney <player> <amount> |
管理员:添加货币 |
/removemoney <player> <amount> |
管理员:移除货币 |
/playerinfo <player> |
查看详细玩家卡片 |
/whoami |
显示你绑定的 Minecraft 账号 |
/position <player> |
显示玩家的坐标 |
/tp <player> <target> |
传送玩家 |
/ban /unban /tempban /kick |
管理操作 |
/banlist |
查看被封禁的玩家 |
/serverinfo |
服务器统计信息 |
/broadcast <message> |
在游戏内广播 |
/embed |
编写自定义嵌入卡片 |
/execute <command> |
运行控制台命令(需指定角色) |
/giveaway-create |
开始抽奖活动 |
/giveaway-end <id> |
立即结束抽奖活动 |
/giveaway-edit <id> |
编辑进行中的抽奖活动 |
/giveaway-reroll <id> |
重新抽取中奖者 |
/marketcore |
获取 MarketCore 下载链接 |
/link <code> |
绑定你的账号(需在 DM 中) |
? 游戏内命令
| 命令 |
描述 |
/connect |
生成绑定验证码 |
/link |
/connect 的别名 |
/unlink |
解绑你的 Discord 账号 |
/aetherlink reload |
重新加载配置 |
/aetherlink status |
检查桥接健康状态 |
/aetherlink debug economy |
诊断经济系统挂钩情况 |
别名:/al
? 权限节点
| 节点 |
描述 |
默认值 |
aetherlink.link |
绑定和解绑 Discord 账号 |
true |
aetherlink.admin |
访问 /aetherlink 管理员命令 |
op |
Discord 命令的访问权限由你在 config.yml 中为每个命令设置的 Role ID 控制。
⚙️ 依赖要求
- Paper 或 Folia,1.21 至 26.2+
- Java 21+
- 具有所需 Intents 的 Discord 机器人令牌 (Bot Token)
- Vault 和/或 MarketCore (可选,用于经济系统功能)
? 快速上手
- 将
AetherLink.jar 放入 plugins/ 目录并启动服务器一次。
- 创建一个 Discord 机器人并将其邀请到你的服务器。
- 将机器人令牌和你的频道 ID 粘贴到
config.yml 中。
- 运行
/aetherlink reload,你的状态嵌入卡片就会出现。
? 与 MarketCore 完美搭配,打造完整的游戏内经济、商店和拍卖行设置,并可通过 Discord 进行管理。
? 发现 Bug 或有新功能建议?请留下评论或提交 Issue。
? AetherLink: Complete Discord ↔ Minecraft Bridge
Your server, live on Discord. Chat, console, events, economy and moderation in one plugin.
AetherLink connects your Paper or Folia server to Discord with a single bot. It covers live status, two-way chat, console access, event feeds, admin slash commands, giveaways and secure account linking, and every part of it is configurable.
✨ Features
? Live Status Dashboard
- One embed that edits itself in place, refreshing every 3 seconds by default. It never spams your channel.
- ? Online / ? Offline indicator with a matching embed color
- Players online (with an optional player list), TPS, MSPT, ping, server version and your real server icon
- The bot's own Discord presence shows the live player count
- Toggle every field on or off and change the colors and refresh rate
? Two-Way Chat Bridge
- Minecraft chat appears in Discord, and Discord messages appear in-game
- Messages are sent through a webhook, so each one shows the player's real skin head and name
- Configurable formats and channel
?️ Console Bridge
- Live server console output streamed to a Discord channel
- Output is batched and rate-limited to stay inside Discord's limits
- Run console commands straight from Discord, restricted to the role you choose
? Event Feeds
- Join / Leave embeds with player heads and the current online count
- Deaths and Advancements in their own channels, or merged into one
- Fully editable message templates (MiniMessage supported)
? Secure Account Linking
- Run
/connect in-game, then DM the bot and run /link <code>
- Codes are single-use, expire quickly and are generated securely
- One Minecraft account per Discord account, with attempt limiting
- Unlink at any time with
/unlink
- Linking only proves identity. Command permissions are still checked separately.
? Economy Integration
- Works with Vault and with MarketCore
/balance, /pay, /daily-reward, plus admin /addmoney and /removemoney
/shop and /auction show live MarketCore listings in Discord
- Detects your economy provider automatically, even if it loads late
/aetherlink debug economy shows which provider is hooked
? Giveaways
- Create giveaways from Discord with a prize, winner count and duration
- Button-based entry with a live entry counter
- Winners are pinged first, then an announcement embed follows
- End, edit or reroll any giveaway by its ID, shown in the embed footer
?️ Moderation From Discord
- Ban, unban, tempban, kick and view the ban list
- Teleport players, check coordinates and look up detailed player info
- Broadcast to the server and send custom embeds
- Actions are written to an audit log
? Polished Embeds
- Every bot response is an embed with a consistent color scheme: green for success, red for errors, blurple for info and gold for giveaways
- Player-specific embeds show the actual skin head
- Rich
/playerinfo shows playtime, balance, online state, last seen and linked Discord account
⚙️ Total Configuration
- Every channel, command and status field can be enabled or disabled on its own
- Per-command role requirements
- Editable
messages.yml
/aetherlink reload applies changes without a restart
? Discord Slash Commands
| Command |
Description |
/balance [player] |
Check a balance |
/pay <player> <amount> |
Send money |
/daily-reward |
Claim your daily reward |
/shop |
Browse shop listings |
/auction |
Browse the auction house |
/addmoney <player> <amount> |
Admin: add money |
/removemoney <player> <amount> |
Admin: remove money |
/playerinfo <player> |
Detailed player card |
/whoami |
Show your linked Minecraft account |
/position <player> |
Show a player's coordinates |
/tp <player> <target> |
Teleport a player |
/ban /unban /tempban /kick |
Moderation |
/banlist |
View banned players |
/serverinfo |
Server stats |
/broadcast <message> |
Announce in-game |
/embed |
Compose a custom embed |
/execute <command> |
Run a console command (role-gated) |
/giveaway-create |
Start a giveaway |
/giveaway-end <id> |
End a giveaway now |
/giveaway-edit <id> |
Edit a running giveaway |
/giveaway-reroll <id> |
Pick new winners |
/marketcore |
Get the MarketCore download link |
/link <code> |
Link your account (in DMs) |
? In-Game Commands
| Command |
Description |
/connect |
Generate a linking code |
/link |
Alias of /connect |
/unlink |
Unlink your Discord account |
/aetherlink reload |
Reload configuration |
/aetherlink status |
Check bridge health |
/aetherlink debug economy |
Diagnose economy hooks |
Alias: /al
? Permissions
| Node |
Description |
Default |
aetherlink.link |
Link and unlink a Discord account |
true |
aetherlink.admin |
Access to /aetherlink admin commands |
op |
Discord command access is controlled by the role IDs you set per command in config.yml.
⚙️ Requirements
- Paper or Folia, 1.21 to 26.2+
- Java 21+
- A Discord bot token with the needed intents
- Vault and/or MarketCore (optional, for economy features)
? Quick Setup
- Drop
AetherLink.jar into plugins/ and start the server once.
- Create a Discord bot and invite it to your server.
- Paste the bot token and your channel IDs into
config.yml.
- Run
/aetherlink reload and your status embed appears.
? Pairs perfectly with MarketCore for a full economy, shop and auction setup that you can manage from Discord.
? Found a bug or want a feature? Leave a comment or open an issue.
评论 0
登录后参与评分
还没有评论,来抢沙发吧