thesashadev/discordpunishments

DiscordPunishments is a plugin for Minecraft servers that lets moderation staff ban, mute, or kick players directly from Discord. Instead of typing commands into the server console or remembering exact syntax, a moderator can click buttons and fill out a short form in Discord, and the punishment is carried out automatically in the game. The plugin creates a moderation panel in Discord with dedicated buttons for banning, muting, and kicking. When a moderator clicks one, a pop-up form appears asking for the player's nickname, how long the punishment should last, and the reason behind it. Once submitted, the plugin translates that information into the appropriate Minecraft command and applies it on the server. The specific in-game commands triggered by each action are configurable, so server owners can tailor the setup to their existing moderation system. This tool is designed for people who run or moderate Minecraft servers, particularly communities that already rely on Discord for staff coordination. For example, if a player is being disruptive in-game and a moderator is already monitoring a Discord support channel, that moderator can issue a 24-hour mute or a permanent ban without ever leaving Discord or logging into the server console. This makes the workflow faster and reduces the chance of mistyping a command. The project is built in Java and designed for Minecraft servers running the Paper or Spigot software. Server administrators can compile the plugin themselves, and there is a permission system to control who is allowed to access the Discord moderation panel. The documentation also cautions users to keep their Discord bot tokens and production configuration files out of version control, treating those as private secrets stored outside of the codebase.