Skip to content

branduzzo/AIMCDev

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

❓ What is it?

AIMCDev is an AI-powered Minecraft server plugin that takes care of the most tedious and repetitive tasks in server development and management. Instead of manually editing config files, running commands one by one, or looking up plugin documentation every time, you simply describe what you want in plain language and the AI handles the rest. The plugin connects to your preferred AI provider, analyzes your server context (installed plugins, online players, permissions, and more), plans the actions it needs to take, executes them directly on your server, and explains every step clearly in chat. Everything happens in three transparent phases: planning, execution, and conclusion - so you always know exactly what is being done and why.


🧱 Features

  • Full AI integration: supports OpenAI, Gemini, Claude, Groq, Perplexity, and OpenRouter - just set your key in config.yml
  • Three-phase response system: the AI explains its plan, executes actions, and summarizes results with visible loading indicators
  • Three action types: CONSOLE (dispatch server commands), PLAYER (execute as the requesting player), FILE (write config files and trigger plugin reloads)
  • Full Markdown-to-Minecraft conversion: bold, italic, underline, strikethrough, headers, code blocks, inline code, bullet lists, numbered lists, clickable links, and horizontal rules all rendered natively in chat
  • Per-player conversation memory with configurable duration (default 1 hour), saved to chats.yml and automatically purged on expiry
  • /ai clear to wipe your conversation history at any time
  • /aireload to hot-reload the plugin configuration without restarting
  • Automatic server context injection: the AI always knows your server version, installed plugins, online players, and requester info before answering
  • Configurable server access: toggle player list, plugin list, and player info access independently in config.yml
  • Configurable AI language with automatic user language detection (default enabled)
  • Configurable max response length in chat to avoid flooding
  • Discord webhook support with fully customizable embed: title, description, footer, field names, color, and per-action result indicators
  • Every message and prefix fully editable in config.yml with both & color codes and MiniMessage formatting
  • Full Folia compatibility via automatic scheduler detection at runtime
  • /ai <message> with aliases /aimc and /chatbot, permission aiminecraftdev.ai
  • Unsupported plugin fallback: the AI always attempts to help even for plugins not natively listed, and informs the user transparently

🤖 Supported AI Providers

Provider Notes
OpenAI Default model: gpt-5.4
Gemini Default model: gemini-3-flash-preview
Claude (Anthropic) Default model: claude-sonnet-4-5-20250929
Groq Default model: llama-3.3-70b-versatile
Perplexity Default model: sonar-pro
OpenRouter Default model: google/gemini-2.0-flash-exp:free

🧩 Supported Plugins

Plugin Action Type
Minecraft Vanilla CONSOLE or PLAYER depending on context
EssentialsX Mainly CONSOLE, sometimes FILE or PLAYER
LuckPerms CONSOLE only
Skript FILE (reload: skript reload all)
TAB FILE (reload: tab reload)
FancyPlugins Mainly PLAYER and FILE
CheckHacks CONSOLE and FILE (rarely)
ZombieSMP CONSOLE
MultiverseCore PLAYER
WorldEdit / FAWE PLAYER
WorldGuard PLAYER
AdvancedBan / LiteBans PLAYER
EconomyShopGUI ALL types
ItemsAdder FILE primarily
Nexo FILE primarily (If user has Oraxen, do NOT recommend it)
DecentHolograms CONSOLE or PLAYER
DeluxeMenus / DeluxeHub FILE (reload: dm reload or dh reload)
PlaceholderAPI CONSOLE or FILE (mainly /papi ecloud)
Vault FILE primarily
ViaVersion CONSOLE or FILE
ViaBackwards CONSOLE or FILE
ViaRewind CONSOLE or FILE
CoreProtect PLAYER or CONSOLE
Citizens PLAYER mainly
GeyserMC CONSOLE or FILE
Floodgate CONSOLE or FILE
BlueMap FILE or CONSOLE
Dynmap FILE or CONSOLE
Chunky CONSOLE mainly
AuraSkills PLAYER or FILE
GrimAC CONSOLE or FILE
ExcellentCrates FILE or CONSOLE
CrazyCrates FILE or CONSOLE
Lands PLAYER or FILE
Towny PLAYER or CONSOLE
GriefPrevention PLAYER mainly
mcMMO PLAYER or CONSOLE
NuVotifier FILE primarily
ProtocolLib FILE primarily
VentureChat FILE or PLAYER
CMI CONSOLE, PLAYER or FILE
DiscordSRV CONSOLE or FILE
Plan CONSOLE or FILE
spark CONSOLE or PLAYER
HuskHomes CONSOLE, PLAYER or FILE
HuskSync CONSOLE or FILE
MiniMOTD FILE primarily
GSit PLAYER mainly
Harbor FILE or CONSOLE
SuperVanish PLAYER or CONSOLE
BetterRTP PLAYER or CONSOLE
AdvancedPortals PLAYER or FILE
CombatLogX PLAYER or FILE
PvPManager PLAYER or CONSOLE
Shopkeepers PLAYER mainly
Jobs Reborn PLAYER or CONSOLE
Quests PLAYER or FILE
BetonQuest FILE primarily
MythicMobs FILE primarily
ModelEngine FILE primarily
Denizen FILE primarily
CommandPanels FILE primarily
ajLeaderboards CONSOLE or FILE
Simple Voice Chat FILE primarily
ChestShop PLAYER mainly
Slimefun PLAYER or CONSOLE
PlotSquared PLAYER or CONSOLE

For any plugin not in this list, the AI will still make its best effort to help and will inform you that native documentation for that plugin is not built in.


⚠️ Warning

If you need anything - adding support for a new plugin or AI provider, reporting a bug, or requesting a feature I plan to add contact me on my discord server -- branduzzo.it/discord

About

AI-powered Minecraft server development assistant

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages