An intelligent, autonomous Paper/Spigot Minecraft plugin (Java 17+, 1.21+) powered by Hermes AI that transforms your server with:
- 🛡️ Hypixel-Style Watchdog Anti-Cheat — Invisible orbiting KillAura trap bot, movement/combat checks, auto-bans & Discord appeal screens
- 👑 Autonomous AI Game Master (
/aiadmin) — Dynamic scheduled server events (Meteor Drops, Blood Moons, Golden Hours) - 🧠 Player Telemetry & Archetype Profiling — Tracks playstyles (Miner, Builder, Warrior, Explorer, Survivor)
- 🎁 Adaptive Sympathy Care Packages — AI detects death streaks or lava loss and delivers survival relief
- 📜 Tailored Daily Tasks (
/aidaily) — Daily quests and bounties customized to each player's playstyle - 💬 Public Chat AI Observer & Private Chat (
/aichat) — Hermes observes chat, answers questions when tagged (@ai) or needed, and stays quiet during banter - 🎉 Cinematic First-Join Welcomes — Server broadcast, title banner, celebratory fireworks, starter kit & AI whispers
- 🔄 GitHub Auto-Updater — Automatically downloads new releases into
plugins/update/ - 📊 Live Discord Tracking & Leaderboards — Real-time self-updating embed and SQLite persistence
Keep your server clean and fair with automated heuristic detection and honeypot bot traps:
- Orbiting KillAura Honeypot Bot: When a player is reported or suspicious, Watchdog spawns an invisible rotating bot (
Watchdog) around their head. Natural players never attack it, while automated KillAura/TriggerBot cheats lock onto it and get caught immediately. - Combat & Movement Checks:
- Reach Check: Detects combat hits exceeding 3.9 blocks in survival mode.
- Angle Check: Flags impossible attack angles outside natural field-of-view (> 95°).
- AutoClicker / CPS: Rolling click history detecting CPS exceeding 20 clicks/sec.
- Flight / Glide & Ascend Check: Detects illegal survival flight (
/fly, abilities packets), airborne ascension without ground contact, and prolonged hovering (> 20 ticks without descent). Auto-bans blatant survival fliers at 8 VL. - Speed / Bhop Check: Flags unnatural horizontal velocity (> 0.72 blocks/tick).
- Jesus / Water Walk: Detects walking across liquid surfaces without submerging.
- Anti-Xray Statistical Detection: Tracks diamond/ancient debris discovery speed, vein clustering, and ore-to-stone mining ratios. Flags unnatural mining velocity (4+ veins in under 3 mins, > 20% ore ratio) and alerts staff with exact coordinates.
- Unified Discord Ban Card & Automated Appeal Lifecycle (
discord-bot/):- Sends a single unified ban card directly through the Discord bot, featuring player skin renders, Ban ID (
#WD-XXXXXXXX), detection reason, and an attached[📩 Submit Ban Appeal]button. - No two-way duplicate messages: Discord Webhooks and Bot are integrated so players see one clean card.
- Modern Discord Slash Commands:
/setbanchannel #channel- Sets the public ban announcements channel./setappeallog #channelor/banapeal #channel- Sets the staff appeals review channel./postappealpanel- Posts a permanent appeal station panel in any channel./appealstatus- Checks channel configurations and bot permission health.
- Players click
[📩 Submit Ban Appeal]to open a native popup form pre-filled with their IGN and Ban ID. - Submissions are delivered to staff with
[🟢 Accept Appeal]and[🔴 Deny Appeal]buttons. [🟢 Accept Appeal]automatically pardons the player in Minecraft without opening console and sends a rich DM confirmation to the applicant.[🔴 Deny Appeal]prompts staff for a denial reason via modal and sends a rich DM to the applicant explaining the decision.- Bi-directional Local Bridge (
http://127.0.0.1:25608):POST /ban: Sends ban notifications from Minecraft to Discord.GET /unbans&POST /unbans/ack: Polled every 5 seconds by Paper to auto-unban approved applicants without console commands.
- Sends a single unified ban card directly through the Discord bot, featuring player skin renders, Ban ID (
Hermes acts as an autonomous server director, scheduling and triggering world events:
- Celestial Meteor Supply Drop: Strikes lightning and spawns a supply chest loaded with diamonds, golden apples, and totems at random surface coordinates near active players.
- Blood Moon: Midnight thunderstorm empowering monsters with glowing and speed, granting surviving players double XP until sunrise.
- Golden Hour: Blesses active players with Haste and Regeneration buffs for 15 minutes.
- Admin Control: Staff can trigger events, send gifts, check player telemetry, or inspect stats anytime via
/aiadmin.
- Combat Tagging & Anti-Combat-Log:
- Engaging in PvP triggers a 15-second combat tag with real-time actionbar countdown (
⚔ In Combat: 14s | Do not disconnect!). - Blocks teleport/escape commands (
/spawn,/tpa,/home, etc.) during combat. - If a player disconnects while combat-tagged, they are instantly eliminated and drop all items. The attacker gets the kill credit, head trophy, and any active bounty!
- Engaging in PvP triggers a 15-second combat tag with real-time actionbar countdown (
- Decapitated Player Head Trophies:
- Slain players drop their custom player skull item with victim texture and engraved lore (killer name, date, and conquest inscription).
- Diamond Bounty System (
/bounty):- Players can fund bounties using in-game Diamonds (
/bounty place <player> <amount>). - View top wanted criminals anytime with
/bounty list. - Killing a wanted player automatically deposits the Diamond bounty directly into the killer's inventory!
- Players can fund bounties using in-game Diamonds (
- Autonomous AI Bounties & Killstreaks:
- Players on 3, 5, and 10 killstreaks trigger global server announcements and speed/resistance buffs.
- When a player reaches a 5-kill rampage, Hermes AI autonomously places a 5-Diamond bounty on their head, turning them into a high-value wilderness target!
- Hermes AI Death Roasts:
- Accidental or humiliating deaths (lava baths, falling, suffocation in walls, drowning, baby zombies) trigger hilarious 1-line roasts from Hermes in chat.
- Anti-Crash Exploit Guard:
- Blocks oversized Unicode books and illegal NBT data to prevent book-ban and chunk-ban server crashes.
- Real-time logging of blocks mined, rare ores, placements, mob kills, PvP kills, deaths, and distance.
- Categorizes players into archetypes:
- ⛏️ Miner — deep cave dwellers & ore hunters
- 🔨 Builder — architects & structure builders
- ⚔️ Warrior — PvE/PvP fighters
- 🧭 Explorer — surface travelers
- 🛡️ Survivor — balanced survivalists
- Sympathy Gifts: If a player dies 3+ times in rapid succession or falls into lava, Hermes delivers a sympathy care package (Golden Apples, Fire Resistance potions, tools, food) with a 30-minute cooldown.
- Each player receives 1 daily quest tailored specifically to their archetype.
- Command
/aidailyshows a visual progress bar:[■■■■■■□□□□] (6/10). - Completing tasks awards bounties (diamonds, building materials, combat elixirs) via
/aidaily claimwith celebratory fireworks.
- Global Chat AI Assistant (
hey aichat,message ai,/ai):- Players can ask Hermes to explain, translate, or answer questions directly in global chat!
- Natural Chat Triggers: Type naturally in chat:
hey aichat tell him how to make a nether portalhey ai tell @Steve diamonds spawn at Y -58message ai send msg in global chat how to craft anvilhey ai translate to english: ma 5 min ma aauxuai how to breed villagersor@ai what is the server ip
- Player-to-Player Translation & Assistance: Perfect for players who want to help another player but don't want to type long explanations or aren't fluent in English — Hermes explains clearly, addresses the target player, and keeps answers under 2 lines of chat!
- Commands:
/ai <message>,/messageai <message>, or/aichat global <message>.
- Private Chat Session: Players can initiate a private 1-on-1 AI chat with
/aichat <message>without other players seeing it. Use/aiexitto finish. - Server-Aware Lore: Hermes knows server rules, features, commands, and Discord links, ensuring accurate answers rather than generic vanilla facts.
- First-time players receive a server-wide welcome broadcast, title banner, celebratory fireworks, starter food and tools, and a personal welcome whisper from Hermes.
- Returning players receive a welcome back message with their daily quest status.
- Checks
hyperdargo/DTEmpireAiPluginGitHub releases periodically. - Automatically downloads newer
.jarreleases intoplugins/update/DTEmpireAIChat.jarto be safely applied on the next restart or reload. - Manual check anytime via
/dtempireai update.
| Command | Permission | Description |
|---|---|---|
/ai <question> |
dtempire.aichat |
Ask AI to answer/explain/translate in global chat (Aliases: /messageai, /heyai) |
@ai <question> |
(Public chat) | Ask Hermes directly in public server chat (or type: hey aichat, message ai) |
/aichat <message> |
dtempire.aichat |
Start or continue a private AI chat |
/aiexit |
dtempire.aichat |
End private AI chat session |
/aihelp |
dtempire.aichat |
Show AI commands and help guide |
/aidaily [claim] |
dtempire.daily |
View or claim your tailored daily quest and bounty |
| `/bounty <place | list | check>` |
/watchdog report <player> |
dtempire.watchdog.report |
Report suspicious players to Watchdog |
| `/watchdog <test | inspect | ban |
| `/aiadmin <event | gift | broadcast |
| `/dtempireai <update | reload | status>` |
/dtstatus |
dtempire.tracking.status |
Post Discord status embed immediately (Admin) |
| `/dttracking <on | off>` | dtempire.tracking.toggle |
- Download
DTEmpireAIChat.jarfrom the Latest Release. - Place the jar into your server's
plugins/directory. - Start the server to generate
plugins/DTEmpireAIChat/config.yml. - Configure your AI API key and settings:
# API endpoint (OmniRoute or OpenAI compatible)
api:
base-url: "https://route.ankitgupta.com.np/v1"
model: "DiscordBot"
api-key: "YOUR_API_KEY_HERE"
# Watchdog Discord Appeal URL
watchdog:
enabled: true
discord-appeal-url: "http://dsc.gg/dtempire-server"
# Server info injected into AI context
server-info:
name: "DTEmpire"
ip: "play.dtempire.com"
gamemode: "Survival SMP"
# Discord status tracking embed (optional)
tracking:
enabled: true
discord:
webhook-url: "https://discord.com/api/webhooks/..."- Run
/dtempireai reloadin-game or restart your server.
DTEmpireAIChat is built as a native server-side plugin for Paper 1.21.4+ (and modern Spigot/Purpur forks).
If your server runs modpacks on Fabric, Forge, or NeoForge, you can run DTEmpireAIChat server-side today via standard Bukkit compatibility loaders:
- NeoForge / Forge 1.20 - 1.21+: Run via Mohist, Arclight, or Ketting. Drop
DTEmpireAIChat.jardirectly into theplugins/directory. - Fabric 1.21+: Run via Cardboard or Banner. Allows Paper/Spigot plugins to load seamlessly alongside Fabric server mods.
Because DTEmpireAIChat utilizes Paper's Bukkit EventBus (BlockBreakEvent, AsyncChatEvent), SQLite storage, and Kyori Adventure text, a native mod port (without hybrid loaders) requires porting to Architectury API with separate subprojects for:
common: Core AI logic, telemetry models, SQLite store, and Watchdog heuristics.fabric: Fabric Loom build with Fabric lifecycle and mixin hooks.neoforge: NeoForge ModDev build with NeoForge event bus.forge: Legacy MinecraftForge build.
Requirements: Java 17+ and Maven.
git clone https://github.com/hyperdargo/DTEmpireAiPlugin.git
cd DTEmpireAiPlugin
mvn clean package -DskipTestsThe compiled shaded jar will be located at:
target/DTEmpireAIChat.jar (includes shaded sqlite-jdbc driver).