🤖 FREDDY AI - MINECRAFT AUTONOMOUS NPC

✨ Overview

A state-of-the-art autonomous NPC system for Minecraft, powered by Large Language Models and featuring a professional real-time monitoring dashboard.

• ✅ LLM-Powered AI - Leverages Ollama + qwen2.5:3b for sophisticated decision-making.
• ✅ Real-Time Dashboard - Premium JavaFX UI providing full visibility into the AI's state.
• ✅ Autonomous Behavior - Capable of exploration, combat, construction, and player interaction.
• ✅ Performance Metrics - Comprehensive tracking of response times and system health.
• ✅ Game Map Visualization - Live spatial tracking of the NPC within the world.

---

🖼️ Visual Showcase

Experience Freddy AI in action through these snapshots:

1. Professional Dashboard	2. Autonomous Construction

3. Dynamic Combat	4. System Architecture

5. Player Interaction

---

🚀 Quick Start (5 Minutes)

Step 1: Setup JavaFX

1. Download JavaFX SDK 21 from openjfx.io.
2. Extract to: C:\Program Files\Java\javafx-sdk-21\
3. Done! (Refer to JAVAFX_SETUP.md for detailed instructions).

Step 2: Start Dashboard

mvn -pl dashboard-javafx clean javafx:run

Status should show: 🟡 WAITING FOR CONNECTION

Step 3: Deploy Plugin

mvn -pl minecraft-plugin -am clean package
# Copy the JAR to your server's plugins folder

Step 4: Initialize NPC

/npc create Freddy

---

📊 Dashboard Overview

• 👁️ OBSERVATION - Real-time environment awareness (players, position, time).
• 🧠 LLM THINKING - Transparency into the AI's reasoning process.
• ✨ ACTION - Immediate execution of decided tasks.
• 📈 METRICS - Latency and performance analytics.
• 🗺️ GAME MAP - Precise location and orientation tracking.

---

🔧 Configuration

Brain Tick Speed (BrainLoop.java:29):

private static final long TICK_INTERVAL_MS = 3000; // Interval between AI decisions

Perception Radius (BrainLoop.java:30):

private static final double PERCEPTION_RADIUS = 50.0; // Distance Freddy can 'see'

LLM Model Selection (LLMClient.java:8):

"model": "qwen2.5:3b" // Default model; compatible with Ollama

---

🐛 Troubleshooting

Issue	Solution
Dashboard won't start	Verify JavaFX SDK 21 path in build config.
Dashboard stays yellow	Ensure the Minecraft server is running and the plugin is active.
Freddy is stationary	Check Citizens plugin status and NPC permissions.
LLM Errors	Ensure Ollama is running (ollama serve).

---

📚 Documentation

• JavaFX Setup Guide
• Dashboard Features
• Deployment Instructions

---

🎉 Success!

• Dashboard Status: 🟢 CONNECTED
• Observations: LIVE
• Behavior: AUTONOMOUS

Freddy is now active and thinking for himself! 🚀