Smart Villagers AI

# Smart Villagers AI <div align="center"> !(https://i.imgur.com/u2lsfkB.png) (https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/TJc3CxR4jK) (https://img.shields.io/badge/YouTube-FF0000?style=for-the-badge&logo=youtube&logoColor=white)](https://www.youtube.com/@nightbeamstudio) (https://img.shields.io/badge/GitHub-181717?style=for-the-badge&logo=github&logoColor=white)](https://github.com/MeherBenSalem) (https://img.shields.io/badge/CurseForge-F16436?style=for-the-badge&logo=curseforge&logoColor=white)](https://www.curseforge.com/members/nightbeamstudio/projects) (https://img.shields.io/badge/Modrinth-1BD96A?style=for-the-badge&logo=modrinth&logoColor=white)](https://modrinth.com/organization/nightbeam) </div> --- > 🧠 **Bring Minecraft Villagers to Life with AI-Powered Intelligence** Smart Villagers AI transforms ordinary villagers into intelligent NPCs powered by the **DeepSeek API**. Instead of acting as simple trading stations, villagers can: - 💬 Hold natural conversations - 🧠 Remember previous interactions - 🌾 React to their profession - ❤️ Build relationships with players - ⚔️ Offer survival advice - 🌎 Respond to the world around them --- ## ✨ Features ### 💬 AI-Powered Conversations Engage in dynamic conversations with villagers powered by DeepSeek AI. Villagers can: - Answer questions - Discuss Minecraft topics - React to player actions - Participate in roleplay scenarios - Provide useful gameplay information --- ### 👨‍🌾 Profession-Based Personalities Each villager profession has its own personality and knowledge. Examples include: - Farmers discussing crops and food - Librarians sharing knowledge - Clerics discussing mysteries - Armorers talking about gear - Fishermen sharing fishing tips - Nitwits providing questionable wisdom --- ### 🧠 Villager Memory Villagers can remember: - Previous conversations - Trades - Reputation changes - Player interactions - Recent events This allows conversations to feel more natural and persistent. --- ### ❤️ Relationship & Reputation System Villagers react differently based on how players treat them. Influence reputation through: - Trading - Helping villagers - Defending villages - Attacking villagers - Stealing resources - Causing trouble Build trust—or become infamous. --- ### 🌎 Context-Aware Responses Villagers can consider: - Biome - Weather - Time of day - Nearby dangers - Equipment - Player status - Village conditions Making conversations feel connected to the actual world. --- ### 💡 Smart Hints & Survival Advice Villagers can provide: - Exploration tips - Farming advice - Trading suggestions - Combat warnings - Resource recommendations - Progression guidance --- ### ⚡ Async API Processing All AI requests are processed asynchronously to minimize performance impact and avoid blocking the game thread. --- ### 🔧 Highly Configurable Control every aspect of the AI system: - AI Model - Temperature - Token Limits - Memory Settings - Cooldowns - Rate Limits - Timeouts - Feature Toggles --- ### 🔄 Fallback Dialogue No API key configured? No problem. Villagers can automatically use built-in fallback dialogue so the mod remains functional offline. --- ### 🛡️ Server-Friendly Design Includes: - Cooldowns - Rate Limits - Spam Protection - Cost Controls - Server-Side API Security Perfect for multiplayer servers. --- ## ⚙️ Configuration Smart Villagers AI automatically generates a configuration file on first launch. ### Example Configuration ```toml apiKey = "YOUR_DEEPSEEK_API_KEY" model = "deepseek-chat" maxTokens = 150 temperature = 0.8 requestTimeoutMs = 15000 maxMessagesPerMinute = 30 enabled = true enableMemory = true enableHints = true enableQuests = true maxMemoryEntries = 20 maxConversationHistory = 10 playerCooldownMs = 2000 villagerCooldownMs = 1000 maxMessageLength = 300 maxResponseLength = 500 logApiErrors = true ``` > ⚠️ Never share your API key publicly. --- ## 📦 Installation 1. Install the required mod loader. 2. Place Smart Villagers AI in your `mods` folder. 3. Launch Minecraft once. 4. Open the generated config file. 5. Add your DeepSeek API key. 6. Configure desired settings. 7. Restart the game or server. 8. Right-click a villager to start chatting. --- ## 🖥 Commands ```bash /villagerai reload /villagerai info /villagerai toggle /villagerai memory clear /villagerai debug ``` > Commands may vary between releases. --- ## 🔒 Privacy Notice When AI conversations are enabled: - Player messages may be sent to the configured DeepSeek API. - API keys should remain private. - Sensitive information should never be shared through villager conversations. - Server owners should inform players when AI chat is enabl