Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for kaydnn

Link Discord and Minecraft accounts and run a built-in Discord bot for your SMP

Report SMPLink?

Link your players' Discord and Minecraft accounts, and run your SMP's Discord bot from inside the plugin. No separate bot hosting, no extra services: drop in the jar, add a bot token, done.

Features

🔗 Account linking

Players run /link in game and get a short code, then enter it with /link on Discord. Linked members get a role and can have their nickname set to their Minecraft name. Prefer a sign-up sheet? Links can come from a Google Sheet instead.

📊 Profiles and leaderboards

  • /profile: a player's stats card (kills, deaths, playtime, blocks mined, distance walked, trade rep)
  • /playtime: progress towards the weekly playtime quota
  • /leaderboard: all time, monthly or weekly, with page buttons
  • /inv: a picture of a player's inventory, armor and ender chest (staff only)

⏱️ Activity checks

Set a weekly playtime quota. Members under it get a DM with a deadline; miss it and they get a strike. Strikes expire, and reaching the limit removes the member. Staff can pause checks, give or take back strikes, and see everyone's progress with /warnings. Exempt roles are never checked.

📝 Join applications

Post an Apply to join panel. Applicants fill in a form, and staff get a card with Accept (whitelists them automatically), Deny (with a reason) and Ask a question (opens a private thread).

🤝 Trade board

/trade posts an offer with a villager-style picture of the items. Interested players get a private negotiation thread, trades can have a middleman, and players vouch for or report each other afterwards. Their trade rep shows on their profile.

🏆 Milestones and recaps

Announce playtime milestones (24, 50, 100, 200 hours, or your own) with optional reward roles, and post a weekly recap of the most active players.

💥 Crash recovery

SMPLink snapshots online players every few seconds. If the server crashes, staff get a restore card for every player who lost items. A health monitor warns staff about low memory or TPS before it gets that far.

🔒 Join lock

/joinlock until 2026-12-01 18:00 keeps everyone but staff out until opening time, then opens by itself.

Setup

  1. Put the jar in plugins/ and start the server once.
  2. Create a bot in the Discord Developer Portal, then paste its token and your Discord server's ID into plugins/SMPLink/config.yml.
  3. Invite the bot with the bot and applications.commands scopes.
  4. Set your admin role and the channels you want. Any feature without a channel stays off.
  5. Restart.

Full setup guide and every command: README on GitHub

Item icons: Minecraft's textures can't be bundled in an open-source plugin. Add your own item pictures to plugins/SMPLink/icons/ (named like diamond_sword.png). Without them, items show as placeholder squares.

Requirements

  • Paper 1.21.1+ (or Purpur), Java 21
  • A Discord bot. No privileged intents needed.

Open source

SMPLink is MIT licensed. Bug reports, ideas and pull requests are welcome on GitHub.

Information

Category
Admin Tools
Published
November 21, 2026
License
MIT
0Downloads
0Stars

Members

1