Описание
# ✨ 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 `
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.