🧠 ReactiveNPC — The Living Companion Mod

She cooks. She fights. She remembers. She's not just an NPC.

🚧 Early Development Notice

⚠️ This mod is currently in early development (Alpha stage). Bugs, crashes, and incomplete features are expected. It is not recommended for use in important worlds without a backup. If you encounter any issues, please report them in the comments or Issues tab — your feedback directly helps improve the mod!

🌟 Overview

ReactiveNPC introduces Aria — an intelligent companion NPC powered by AI dialogue, a personal inventory system, autonomous cooking behavior, and combat protection. Aria doesn't just stand around waiting for commands. She lives alongside you.

Whether you're building a base, going on an adventure, or just sitting by the fire, Aria adapts to the world around her and takes action on her own.

⚠️ Requirements

• Minecraft: 1.20.1
• Forge: 47.4.x or higher
• Java: 17+
• Groq API Key — This mod uses Groq to power Aria's AI dialogue. You must create a free account at groq.com and enter your API key in the mod config file before Aria can speak. Without a key, all other features (cooking, combat, inventory) still work normally.

🔑 Get your free Groq API key at: https://console.groq.com

✨ Features

🗣️ AI-Powered Dialogue (Groq)

• Talk to Aria naturally — she responds with context-aware conversation
• Powered by Groq's ultra-fast LLM inference
• Her replies adapt based on the situation and your relationship
• No more robotic "Trade / Cancel" menus

🍖 Autonomous Cooking System

• Aria scans the area for nearby furnaces
• If she has raw food in her inventory, she walks to the furnace and cooks it herself
• She manages fuel (coal, wood) automatically
• Supports beef, chicken, porkchop, mutton, rabbit, salmon, cod, and potatoes
• Notifies you when she starts cooking

🎒 Personal Inventory

• Aria carries her own 27-slot inventory (chest-sized)
• Items are saved and loaded via NBT — nothing is lost on relog
• She manages her own resources independently

⚔️ Combat & Protection

• Aria will protect you when you're under attack
• She engages enemies and fights by your side
• She's not just a companion — she's a guardian

👨‍👩‍👧 Family RPG System

• Build a relationship with Aria over time
• She's designed with RPG family/companion dynamics in mind
• have a child -beta-

🔧 Setup Guide

1. Install Forge 1.20.1
2. Drop the mod .jar into your mods folder
3. Launch the game once to generate the config file
4. Open config/reactivenpc.toml
5. Paste your Groq API key into the groq_api_key field
6. Save and relaunch — Aria is ready!

🗺️ Planned Features

• Emotion & mood system
• Extended dialogue trees
• More autonomous behaviors (farming, building)
• Quest / task system
• More companion types beyond Aria

💬 Feedback & Support

Found a bug? Have a suggestion? Drop it in the Issues tab or leave a comment below.

If you enjoy the mod, an ⭐ rating goes a long way!

ReactiveNPC is designed to make your Minecraft world feel alive — one companion at a time. !-skin is not mine, blissly from NameMC-!