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`

```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.