Repository navigation
v2.0.3-beta [MC 1.21.9]
Pre-release
Pre-release
Girlfriend Mod Changelog
Version 2.0.3-beta [MC 1.21.9]
Overview
So this adds a lot of stuff, and is also mostly just QOL stuff. The girlfriend now has better context of the environment though there's still some issues with her sometimes spamming too much or running towards mobs randomly even when those are like really far away. Another issue I gotta figure out how to fix is her basically having X-Ray now..
Deep Awareness Systems (New)
The girlfriend now has significantly enhanced perception of her surroundings:
- Biome Awareness: She detects when she enters a new biome and reacts to the change in scenery or atmosphere.
- Block Awareness: A comprehensive new system (
BlockAwarenessManager) scans nearby blocks and categorizes them. She can now detect and react to:- Ores: Especially reacts with excitement to rare ores (Diamond, Emerald, Ancient Debris).
- Flowers: Comments on nearby flora.
- Housing & Decorations: Notices glass, wool, beds, banners, and other building materials.
- Dangerous Blocks: Warns the player about lava, fire, cactus, etc.
- Decoration Awareness: A new system (
EntityAwarenessManager) allows her to see and comment on:- Paintings: Appreciates the art.
- Item Frames: Comments on displayed items (especially glowing ones).
- Armor Stands: Notices equipment on stands.
- Enhanced Mob Awareness: Improved logic to track mob populations (hostile vs. neutral) and provide summaries rather than reacting to every single individual mob.
Advancement Reactions (New)
- The girlfriend now reacts when you earn advancements/achievements.
- Reactions vary based on the difficulty:
- Tasks: Casual congratulations.
- Goals: Enthusiastic celebration.
- Challenges: Extreme excitement and pride.
- Implemented via a new Mixin (
PlayerAdvancementTrackerMixin).
Door Interaction (New)
- Added a
DoorInteractGoalAI behavior. - She will now automatically open doors, trapdoors, and fence gates when following you.
- She attempts to close them behind her after passing through.
AI & Token Management Improvements
- Accurate Token Counting: Implemented a
TokenCountingServicethat uses actual token usage data from the APIs (Chutes, OpenRouter, KoboldCpp) instead of rough estimates. - Dynamic Context Window: Added configuration for context windows with auto-detection capabilities for different models.
- Smart Summarization: Summarization triggers are now based on calculated token thresholds (configurable percentage of available context) rather than fixed character counts.
- System Prompt Manager: Centralized prompt loading into
SystemPromptManager. This allows for better variable replacement (e.g.,{name},{playerName}) and easier customization. - Context Ordering: Standardized the message structure sent to the AI: System Prompt -> Chat History -> Current Status.
Inventory & Interaction
- Multi-Item Giving: You can now request multiple items at once (e.g., "Give me 10 diamonds and 20 iron"). The
RelationshipManagerparses complex requests and handles partial successes if inventory space is limited. - Enhanced Context: The "Current Status" sent to the AI now includes precise coordinates, facing direction, nearby mob summaries, biome info, and detected blocks/entities.
Configuration & GUI
- Advanced Token Settings: Added new fields in the config and GUI:
- Context Window: Set specific context limits (0 = auto-detect).
- Summarization Threshold: Adjust when memory gets summarized (0.0-1.0).
- Safety Buffer: Reserve a percentage of context for safety.
- Max Generation Tokens: Limit the length of AI responses.
- API Key Masking: API keys in the configuration GUI are now masked (
********) for security. They are only revealed if edited.
Code Structure & Cleanup
- New Classes:
AIResponse,BlockAwarenessManager,EntityAwarenessManager,SystemPromptManager,TokenCountingService,AdvancementEventHandler. - Removed:
COMPLETION_SUMMARY.md(information consolidated intoREADME.md). - Updated:
README.mdreflects new features and removes the raw file structure listing. - Refactoring: Significant cleanup in
ChutesClient,OpenRouterClient, andKoboldCppClientto use the new centralized managers and token tracking.
Credits
Original Project:
- UltimateGamerMC (https://github.com/UltimateGamerMC) - Original Girlfriend Mod (CC0 1.0)
Additions & Modifications:
- minipasila (https://github.com/minipasila) - All v2.X.X features (GPLv2)
Full Changelog: v2.0.2-alpha...v2.0.3-beta