Repository navigation
v2.0.2-alpha [MC 1.21.9]
Pre-release
Pre-release
Girlfriend Mod Changelog
Version 2.0.2-alpha [MC 1.21.9]
Overview
This update introduces a sophisticated sentiment analysis system for relationship management and refines combat forgiveness mechanics. The girlfriend now intelligently interprets player interactions, rewarding positive behavior and understanding accidental harm, while providing meaningful relationship-based bonuses.
Major Features
Sentiment Analysis Engine:
- AI-Powered Interaction Analysis: Girlfriend now uses the configured AI provider to analyze player messages for sentiment (positive/negative/neutral) and intent (item requests, compliments, insults).
- Context-Aware Interpretation: The system distinguishes between comments directed at the girlfriend versus general conversation, preventing false positives.
- Relationship Impact: Positive interactions increase relationship level, negative interactions decrease it, with scaling based on current relationship tier.
Relationship Milestone Bonuses:
- Level 25: Forgives accidental hits from owner
- Level 50: Shares rare items more willingly and heals owner when health is low
- Level 75: Takes more risks to protect owner and deals increased combat damage
- Level 90: Deep devotion with significant damage reduction
- Level 100: Maximum relationship with ultimate commitment
Combat Forgiveness System:
- Accidental Hit Protection: Girlfriend no longer attacks the player for accidental hits if relationship level is above 20.
- Reduced Damage: When forgiven, accidental hits from the owner deal reduced damage based on relationship level.
- Appropriate Reactions: Girlfriend expresses forgiveness or hurt based on the context of the attack.
Technical Improvements
RelationshipManager Class:
- Replaces LLM Logic Engine: New modular system separates sentiment analysis, milestone tracking, and bonus calculation.
- InteractionResult Object: Structured response format for AI analysis with reasoning, sentiment, action, and item fields.
- Bonus Multipliers: Dynamic combat damage, healing, and damage reduction multipliers based on relationship level.
- Auto-Heal Owner: High relationship (>40) enables girlfriend to use golden apples from her inventory to heal the owner when injured.
Combat System Refinements:
- ForgivingRevengeGoal: Custom goal that checks relationship level before retaliating against owner attacks.
- Damage Reduction Scaling: Owner-inflicted damage scales from 100% at level 0 to 25% at level 90+.
- Sacrifice System: At relationship >80, girlfriend will take damage for the owner if her health is sufficient.
Known Issues
Current Limitations:
- The girlfriend is unable to give multiple items at once.
- Girlfriend is not able to walkthrough doors most of the time.
- Still somewhat spammy when she sees new mobs.
Credits
Original Project:
- UltimateGamerMC (https://github.com/UltimateGamerMC) - Original Girlfriend Mod (CC0 1.0)
Additions & Modifications:
- minipasila (https://github.com/minipasila) - All 2.0.2 features (GPLv2)
Next Planned Features
Planned for 2.1.0:
- TTS/STT support via KoboldCpp for voice interactions
Full Changelog: v2.0.1-alpha-hotfix...v2.0.2-alpha