AI_Admin_mod and chat box

AI Minecraft Administrator

🧠 AI-Powered Administration • ⚙️ Automation • 🌍 World Control • 🛡️ Server Management

AI Minecraft Administrator brings a powerful administration system directly into Minecraft.

Instead of memorizing dozens of commands, server operators can use a modern in-game interface to manage players, inspect the world, automate tasks, and interact with Minecraft using natural language.

Talk to your Minecraft server. Let the administrator handle the syntax.

---

✨ What Can It Do?

AI Minecraft Administrator combines traditional Minecraft administration with an optional AI-powered interaction layer.

🎮 In-Game Administration

Open the administrator with:

K

or:

/aiadmin interact

The interface provides:

• 💬 Natural-language administration

• 🎁 Item management

• 👤 Player management

• 📍 Teleportation

• 🎮 Gamemode control

• 👢 Player kicking

• 🌍 Biome information

• 🔎 World inspection

• 🧩 Installed mod information

• 📜 Command history

• ⚡ Quick actions

• ✅ Execution status

• ❌ Validation and error messages

• ⚙️ AI configuration

---

🧠 Optional AI Integration

AI integration is completely optional.

The built-in structured command system works without connecting an external AI provider.

When AI integration is enabled, you can connect the mod to your own provider, model, endpoint, and API credentials.

Supported AI Providers

• Google Gemini

• OpenAI / GPT

• DeepSeek

• Moonshot / Kimi

• Anthropic / Claude

• Mistral AI

• MiniMax

• Groq

• xAI / Grok

• Alibaba Qwen

• Custom OpenAI-compatible endpoints

---

💬 Natural-Language Administration

You can communicate with the administrator using normal language.

Give Steve 64 diamonds.

Teleport me to the desert.

Teleport Alex to Steve.

What biome am I currently in?

Build a house here.

AI requests are converted into structured administrative actions rather than being treated as unrestricted server commands.

User Request
     ↓
AI Response
     ↓
Structured Action
     ↓
Command Parser
     ↓
Server Validation
     ↓
Minecraft Execution

---

🛡️ Server-Side Security

The client GUI is not trusted to perform administrative operations.

Requests are validated by the server before Minecraft state is modified.

The server remains authoritative over:

• Permissions

• Command execution

• Player actions

• World modification

• Entity spawning

• Administrative operations

AI suggests actions. The server decides what is allowed.

This means the AI layer is separated from the final execution layer.

---

⚡ Built-In Command System

You do not need AI to use the administrator.

👤 Player Management

give <player> <item_id> [count] [enchant:level,...]

gamemode <player> <survival|creative|adventure|spectator>

teleport <player> <x> <y> <z>

teleport <player> <target_player>

kick <player> [reason]

Example:

give Steve minecraft:diamond 64

🌍 World Management

setblock <x> <y> <z> <block_id>

fill <x1> <y1> <z1> <x2> <y2> <z2> <block_id>

🏗️ Building & Automation

Supported procedural building types include:

wall
floor
cube
tower
house
pyramid

Example:

build house 8

👾 Entity Management

spawn <entity_id> [count]

Example:

spawn zombie 10

🔎 World & Server Information

where
biome
modlist
help

---

📦 Resource Pack Utilities

The administrator can expose resource-pack management commands:

pack add <url>
pack list
pack remove <name>
pack clear
pack reload

---

🌈 Iris Shader Utilities

When Iris is installed, shader controls can be accessed through the administrator interface.

shader <pack>

Disable the active shader:

shader off

---

🔑 AI Configuration

AI settings are stored separately from the mod JAR:

config/ai_admin.json

The AI Settings interface allows you to configure:

• AI provider

• Model

• Endpoint

• API credentials

A built-in Test AI function allows you to verify the selected configuration before using AI requests in-game.

---

🧩 Fabric + Forge Support

Built using the Architectury toolchain for Minecraft 1.20.1.

Platform	Supported Version
Fabric	Minecraft 1.20.1 • Fabric Loader 0.14.22+
Forge	Minecraft 1.20.1 • Forge 47.2.0+

---

📋 Requirements

• Minecraft 1.20.1

• Java 17

• Architectury API 9.x

• Fabric Loader 0.14.22+ or Forge 47.2.0+

---

🚀 Getting Started

1. Install Minecraft 1.20.1.

2. Install Fabric or Forge.

3. Install the required Architectury API version.

4. Place the AI Minecraft Administrator JAR into your mods folder.

5. Make sure you have operator permissions level 2 or higher.

6. Press K or run:

/aiadmin interact

1. Open AI Settings when you want external AI integration.

2. Select a provider and model.

3. Configure the endpoint and credentials.

4. Use Test AI to verify the connection.

No API Key?

No problem.

The built-in structured command system remains available without external AI.

---

⭐ Features at a Glance

✅ AI-powered Minecraft administration
✅ Optional external AI integration
✅ Multiple AI provider support
✅ Custom OpenAI-compatible endpoints
✅ Natural-language commands
✅ Built-in structured command parser
✅ Server-side permission validation
✅ Player management
✅ Teleportation
✅ Gamemode management
✅ Item management
✅ World manipulation
✅ Procedural building
✅ Entity spawning
✅ Biome inspection
✅ Mod list inspection
✅ Resource-pack utilities
✅ Iris shader controls
✅ Modern in-game administration UI
✅ Command history
✅ Quick actions
✅ AI connection testing
✅ Fabric support
✅ Forge support
✅ Minecraft 1.20.1

---

🔮 Future Development

The project is designed as a foundation for future AI-assisted Minecraft administration, including:

• More advanced AI planning

• Complex building operations

• Automated server maintenance

• More world-inspection tools

• Expanded mod integrations

• Additional AI providers

• More structured actions

• Richer administrator dashboards

• Advanced automation workflows

---

📜 License

MIT License

See the project metadata and repository for the complete license information.

---

🤖 AI Minecraft Administrator

Control your server. Automate your world. Talk to your administrator.

AI + 🎮 Minecraft + 🛡️ Server Security + ⚙️ Automation + 🏗️ World Control