Litewer's AI girlfriend (GF)
A realistic AI companion for Minecraft Forge 1.20.1 with emotional dialogue, memory, gifts, customizable looks, and interactive companion behavior.
Quick challenge
How far can you run before the mobs catch you?
Minecraft check
Confirm your run
Complete the quick check to get your code.
Litewer's AI girlfriend (GF)
✨ 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.