Minecraft Ban Appeal Bot + Dashboard v1.0

Description
This project combines a Discord bot with a web dashboard to manage Minecraft ban appeals.
Players submit appeals via Discord or the web portal, staff review them, and approvals
automatically unban players through RCON. All actions are logged to a local JSON database.

Features

• Discord appeal prompt with modal submission
• Approve/Reject buttons with staff-only permissions
• Automatic unban via RCON on approval
• /ban command with online player picker + manual entry
• /blacklist add/remove/list to block repeat offenders
• Web dashboard with Discord OAuth login
• Appeals list, ban panel, blacklist manager, logs, and history
• Local JSON storage for appeals and audit trails
• Role-based staff access for moderation actions
• Appeal status tags: Pending, Approved, Denied, Closed
• Rate limiting to reduce spam appeal submissions
• Configurable appeal questions and embed styling
• Staff notes on each appeal with full timeline
• Webhook alerts for approvals/denials
• Auto-prune old appeals by age or status

Requirements

• Node.js 18+ and npm
• Discord bot token with application commands enabled
• RCON credentials for your Minecraft server
• Public URL for OAuth callback (or reverse proxy)

Setup Overview

• Install dependencies and configure your .env
• Register Discord OAuth redirect URL
• Start the bot and the dashboard
• Assign staff roles and permissions

Commands

• /appeal - open the appeal modal
• /ban - create a new ban entry
• /blacklist add|remove|list - manage repeat offenders

Dashboard Pages

• Appeals - review, approve, deny, or close
• Bans - list, create, or revoke bans
• Blacklist - manage blocked users
• Logs - audit trail with filters
• Settings - server, roles, and RCON

Security Notes

• All staff actions are logged with user ID + timestamp
• OAuth-only access to the dashboard

BungeeCord Support

This project does not include native BungeeCord RCON support.

If you want full BungeeCord / proxy-level RCON compatibility, you must use the BungeeCord RCON Plus plugin separately.

Available here:
https://builtbybit.com/resources/bungeecord-rcon-plus.107945/

BungeeCord RCON Plus adds Source-style RCON support for BungeeCord proxies and allows this system to communicate directly with the proxy network.