
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.
Screenshots


About this Mod
✨ 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.
Available Versions
How to Install Litewer's AI girlfriend (GF) on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set forge Loader
In the panel under "Egg", select the forge loader and matching Minecraft version (1.20.1).
Install Mod
Open the mod browser in the dashboard and search for "Litewer's AI girlfriend (GF)". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.20.1
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Litewer's AI girlfriend (GF) server crashes on startup – what to do?
Most common cause: wrong forge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.20.1). You can switch loaders with one click in the panel.
Is Litewer's AI girlfriend (GF) compatible with forge?
Litewer's AI girlfriend (GF) officially supports forge for Minecraft 1.20.1. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Litewer's AI girlfriend (GF) – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Litewer's AI girlfriend (GF) consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Litewer's AI girlfriend (GF) with just one click on your server.