AI_NPC

# AINPC — AI-Powered Conversational NPCs **Turn villagers into living characters.** Walk up, say hi, and they answer — with real personality, real memory, and real actions. Works with **every LLM provider**: OpenRouter, Ollama, LM Studio, OpenAI, Groq, DeepSeek, Gemini, Anthropic, or anything OpenAI-compatible. --- ## ✨ What can they do? - 💬 **Chat naturally** — no commands needed. Walk within 10 blocks and type in chat. The NPC turns to face you, shows 💭 while thinking, and answers for everyone nearby. - ⚡ **Streaming replies** — answers appear sentence-by-sentence as the model types. - 🌍 **World-aware** — they know the time of day, weather, biome, your health, what you're holding, and who else is around. Ask a villager about the thunderstorm — they noticed. - 🛠️ **They actually DO things** (function calling): - Hand you bread when you say you're hungry 🍞 - Sell items and haggle over the price — payment taken from your inventory 💰 - Show emotions with particles and sounds 😄😠 - Hand out quests, check your items, and pay rewards 📜 - 👋 **Greet you first** when you walk up to them. - 🧠 **Remember you** — per-player conversation memory, and they reply in *your* language. ## 🎭 Make characters, not chatbots ``` /ainpc create Bob /ainpc persona Bob a grumpy old blacksmith who secretly loves cats ``` That's it. Bob now stands there, greets passers-by, complains about his back, and will sell you an iron ingot for 2 emeralds — if you're polite. ## 🔌 Bring your own AI Every provider works. Run **free local models** with Ollama or LM Studio, or plug in OpenRouter/OpenAI/Anthropic/Groq/Gemini keys. Mix per-NPC: your quest-giver can run Claude while your random villagers run a local llama. ```yaml providers: ollama: # free, local type: openai base-url: http://localhost:11434/v1 api-key: "ollama" model: llama3.2 ``` ## 🔒 Server-safe by design - NPCs only give/sell **whitelisted items** — players can't sweet-talk them into free diamonds - Amount caps, per-player cooldowns, one in-flight request per player - All API calls run **off the main thread** — zero TPS impact - NPCs are invulnerable, can't be traded with, can't turn into zombies ## 📦 Quick start 1. Drop the jar in `plugins/`, restart 2. Edit `plugins/AINPC/config.yml` — pick a provider, paste your key 3. `/ainpc reload`, then `/ainpc create ` and start talking! --- *Full documentation, https://ainpc.programmer.in.th*