✨ AIGF

AIGF Companion adds a realistic AI girl companion to Minecraft Forge 1.20.1.
She can talk with you, react emotionally, remember promises, accept gifts, wear gear, use custom skins, and behave like a real companion instead of a simple NPC.

💖 Features

• 💬 Real AI dialogue in-game
• 😊 Mood, trust, energy, and conflict system
• 🎁 Unique gift reactions to Minecraft items
• 🏠 Home point and go-home behavior
• 🪪 Rename support
• 👗 Custom skins and appearance
• 🛡️ Companion inventory with armor, weapon, and offhand
• 🧠 Promise and memory system
• 🌍 Russian and English support
• 🤖 AI provider support: OpenAI, Gemini, OpenRouter

🕹️ Guide

Spawn

Use: /aigf spawn

Menu

Right-click the companion.

Setup

Open Settings and:

• choose provider
• paste API key
• choose model
• save settings

Chat

You can talk in two ways:

• through her UI chat
• in normal Minecraft chat with @aigf <message>

Example: @aigf hello @aigf follow me @aigf let's talk

Actions

You can:

• tell her to follow you
• tell her to stay
• tell her to sit
• set home
• send her home
• rename her
• change her skin
• give her gifts
• equip armor and weapons

🎭 Bond

Your words matter.

• 💗 Kind words can improve mood and trust
• 💢 Insults can hurt her and create conflict
• 🥀 Broken promises affect trust
• 🌸 Good gifts can make her happy
• 😶 Bad or weird gifts can annoy or confuse her

She does not always react the same way.
Her behavior changes depending on your relationship.

🎁 Gifts

You can gift items from your main hand through the UI.

She reacts to Minecraft items in different ways:

• cute items
• useful items
• valuable items
• weird items
• useless junk
• dangerous items

That means gifts feel personal, not generic.

🏠 Home

You can set a home point for her and send her back anytime.
She can follow you, wait, sit, or go home depending on what you tell her.

⚙️ Requirements

• Minecraft 1.20.1
• Forge 47.4.16
• Java 17

🚧 Status

This mod is still in active development and will keep getting major updates focused on:

• deeper personality
• better memory
• smarter world awareness
• stronger relationship systems

🌹 AIGF

A companion made to feel emotional, personal, and alive inside your Minecraft world.