Smart Villagers AI

Minecraft 版本： 26.2

平台： neoforge

标签： game-mechanics mobs technology

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, and 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

This makes 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.

Configuration

Smart Villagers AI automatically generates a configuration file on first launch.

Common configuration options include:

• DeepSeek API key
• Model name
• Max tokens
• Temperature
• API request timeout
• Player cooldowns
• Global rate limits
• Memory limits
• AI, hints, and memory toggles
• Fallback behavior

Example:

[smartvillagers.api]
apiKey = "YOUR_DEEPSEEK_API_KEY"
model = "deepseek-chat"
maxTokens = 150
temperature = 0.8
requestTimeoutMs = 15000
maxMessagesPerMinute = 30

[smartvillagers.features]
enabled = true
enableMemory = true
enableHints = true
enableQuests = true

[smartvillagers.memory]
maxMemoryEntries = 20
maxConversationHistory = 10

[smartvillagers.ratelimits]
playerCooldownMs = 2000
villagerCooldownMs = 1000
maxMessageLength = 300
maxResponseLength = 500

[smartvillagers.server]
logApiErrors = true

Never share your API key publicly. On servers, keep it in the server-side config only.

Fallback Dialogue

If the API is disabled, unavailable, or not configured, villagers can still use fallback dialogue so the mod remains usable without live AI access.

Server-Friendly Design

Smart Villagers AI includes:

• Cooldowns
• Rate limits
• Spam protection
• Cost controls
• Server-side API security

Commands

/villagerai reload
/villagerai info
/villagerai toggle
/villagerai memory clear
/villagerai debug

Commands may vary between releases.

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.

Privacy & AI 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 enabled.

Compatibility

Supported:

• Vanilla Villagers
• Singleplayer
• Dedicated Servers

Planned or release-dependent support:

• Minecraft 1.20.1+
• Minecraft 1.21+
• Forge
• NeoForge
• Fabric

Always verify compatibility with the specific release before installing.

Frequently Asked Questions

Do I need a DeepSeek API key?

Yes. Live AI conversations require a DeepSeek API key.

Fallback dialogue can be used without one.

Does the mod work offline?

Partially. Fallback dialogue works offline, but AI conversations require internet access.

Will it lag my server?

The mod uses asynchronous processing and includes cooldowns to reduce performance impact.

Can villagers remember players?

Yes. When memory is enabled, villagers can remember conversations, trades, and reputation-related events.

Can I disable memory?

Yes. Memory can be disabled in the config.

Can I limit API usage?

Yes. Cooldowns, token limits, message limits, and global rate limits can be used to control usage and costs.

Is it compatible with modpacks?

Yes. Smart Villagers AI is designed for RPG, survival, adventure, and roleplay modpacks.

Always test compatibility with your specific setup.

Roadmap

Planned features:

• Dynamic Villager Quests
• AI-Generated Lore Books
• Village Gossip Networks
• Raid Panic Dialogue
• Wandering Trader Stories
• Voice Support
• Local AI Models
• Offline AI Support
• Advanced Roleplay Features

Community & Support

• Discord: https://discord.gg/TJc3CxR4jK
• GitHub: https://github.com/MeherBenSalem
• Website: https://nightbeam.dev
• Store: https://nightbeam.dev/store
• CurseForge: https://www.curseforge.com/members/nightbeamstudio/projects
• Modrinth: https://modrinth.com/organization/nightbeam