AetherLink

🔗 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

1. Drop AetherLink.jar into plugins/ and start the server once.
2. Create a Discord bot and invite it to your server.
3. Paste the bot token and your channel IDs into config.yml.
4. 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.