PTEROLINK — Control your Minecraft server from Discord━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
WHAT IS THIS?
PteroLink is a Discord bot (not a Minecraft plugin — nothing installs on your
server) that lets your staff manage your Minecraft server by typing commands
in Discord, instead of logging into a separate panel or console.
Type /power restart in Discord → your server restarts. Type /status → see
who's online and if the server is healthy. No panel login needed, no shared
passwords, no "can someone restart the server" pings.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
WHAT IT DOES━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
/status — power state, CPU/RAM/disk usage, and who's online, in one embed
/power start | stop | restart | kill — control the server without the panel
/run <command> — send any console command, get the output back in Discord
/whitelist add | remove <player> — the #1 staff request, one command away
/say <message> — broadcast a message in-game from Discord
Staff-only by default — you choose which Discord roles can use the risky commands
Audit log — every action is posted to a log channel: who did what, and when━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
HOW IT CONNECTS TO YOUR MINECRAFT SERVER━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
This is a Discord bot — it runs separately from your Minecraft server and
talks to it over the network. There are two connection types, and you can
use either one or both:
① RCON (works on ANY Minecraft server — vanilla, Paper, Spigot, Forge, etc.)
Turn on RCON in your server.properties (it's a built-in feature, already
there — nothing to install), grab the port + password, drop them in the
bot's config. This alone powers /run, /whitelist, /say, and the online
player list.
② Pterodactyl API key (optional — only if your host uses a Pterodactyl panel)
Grab an API key from your panel's account settings, drop it in the config.
This unlocks /power (start/stop/restart) and the CPU/RAM/disk stats.
Minimum setup = RCON only, and most commands work. Add the Pterodactyl key
for full power control too. Full step-by-step guide included.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
WHAT YOU GET━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- Full, clean, unobfuscated source code
- Step-by-step setup guide (Discord bot → RCON → Pterodactyl → deploy)
- .env.example with every setting explained
- Easy to extend — drop a new command file in and it's auto-loaded
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
REQUIREMENTS━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- A Minecraft server with RCON enabled (built-in, free, any host)
- Optional: a Pterodactyl-hosted server, for power control
- Node.js 18+ to run the bot itself (your existing box, or a $5/mo VPS)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
LICENSE━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Single-server license — self-host on your own Discord and Minecraft server.
Resale or redistribution of the source code is not permitted.
