MythicLink

MythicLink

MythicLink connects your Minecraft server with Discord — securely and beautifully. It links player accounts, exposes economy and player stats, and lets players use safe, server-approved commands from Discord.

Key Features

• 🔗 Account Linking: Secure one-time link codes, conflict protection, unlink support
• 💰 Economy Tools: Check balance, pay players, transaction history, baltop parsing
• 📊 Player Insights: Playtime, joins, last seen, online player list, player search
• 🛡️ Production-Grade Security: Command whitelist, input validation, SQL protection, rate limiting
• ⚙️ Admin Friendly: Optional single-channel enforcement, configurable templates/prefix, embedded or standalone bot

Why MythicLink?

• Safe by default: Strict validation, anti-injection protections, database constraints
• Beautiful UX: Clean embeds, paginated summaries, helpful guidance
• Lightweight: SQLite storage, Vault economy integration, Paper API

Commands

• Slash: /link <code>, /stats, /transactions [limit], /economystats, /playersearch <name>, /playerstatus <player>, /onlineplayers
• Prefix (optional): !balance, !pay <player> <amount>, !baltop, !linkstatus, !help

Configuration

plugins/MythicLink/config.yml

discord:
  enabled: true
  token: "YOUR_DISCORD_BOT_TOKEN_HERE"
  guildId: "YOUR_GUILD_ID"
  channelId: ""          # optional: restrict commands to this channel
  prefix: "!"
  statsCommandTemplate: "say MythicLink stats"
  balanceCommandTemplate: "balance %player_name%"
  payCommandTemplate: "pay %target% %amount%"

link:
  codeTtlMinutes: 10

economy:
  recordTransactions: true
  maxTransactionHistory: 20

players:
  trackPlayerStatus: true
  maxSearchResults: 10
  autoUpdateStatus: true

Requirements

• Paper 1.19+ (server)
• Vault + economy plugin (for balance/pay)
• Java 17+

Installation

1. Place MythicLink-all.jar in plugins/
2. Start server once to generate config
3. Set discord.token (use an environment variable for security) and guildId
4. (Optional) Set discord.channelId to restrict to one channel
5. Reload/restart the server

Security

• Do NOT commit your Discord token. Use environment variables or secrets
• Command execution is whitelisted and time-limited
• SQL queries are parameterized and user inputs validated

License

MIT License. Contributions welcome.