✨ 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.
How to Install Litewer's AI girlfriend (GF) (Mod)
Litewer's AI girlfriend (GF) by Litewer is verified for Forge across Minecraft versions 1.20.1 (latest release: AIGF-0.1, file size: 259 KB). Follow the steps below to install it safely from ModCraft.tv:
- Click the Download button above and select your Minecraft version (1.20.1) and platform (Forge).
- Make sure you have the compatible loader or environment installed for Forge.
- Move the downloaded Litewer's AI girlfriend (GF) file into your Minecraft
.minecraft/modsfolder and launch the game.
- AI companion dialogue in UI and Minecraft chat
- Mood, trust, energy, conflict, and relationship systems
- Promise and memory systems
- Gifts with unique item-based reactions
- Home point and go-home behavior
- Rename support and skin switching
- Companion inventory for armor, weapon, and offhand
- OpenAI, Google Gemini, and OpenRouter support
- Russian and English language support
### Supported
- Minecraft Forge 1.20.1
- Forge 47.4.16