MineServ

MineServ

MineServ is a lightweight, dedicated server-side Fabric mod for Minecraft 26.3 that lets administrators monitor, moderate, and manage their server directly from Discord. Players do not need to install the mod on their clients to join.

Key Features

• Configurable Server & OP Command Logging: Stream all INFO+ console logs to a dedicated Discord channel, or enable log_only_op_commands to only record commands executed by operators (OPs) and the server console. Built-in message batching prevents Discord rate limits.
• Scheduled Maintenance System: Run /mineserv startmaintanence from Discord to start an automated server shutdown countdown with in-game broadcast warnings at key intervals (10m, 5m, 3m, 1m, 30s, 15s, 10s, and 5-1s). Cancel anytime with /mineserv cancelmaintenance.
• Live Server Diagnostics: Check real-time server TPS, MSPT, RAM usage, maintenance status, and online players via /mineserv status.
• Remote Console & Moderation: Execute console commands and view their exact output inside Discord (/mineserv command), or manage players using /mineserv kick, /mineserv ban, and /mineserv whitelist.
• Two-Way Chat Bridge: Relay player chat, join, and leave events between Minecraft and a designated Discord channel with built-in @everyone and @here mention sanitization.
• 6-Digit Account Linking & Bedrock Role Sync: Players can link their accounts in-game with /link <discord_id> and confirm in Discord using /verify <code>. MineServ automatically detects Bedrock Edition players (via Geyser/Floodgate UUIDs, API, or username prefixes) and assigns a dedicated Discord role.
• Live Player & Inventory Inspection: Inspect an online player's health, hunger, XP, coordinates, equipped armor, main inventory, and Ender Chest remotely with /mineserv inspect, or remove specific items using /mineserv invremove.

Command Reference

Discord Slash Commands (Admin)

• /mineserv status - View live TPS, MSPT, memory usage, and online player list.
• /mineserv startmaintanence <timebeforeserverstopinminutes> [reason] - Schedule a graceful server shutdown.
• /mineserv cancelmaintenance - Cancel an active maintenance countdown.
• /mineserv logmode <op_only> - Switch between logging only OP commands or all console logs.
• /mineserv command <cmd> - Execute any Minecraft server command and return the output to Discord.
• /mineserv inspect <player> [view] - View a player's all, vitals, inventory, or enderchest.
• /mineserv invremove <player> <container> <item> [count] - Remove matching items from a player's inventory, enderchest, or armor.
• /mineserv kick <player> [reason] - Kick an online player.
• /mineserv ban <action> [player] [reason] - Ban, unban, or list banned players.
• /mineserv whitelist <action> [player] - Add, remove, list, enable, or disable the server whitelist.
• /mineserv whois <player> - Check a player's UUID, edition (Java/Bedrock), and linked Discord account.
• /mineserv reload - Reload config/mindserv/main.toml and config/mindserv/links.toml from disk.

Player Commands

• /link <discord_id> (In-Game) - Generate a 6-digit verification code to link your Discord account.
• /unlink (In-Game) - Unlink your Minecraft account from Discord.
• /verify <code> (In Discord) - Confirm your 6-digit verification code to complete linking and receive roles.

Quick Setup

1. Drop the MineServ JAR and Fabric API into your server's mods/ folder.
2. Start the server once to generate config/mindserv/main.toml.
3. Create a bot in the Discord Developer Portal, enable Message Content Intent, and invite it to your Discord server with View Channels, Send Messages, Embed Links, Read Message History, and Manage Roles permissions.
4. Paste your bot_token, log_channel_id, chat_channel_id, and optional bedrock_role_id into config/mindserv/main.toml.
5. Restart the server or run /mineserv reload.

Requirements

• Minecraft: 26.3
• Mod Loader: Fabric (>=0.19.5)
• Dependencies: Fabric API
• Environment: Server-side only (Client installation not required)
• Java: Java 25