?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
ReactiveNpc

ReactiveNpc

ReactiveNPC adds Aria — an AI-powered NPC companion (via Groq API) who cooks, fights, and talks naturally. Features inventory, combat protection & Family RPG. Requires a free Groq API key. ⚠️ Alpha — bugs expected!

86
1
86
1

Compatibility

Minecraft: Java Edition

1.20.1

Platforms

Supported environments

Client and server

Tags

Creators

Details

Licensed ARR
Published 2 months ago

🧠 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-!