# 🎮 BuffMobs v2.5.4 - Changelog
## 🔧 Bug Fixes
### Critical Crash Fix
- **Fixed game-breaking crash** when ranged mobs attempted to switch to melee mode
- Resolved `NoSuchFieldException: goalSelector` error that occurred during mob initialization
- Improved reflection-based AI goal management for better compatibility with Minecraft 1.21.10
### Technical Details
The crash was caused by incompatible field access when the mod tried to manage mob AI goals. This version implements a more robust reflection system that:
- Properly handles protected field access in `MobEntity` class
- Uses method-based goal management instead of direct field manipulation
- Includes fallback mechanisms for better cross-version compatibility
- Adds comprehensive error logging for debugging purposes
## 🛡️ Stability Improvements
### Enhanced AI Management
- Ranged mobs (skeletons, piglins, pillagers) now reliably switch between ranged and melee weapons
- Improved goal selector initialization with better error handling
- Added safety checks to prevent crashes when reflection fails
### Performance
- Optimized reflection initialization (runs once at startup)
- Reduced overhead in mob behavior updates
- Better cleanup of mob states when entities are unloaded
## ✅ What Still Works
All existing features remain fully functional:
- ✨ Progressive mob scaling based on world days
- ⚔️ Dynamic weapon switching for ranged mobs
- 🗡️ Enchantment system with tier progression
- 🌍 Dimension-specific scaling
- 🎯 Custom mob presets
- 📊 Debug commands and monitoring
- ⚙️ Full configuration support via Cloth Config
## 📋 Requirements
### Dependencies
- **Minecraft**: 1.21.10 (Fabric)
- **Fabric API**: Latest version recommended
- **Cloth Config API**: v19.0.147+ (for config GUI)
- **ModMenu**: v13.0.0+ (optional, for in-game config access)
### Important Notes
⚠️ **If you're updating from v2.5.0-2.5.3**: Make sure to also update ModMenu to v13.0.0+ to avoid compatibility issues
⚠️ **Fresh installations**: Install Cloth Config API if you want to use the in-game configuration screen
## 🔄 Migration Guide
### Updating from v2.5.0+
1. Replace `buffmobs-2.5.x.jar` with `buffmobs-2.5.4.jar`
2. Update ModMenu to v13.0.0 or higher (if using)
3. No configuration changes needed - all settings are preserved
### First-Time Installation
1. Install Fabric Loader for Minecraft 1.21.10
2. Download and install Fabric API
3. Download and install Cloth Config API (optional but recommended)
4. Place `buffmobs-2.5.4.jar` in your `mods/` folder
5. Launch the game and configure via ModMenu or edit `config/buffmobs.json5`
## 🐛 Known Issues
None reported for this version. If you encounter any problems, please report them on our issue tracker.
## 💬 Feedback & Support
Found a bug? Have a suggestion?
- Report issues on GitHub
- Check the wiki for configuration guides
---
**Thank you for using BuffMobs! Enjoy the enhanced challenge! 🎮⚔️**
Optional dependencies
Mod Menu
Any compatible version
Developer information
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle.
maven { name = "Modrinth"; url = "https://api.modrinth.com/maven" }