🧠 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

Install Forge 1.20.1
Drop the mod .jar into your mods folder
Launch the game once to generate the config file
Open config/reactivenpc.toml
Paste your Groq API key into the groq_api_key field
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-!

ReactiveNpc

截图

介绍