[3.0.3] — buffmobs-3.0.3+mc1.21.11-fabric

🐛 Bug Fix — Compatibility with multithreaded mods

Fixed a crash when running BuffMobs alongside mods that process entities on multiple threads.

BuffMobs internally tracks which mobs have been initialized using HashSet and HashMap structures. These are not thread-safe — when another mod processes entities in parallel, multiple threads can read and write to these collections at the same time, causing a ConcurrentModificationException and crashing the server.

This patch replaces all affected collections in MobTickHandler with their thread-safe equivalents (ConcurrentHashMap / ConcurrentHashMap.newKeySet()). No behavior, configuration, or feature has been changed — only the underlying data structures.

---

✅ Confirmed fix

• Async — Fabric mod that parallelizes entity processing for better performance. Running Async + BuffMobs previously caused consistent crashes at startup or during play.

🔧 Likely fix for similar mods

Any mod that moves entity ticking or world ticking to worker threads may have triggered this same issue. This includes mods such as:

• Lithium (with certain async optimizations)
• FerriteCore (memory/threading optimizations)
• Other performance mods that offload entity processing

If you were experiencing random ConcurrentModificationException crashes with any of these in your modpack, this update should resolve it.

---

📋 Related

• Issue reported by the community: #12 — Crash with Async mod
• Special thanks to the humidityorder for identifying the root cause and providing the necessary details to track it down. 🙏

---

📦 Source & Issues: github.com/Khotyz/BuffMobs 🐛 Found another bug? Open an issue on GitHub!

It's the same as 1.21.1

Changelog

---

buffmobs-3.0.2+mc1.21.1-fabric

⚔️ New: Combat Draft

Mobs now drink a potion when they're about to die. When a mob's health drops low enough, it pulls out a regeneration potion and heals itself — complete with a drinking animation and sound. Undead mobs can't benefit from regeneration, so they get an absorption shield and a direct heal instead. You can configure how low their health needs to be, how strong the heal is, how long the cooldown is, and even limit how many times a mob can use it per life.

🛡️ New: Absorption Hearts

Mobs can now be granted absorption hearts as a status effect — the yellow hearts that act as a shield before real health is lost. Works differently for undead mobs, which receive the shield directly instead of through the effect.

🎯 New: Kite Behavior

Ranged mobs now have a second close-range behavior option: instead of switching to a sword, they can flee to maintain their shooting distance. You can set all ranged mobs to kite, all to melee, or let each mob randomly pick one when it spawns.

🧩 New: Mob Presets

You can now assign custom stat profiles to individual mobs by ID. For example, make the Ender Dragon 3× tougher and the Wither hit twice as hard, while a zombie stays at default strength. Four presets come built-in (default, boss, elite, weak) and there's a fifth empty slot for whatever you need. Preset stats stack on top of the global multipliers.

🌍 New: Per-Dimension Scaling

Each dimension can now have its own separate multipliers for health, damage, speed, and armor. Going to the Nether? Mobs can be twice as tough there. The End? Even harder. Up to 5 dimensions can be configured independently.

🔍 New: Mod ID Filter

Beyond filtering by mob ID or dimension, you can now filter by the mod that added the mob. Want to buff only vanilla mobs? Or only mobs from a specific mod? Both are possible.

📅 Improved: Day Scaling Notifications

You can now choose whether to receive a chat notification every single day, or only on the days when the difficulty actually increases.

🔧 Improved: /buffmobs reload

Running /buffmobs reload now also reloads the config file from disk, so you can change settings and apply them without restarting the server.

🐛 Bug Fixes

• Mob buffs are now properly removed when the mod is disabled while the game is running.
• Fixed a bug where ranged mobs in melee mode could stack speed boosts on top of each other.
• Fixed absorption shields not holding their value correctly between game ticks.
• Invalid preset mappings in the config now show a clear warning in the log instead of failing silently.

---

🐛 Found a bug? Report it here. 📦 Mod Repository

BuffMobs v3.0.2+mc1.21.1-neoforge

🐛 Bug Fixes

Ranged/Melee Switching & CombatDraft not working with other mods

The root cause was a critical flaw in the mob initialization system that prevented both features from ever activating in a modded environment.

• Fixed: Mobs were never being registered as initialized. The PENDING_INIT queue used a shared list across all dimensions. Since LevelTickEvent fires separately for each loaded dimension, the tick from any dimension (e.g. The Undergarden, AE2 Spatial Storage) would clear the entire queue before the correct dimension had a chance to process it — so mobs were silently dropped and never set up.
• Fixed: The per-dimension tick counter was running up to 6× too fast. With 6 active dimensions each firing LevelTickEvent, the global counter advanced 6 ticks per real tick. The 20-tick update cycle (AI behavior, CombatDraft checks) was running far more often than intended.
• Both features now work correctly alongside mods that add extra dimensions (Deeper and Darker, The Undergarden, AE2, etc.).

/buffmobs reload not fully reinitializing mobs

After a reload, mobs had their buffs reapplied but were not re-registered in the initialization tracker. This caused the tick system to attempt reinitializing them again on the next cycle, which could double-apply buffs. The command now correctly re-registers mobs after reapplying all buffs, AI setup, and CombatDraft state.

The configured version has also been fixed, thanks to dustfired Issue #11

---

Found a bug or have a suggestion? Open an issue on GitHub.

BuffMobs v3.0.1+mc1.21.1-neoforge

🆕 New Features

CombatDraft

Mobs now drink a potion when they fall below a configurable health threshold, triggering a burst of regeneration to keep the fight going. Fully configurable — health threshold, regen level, duration, cooldown, max uses per life, and a per-mob whitelist/blacklist.

• Living mobs receive Regeneration when low on health.
• Undead mobs receive Absorption + a direct heal, since Regeneration harms them.
• The potion effect stacks on top of the mob's existing buff level — if a mob already has Regen I and CombatDraft is set to level 3, it temporarily gains Regen IV, then returns to baseline when it expires.
• Full drink animation and sound, just like a player.

Ranged/Melee Switching

Ranged mobs (skeletons, pillagers, piglins, strays) now react when a player gets too close, instead of just standing there shooting. Three behavior modes:

• MELEE — switches to a sword and chases the player.
• KITE — retreats to maintain distance and keep shooting.
• RANDOM — each mob independently picks one of the two above on spawn.

Switch distance, melee speed, and which mobs count as "ranged" are all configurable. You can also add custom mob IDs to the ranged list.

Melee Weapon Progression

When a ranged mob switches to melee mode, it equips a generated weapon based on how many in-game days have passed and which dimension it's in. Weapon tiers and their unlock days are fully configurable. Weapons can also receive enchantments that scale with progression — Sharpness, Fire Aspect, Knockback, and Sweeping Edge, each with their own unlock day and max level.

Mob Presets

Assign custom stat multipliers to specific mobs. Define up to 5 named presets (e.g. boss, elite, weak) and map any mob ID to one of them. Preset multipliers stack on top of the global settings, so a boss zombie can be dramatically stronger than a regular one.

Dimension Scaling

Configure separate stat multipliers for up to 5 dimensions. Mobs in the Nether or End can have different health, damage, speed, and armor values than Overworld mobs.

Absorption for Undead

Undead mobs with the Absorption amplifier configured receive a proper extra health shield that depletes before their normal HP — same behavior as the player effect.

---

⚙️ Config Screen (Cloth Config)

The in-game GUI now covers every available setting, organized into collapsible subcategories. Every option has a tooltip describing what it does.

---

Found a bug or have a suggestion? Open an issue on GitHub.

Added cloth config api support for in-game configuration :)

BuffMobs 3.0.0mc1.21.11 — Changelog

Hey everyone! Sorry for the delay on this release, Mojang made a lot of breaking changes between 1.21.10 and 1.21.11 that took a while to sort out. It's finally here though, and this version comes with a brand new feature I think you'll really enjoy. Details below. Don't worry, now that I've finally sorted out the mod's package structure, 3.0 will be coming to other versions too. Thanks for using the mod!

For bug reports and suggestions: GitHub Issues | Repository

---

🆕 New Features

CombatDraft

Hostile and neutral mobs will now drink a regeneration potion when their health drops below a configurable threshold (default: 20% HP).

• Uses the vanilla drink animation and sound, identical to a player drinking a potion
• Living mobs receive Regeneration IV for 10 seconds by default
• Undead mobs receive Absorption + an instant heal instead, since Regeneration damages them
• Cooldown between uses and a max uses per life option (0 = unlimited)
• Supports whitelist and blacklist to control which mobs can use it
• Slime, Magma Cube and Ghast are permanently excluded

Ranged Mob Behavior — Kite Mode

Ranged mobs now have a second close-range behavior option alongside the existing melee switch.

• MELEE — ranged mobs equip a sword when the player gets close
• KITE — ranged mobs flee to maintain a safe shooting distance while still looking at the player
• RANDOM (default) — each mob individually picks MELEE or KITE on spawn, creating natural variety

---

🔧 Improvements & Fixes

Attribute Scaling — All Layers Now Stack

Previously, Presets completely overrode Attributes and Dimension Scaling. Now all three layers always stack:

• Multipliers (HP, damage, speed, attack speed): attributes × dimension × preset × day
• Flat additions (armor, toughness): (attributes + dimension + preset) × day

Status Effects

• Speed effect was present in the config but was never actually applied to mobs — fixed
• Absorption added as a new configurable effect option
• Regeneration is now correctly skipped for undead mobs across all code paths

Mob Initialization

Buffs were silently failing on freshly spawned mobs because they were being applied before the mob's attributes were fully registered. Fixed by deferring the buff to the next tick after the mob joins the world.

Ranged Mob Return to Ranged Mode

Mobs in melee mode were not reliably switching back to ranged when the player moved away. Fixed by resetting the mob's target and navigation on exit, adding a 2.5 block hysteresis margin, and increasing the mode switch cooldown to 3 seconds.

Build Version

The version string is now auto-generated as {mod_version}mc{minecraft_version} (e.g. 3.0.0mc1.21.11), applied to both the JAR filename and the version shown in-game.

---

⚙️ New Config Options

Section	New options
effects	speedAmplifier, absorptionAmplifier
rangedMeleeSwitching	behaviorMode (MELEE / KITE / RANDOM)
combatDraft	enabled, healthThreshold, regenAmplifier, regenDuration, cooldownTicks, maxUses, useWhitelist, whitelist, blacklist

Changelog

[2.5.9] - Bug Fix Release

This release focuses on fixing the preset system and config persistence issues reported in Issue #10.

---

🐛 Bug Fixes

Preset toggle no longer breaks mob stats

Previously, disabling the mob preset system (or setting all multipliers to 1.0) could cause mobs to spawn with double or triple their intended health. This happened because old stat modifiers were being saved to the mob's data and never properly cleaned up when presets were turned off.

Config changes now save and load correctly

Filters (mob, mod ID, and dimension) and preset mappings were using a data structure that the config library couldn't write back to. This meant any changes made to these lists including resetting to defaults would silently revert the next time the game launched. All affected fields have been fixed to use a compatible structure.

Mobs from previous sessions are now corrected on startup

When a server restarts, all loaded mobs are now re-evaluated against the current config. This ensures that mobs carrying leftover stat boosts from an older config (e.g., before disabling presets) get cleaned up automatically rather than keeping inflated stats forever.

Disabling the mod now properly removes all stat boosts

When the mod is disabled in config, mobs that had already been buffed will now have those bonuses removed. Previously, disabling the mod only prevented new buffs from being applied existing ones stayed.

---

⚙️ Technical Details

• Fixed immutable list fields in BuffMobsConfig (mobFilter, modidFilter, dimensionFilter, mobPresets.mobMapping) that prevented the Jankson config serializer from saving user changes
• Added removeAllModifiers() to properly strip all mod-applied attribute modifiers from a mob
• Attribute modifier methods now always remove any existing modifier before deciding whether to apply a new one, preventing stacked modifiers from persisting across restarts
• MobTickHandler now performs a forced re-evaluation of all existing mobs on server start (forceReapply = true), ensuring stale NBT data from previous sessions is overwritten
• Simplified multiplier calculation logic that was incorrectly short-circuiting to 1.0 for presets with base multiplier ≤ 1.0, leaving old modifiers untouched

BuffMobs v2.5.8

🐛 Bug Fixes

Fixed Ranged Mob AI System Crash

• Resolved: Critical reflection error that prevented the mod from working in server environments (#9)
• Issue: The ranged-to-melee switching feature was causing crashes with NoSuchMethodException in retail Minecraft
• Fix: Improved reflection system to work with obfuscated method names in production builds
• The mod now works flawlessly in both development and retail Minecraft environments

📝 Technical Details

The ranged mob AI manager has been updated to detect methods by their signature rather than by name, ensuring compatibility across all Minecraft environments regardless of obfuscatio

[2.5.7] - Ranged/Melee Switching Overhaul

Full source available at github.com/Khotyz/BuffMobs

---

🗡️ Ranged/Melee Switching — Fixed & Reworked

The ranged/melee switching system has been completely overhauled. Skeletons, Strays, Piglins, and Pillagers will now properly switch to a melee weapon when you get close, fight you in melee, and switch back to their ranged weapon when you back away.

What was broken:

• Mobs would enter melee mode but never actually attack
• The goal injection system silently failed on startup, meaning the melee AI was never active
• Switching back to ranged mode sometimes gave the mob the wrong weapon

What changed:

• Rebuilt the AI goal injection using reliable reflection — the system now logs clearly on startup whether it initialized successfully or not
• Melee mode now correctly sets the player as the mob's target and drives them toward you
• Switching back to ranged mode always restores the mob's original weapon (bow or crossbow) correctly
• Wither Skeletons removed from the ranged mob list — they are melee-only by nature and were causing erratic behavior
• The cleanup on mob unload now also removes the injected melee goal, preventing ghost AI goals from persisting

---

⚔️ Weapon Progression — Fixed

Melee weapon tiers (Stone → Iron → Diamond → Netherite) are now unlocked based on the actual world day, regardless of whether Day Scaling is enabled in the config. Previously, weapon tiers were calculated from the day scaling multiplier, which meant all tiers above Stone Sword were locked forever when Day Scaling was turned off.

---

🔧 Other Improvements

• Enchantment level progression now also uses real world days instead of the scaling multiplier
• Enchantment count scaling thresholds adjusted to be relative to the configured day interval, making them consistent across different scaling setups

BuffMobs v2.5.6 - Fabric 1.21.6 - 1.21.8

---

📢 Developer Note

Hello! This update brings all the features that existed in previous versions of the mod. Although it's not fully functional yet, I did my best :p

---

✨ What's New

🎯 Fabric 1.21.6 - 1.21.8 Port

• Complete port of BuffMobs to Minecraft 1.21.6 - 1.21.8 (Fabric)
• Rewritten codebase to work with the latest Fabric API
• Updated dependencies and mappings

🤖 Ranged Mob AI System (Experimental)

• Tactical Retreat System: Ranged mobs now intelligently retreat when players get too close

  • Mobs will run away to maintain safe distance before shooting
  • Configurable safe distance thresholds
  • Panic mode when player gets extremely close

• Kiting Behavior: Optional strafing movement while shooting

  • Mobs can move laterally while attacking
  • Makes ranged combat more dynamic and challenging
  • Fully configurable strafe intervals and patterns

• Adaptive Combat Modes:

  • ADAPTIVE: Switches between melee and ranged based on distance
  • MELEE_ONLY: Always engages in close combat
  • RANGED_ONLY: Maintains distance and shoots
  • RANDOM: Randomly chooses behavior per mob

⚔️ Enhanced Melee Switching

• Ranged mobs can switch to melee weapons when players get close
• Weapon progression system based on world days
• Enchantment progression for generated weapons
• Configurable switch distance thresholds

🔧 Configuration Improvements

• New tactical movement settings
  • Maintain distance
  • Retreat speed
  • Panic distance and speed
  • Strafe toggle and interval
• Better organized config categories
• Improved tooltips and descriptions

🎮 Mod Compatibility

• Works with custom ranged mobs through whitelist system
• Compatible with mob presets
• Supports dimension-specific scaling
• Mod ID filtering support

---

🔄 Changes

Performance

• Optimized mob initialization system
• Improved tick handling for large mob counts
• Better memory management for mob states

AI Behavior

• Natural movement animations during retreat
• Smooth transitions between combat states
• Better pathfinding for tactical positioning

Combat Balance

• Adjusted arrow shooting intervals (30-50 ticks)
• Speed scaling based on distance from player
• More responsive retreat triggers

---

🐛 Known Issues

• Tactical Movement: Mob auto-attack may reset instead of firing when using tactical movement system
• Some animation glitches during rapid state transitions
• Occasional pathfinding hiccups on complex terrain

---

📦 Technical Details

Supported Mobs

• Skeleton (all variants)
• Pillager
• Piglin
• Custom mobs via config whitelist

Requirements

• Minecraft 1.21.6 - 1.21.8
• Fabric Loader 0.16.0+
• Fabric API
• Cloth Config (optional, for GUI configuration)

---

🛠️ For Modpack Developers

All tactical movement features can be disabled in the config if you experience issues:

"rangedMeleeSwitching": {
  "enabled": true,
  "tacticalMovement": {
    "enabled": false  // Set to false to use vanilla behavior
  }
}

---

💬 Feedback

This is an experimental port with many new features. Please report any issues you encounter on our issue tracker!

Known limitations are actively being worked on for future updates.

---

📝 Full Changelog

• Added complete Fabric 1.21.6 - 1.21.8 support
• Added tactical retreat AI system
• Added kiting/strafing behavior
• Added adaptive combat mode switching
• Added melee weapon generation system
• Added enchantment progression
• Improved mob initialization and tracking
• Optimized performance for large mob counts
• Fixed various crashes and compatibility issues
• Updated to latest Fabric API standards

---

Thank you for using BuffMobs! Your patience with experimental features is appreciated.

BuffMobs – 2.5.5 🎉

• ✅ Compatibility Update: The mod is now fully functional with the latest version of Minecraft.
• 🛠️ Stability: Everything is running smoothly so far. If you encounter any issues, please report them on the GitHub Issues page: https://github.com/Khotyz/BuffMobs/issues
• 🎨 UI Tweaks: Minor adjustments were made to the ModMenu HUD, though nothing major has changed.

Thank you for using BuffMobs, and Happy New Year! 🎆

🎮 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! 🎮⚔️

BuffMobs v2.5.3 - Hotfix🔧 Major Fixes

Configuration System Completely Rebuilt

The configuration system has been completely rewritten to fix persistent issues with settings not saving properly.

What was fixed:

• ✅ Configuration values now persist correctly - Your settings will no longer reset when you change them
• ✅ Dimension Scaling saves correctly - Setting up dimension-specific multipliers now persists properly
• ✅ All filter lists work as expected - Blacklists and whitelists for mobs, mods, and dimensions now save correctly

Blacklist/Whitelist System Fixed

The mob filtering system has been completely overhauled:

• ✅ Blacklists now work correctly - Mobs in the blacklist will no longer receive buffs
• ✅ /buffmobs reload now removes buffs - When you reload, mobs that are now blacklisted will have their buffs removed
• ✅ Supports both ID formats - Works with both modern (minecraft:zombie) and legacy (EntityType{minecraft:zombie}) mob IDs
• ✅ Real-time filtering - Changes take effect immediately after using /buffmobs reload

🎮 Configuration Changes

Dimension Scaling - Simplified Values

Dimension scaling now uses direct multipliers instead of percentages for easier configuration:

Before (v2.5.2 and earlier):

healthMultiplier = 200  # 200% = double health
damageMultiplier = 150  # 150% = 1.5x damage

Now (v2.5.3):

healthMultiplier = 2.0  # 2.0 = double health
damageMultiplier = 1.5  # 1.5x damage

This makes the values more intuitive and easier to understand at a glance.

Clean Default Configuration

All configuration lists now start empty by default:

• Mob Presets: No default mappings - add only what you need
• Mob Filter: Empty blacklist and whitelist by default
• Mod ID Filter: Empty lists
• Dimension Filter: Empty lists
• Custom Ranged Mobs: Empty list

Why this matters: You now have complete control over your configuration without having to remove unwanted default values first.

🐛 Bug Fixes

/buffmobs reload Command

• Fixed: Command now properly removes buff modifiers before reapplying them
• Fixed: Mobs in the blacklist now have their buffs completely removed when you reload
• Added: Shows count of buffed vs unbuffed mobs after reload
• Added: Properly resets mob health after removing buffs

Debug Command Improvements

• Fixed: /buffmobs debug now shows correct mob IDs in both formats
• Added: Shows why a mob is filtered (blacklist, whitelist, etc.)
• Improved: Better formatting and more detailed information

Configuration Persistenc

• Fixed: Changing dimension names no longer resets multipliers
• Fixed: All list-based configurations now save properly
• Fixed: Configuration changes through Configured mod now persist correctly

📝 Configuration Notes

Important for Existing Users

If you're updating from v2.5.2 or earlier:

1. Backup your config first: config/buffmobs-common.toml
2. Delete the old config file to generate the new format
3. Reconfigure your settings using the new format

Dimension Scaling conversion:

• Old 200 (200%) → New 2.0 (2x multiplier)
• Old 150 (150%) → New 1.5 (1.5x multiplier)
• Old 100 (100%) → New 1.0 (no change)

For New Users

The mod now starts with a completely clean configuration. Simply enable the features you want and configure them to your liking without needing to clear out default values first.

🔍 Testing Your Configuration

After updating, use these commands to verify everything works:

/buffmobs info          - Check current configuration status
/buffmobs debug         - Check a nearby mob's buff status
/buffmobs reload        - Reload all mobs with current config
/buffmobs presets       - View all configured presets

📦 Download

• CurseForge: BuffMobs on CurseForge
• Modrinth: BuffMobs on Modrinth
• GitHub: BuffMobs Repository

🐛 Report Issues

Found a bug? Please report it on:

• GitHub Issues: Create an issue
• CurseForge: Use the issues tab on the mod page
• Modrinth: Use the issues tab on the mod page

---

Thank you for using BuffMobs! Your feedback helps make this mod better.

Buff Mobs Version 2.5.2 (Minecraft 1.21.1)

🎯 Major Features

Mob Preset System

• Custom preset configurations for specific mobs with fine-tuned stats
• 5 preset slots available: default, boss, elite, weak, and custom
• Presets now stack with base multipliers and dimension scaling
  • Allows precise balancing without losing your base configuration
• Easy mob mapping: minecraft:zombie:weak format
• Toggle presets via dropdown menu (similar to behavior mode)

Ranged/Melee Combat System

• Tactical Retreat Mode: Ranged mobs intelligently retreat while maintaining distance
  • No melee attacks during retreat (pure ranged combat)
  • Configurable retreat speed and distance
• Melee Switch Mode: Ranged mobs switch to melee weapons when players get close
  • Progressive weapon tiers unlock based on world days
  • Enchantment system scales with game progression
• Random Mode: Each mob randomly chooses between melee or retreat behavior

Day-Based Progression

• Mobs become progressively stronger as days pass
• Configurable intervals and maximum multipliers
• In-game notifications for scaling milestones
• Affects all mob stats including preset configurations

🛠️ Technical Improvements

Configuration System

• Full compatibility with Configured mod (no more validation errors)
• Simplified configuration structure with enum toggles
• Lists properly persist when toggling settings on/off
• Fixed range validation issues (now supports values < 1.0 for weak presets)

Mob Detection & Targeting

• Uses official Minecraft ResourceLocation registry for mob identification
• Fixed entity ID format issues
• Improved mob type validation and filtering

Performance & Stability

• Optimized mob initialization system
• Better handling of mob spawning and despawning
• Reduced unnecessary buff recalculations
• Fixed memory leaks in mob state tracking

🎮 Gameplay Changes

Status Effects

• Status effects (Strength, Resistance, Regeneration) always apply regardless of preset
• Infinite duration effects properly refresh
• Visual particles can be toggled for performance

Dimension Scaling

• Dimension-specific multipliers now properly combine with presets
• Fixed calculation order: Base → Preset → Dimension → Day Scaling
• Supports custom dimensions from mods

Harmful Effects on Players

• Mobs can inflict random debuffs (Poison, Slowness, Wither)
• Configurable chance per hit (default: 15%)
• Adjustable duration for each effect type

🐛 Bug Fixes

• Fixed preset system not applying base multipliers
• Fixed dimension scaling being ignored when using presets
• Fixed config validation errors with Configured mod
• Fixed mob ID format in debug commands showing incorrect format
• Fixed list configurations being cleared when toggling settings
• Fixed range validation preventing values below 1.0
• Fixed retreat mode mobs dealing melee damage when approached
• Fixed attribute modifiers not using correct operation types
• Fixed enchantment application system for 1.21.1 API changes

📊 Debug & Commands

• /buffmobs debug - Show detailed info about nearby mob
• /buffmobs presets - List all configured presets and mappings
• /buffmobs testpreset - Validate preset configuration
• /buffmobs info - Display current mod settings
• /buffmobs reload - Reapply buffs to all loaded mobs

🔧 Configuration Guide

Example Preset Setup:

[mobPresets]
    enabled = "ENABLED"

    mobMapping = [
        "minecraft:zombie:weak",
        "minecraft:skeleton:elite",
        "minecraft:ender_dragon:boss"
    ]

    [mobPresets.preset4]
        presetName = "weak"
        healthMultiplier = 0.5
        damageMultiplier = 0.5
        speedMultiplier = 0.9

Behavior Modes:

• MELEE - Switch to melee weapons when close
• RETREAT - Back away while shooting
• RANDOM - Random choice per mob

📝 Notes

• All base game mechanics preserved
• Compatible with most mob-adding mods
• Default configurations provide balanced difficulty increase

---

Report Issues: GitHub Issues

BuffMobs v2.5.1 - Tactical Retreat Update

🎯 What's New

✨ Tactical Retreat System

Ranged mobs (skeletons, piglins, pillagers) can now intelligently retreat when players get too close, creating more dynamic and challenging combat encounters!

New Behavior Modes:

• Melee Mode (default): Ranged mobs switch to melee weapons when close, just like before
• Retreat Mode (NEW!): Ranged mobs tactically back away 8-12 blocks while continuing to shoot
• Random Mode (NEW!): Each mob randomly chooses between melee or retreat behavior when spawned

How it works:

• When a player gets within the configured distance (default: 4 blocks), the mob activates its behavior
• In Retreat mode, mobs back away for 3 seconds (configurable), then have a 5-second cooldown
• Mobs maintain eye contact with the player while retreating
• Smart pathfinding ensures mobs don't retreat into walls or dangerous areas

⚙️ New Configuration Options

Ranged/Melee Switching:

• behaviorMode: Choose "melee", "retreat", or "random" (default: "melee")
• retreatSpeed: How fast mobs retreat (default: 1.2 = 20% faster than normal)
• retreatDuration: How long mobs retreat in ticks (default: 60 = 3 seconds)

Example configurations:

# Aggressive melee rushers
behaviorMode = "melee"

# Tactical kiting mobs
behaviorMode = "retreat"
retreatSpeed = 1.5
retreatDuration = 80

# Unpredictable variety
behaviorMode = "random"

🔧 Technical Details

New Files Added:

• RangedBehaviorMode.java - Enum defining the three behavior modes
• TacticalRetreatGoal.java - Custom AI goal for retreat behavior

Updated Systems:

• RangedMobAIManager.java - Now supports all three behavior modes
• BuffMobsConfig.java - Added new retreat configuration options
• Enhanced mob state tracking to remember chosen behavior

Performance:

• Retreat AI only activates when needed
• Built-in cooldowns prevent excessive pathfinding calculations
• No performance impact when using melee mode

🎮 Use Cases

PvE Difficulty Servers: Use melee mode for aggressive close-combat challenges where skeletons rush players with swords.

Tactical Combat Servers: Use retreat mode to make ranged mobs harder to reach, forcing players to use strategy and positioning.

Variety Servers: Use random mode to keep players on their toes - you never know if a skeleton will charge or kite!

🔄 Compatibility

✅ Fully backward compatible - If you don't change the config, the mod works exactly as before
✅ Works with all existing features - Day scaling, dimension scaling, presets, weapon progression
✅ Works with all supported mobs - Skeletons, Strays, Wither Skeletons, Piglins, Pillagers, and custom ranged mobs
✅ NeoForge 1.21.10 - Fully ported from Fabric with all features intact

📋 Full Feature List

Core Systems:

• Configurable attribute multipliers (Health, Damage, Speed, Attack Speed, Armor, Toughness)
• Day-based progressive difficulty scaling
• Dimension-specific scaling with 5 customizable slots
• Mob preset system for specific mob types
• Comprehensive filtering (mobs, mods, dimensions)

Combat Systems:

• Ranged/Melee AI switching with three behavior modes (NEW!)
• Progressive weapon unlocking system
• Enchantment progression system
• Harmful effects on players (Poison, Slowness, Wither)

Configuration:

• Native NeoForge TOML configuration
• Detailed in-file comments for every option
• Hot-reloadable with /reload command
• Debug commands for testing and troubleshooting

🐛 Bug Fixes

• Fixed MobEffects API calls for NeoForge 1.21.10
• Fixed enchantment registry access
• Fixed PathfinderMob compatibility in retreat AI
• Corrected all effect names (STRENGTH, RESISTANCE, SLOWNESS)

📖 Documentation

Full documentation available in the config file with detailed comments explaining every option.

Need help?

• Check the config comments for detailed explanations
• Use /buffmobs debug to inspect nearby mobs
• Report issues on GitHub

🔗 Links

• Download: Modrinth | CurseForge
• Source Code: GitHub
• Report Issues: GitHub Issues

---

Minecraft Version: 1.21.10
Mod Loader: NeoForge 21.10.41+
License: MIT

Thank you for using BuffMobs! If you enjoy the mod, consider leaving a like on Modrinth or CurseForge.

BuffMobs Changelog

Version 2.5.0 - The Preset Update

🎯 Major Features

Mob Preset System ⭐ NEW

• Added a powerful new preset system that allows you to create custom buff profiles for specific mobs
• Create up to 5 different presets with unique multipliers for:
  • Health (0.5x - 100x)
  • Damage (0.5x - 100x)
  • Speed (0.5x - 10x)
  • Attack Speed (0.5x - 10x)
  • Armor (+0 to +30)
  • Armor Toughness (+0 to +20)

Flexible Mob Mapping

• Map any mob to any preset using an easy-to-edit list format
• Format: minecraft:zombie:preset_name
• Example configurations included:
  • default preset for common mobs
  • boss preset for bosses (3x health, 2.5x damage)
  • elite preset for mid-tier mobs (2x health, 1.8x damage)
  • weak preset for easy mobs (0.5x health, 0.5x damage)

Priority System

When presets are enabled, buff application follows this priority:

1. Mob-specific preset (if mapped)
2. Dimension scaling (if no preset)
3. Default buffs (if no preset or dimension scaling)

🛠️ Improvements

Enhanced Debug Commands

• /buffmobs debug - Now shows detailed preset information for nearby mobs
  • Displays if a preset is active
  • Shows all preset values being applied
  • Suggests mapping format if no preset found
  • Lists available mappings for reference
• /buffmobs presets - NEW COMMAND
  • View all configured presets at a glance
  • See all mob-to-preset mappings
  • Identify invalid mappings instantly

Better Configuration

• Presets are fully configurable via in-game GUI (requires Cloth Config)
• Each preset can be named and customized individually
• Mob mappings can be edited directly in the config screen
• Invalid mappings are detected and logged

New section in config/buffmobs.json5:

"mobPresets": {
  "enabled": false,  // Set to true to enable
  "preset1": { ... },
  "preset2": { ... },
  "mobMapping": [
    "minecraft:zombie:default",
    "minecraft:skeleton:default"
  ]
}

💡 Use Cases

• Boss Fights: Create super-strong presets for boss mobs
• Difficulty Tiers: Set different power levels for different mob types
• Modpack Balance: Fine-tune individual mob difficulties
• Custom Challenges: Make specific mobs stronger or weaker
• Dimension Variety: Combine with dimension scaling for complex progression

📝 Notes

• Presets are disabled by default to maintain compatibility with existing configs
• Presets work seamlessly with day scaling - multipliers stack
• Unmapped mobs continue to use dimension/default scaling as before
• Debug logging added for troubleshooting preset application

🔧 Compatibility

• Minecraft: 1.21.9 - 1.21.10 (Fabric)
• Required: Fabric API
• Optional: Cloth Config API v19.0.147+ (for in-game configuration)
• Compatible: All existing BuffMobs configurations

---

How to Use Presets

1. Enable the system: Set mobPresets.enabled to true in config
2. Configure presets: Edit preset1-5 with your desired multipliers
3. Name your presets: Give each preset a unique name (e.g., "boss", "elite")
4. Map mobs: Add entries to mobMapping in format: mobid:presetname
5. Test in-game: Use /buffmobs debug to verify preset application
6. Reload if needed: Use /buffmobs reload to reapply buffs

Example Configuration

"preset1": {
  "presetName": "boss",
  "healthMultiplier": 5.0,
  "damageMultiplier": 3.0,
  "speedMultiplier": 1.3,
  "attackSpeedMultiplier": 1.5,
  "armorAddition": 15.0,
  "armorToughnessAddition": 8.0
},
"mobMapping": [
  "minecraft:wither:boss",
  "minecraft:ender_dragon:boss",
  "minecraft:warden:boss"
]

---

BuffMobs v2.4.10 - Compatibility Update

🎮 Minecraft Version Support

• ✅ Minecraft 1.21.9 - 1.21.10 (Fabric)
• Full compatibility with the latest Minecraft versions

---

🔧 Technical Updates

API Compatibility Fixes

• Fixed critical compatibility issues with Minecraft 1.21.9-1.21.10 API changes
• Updated all entity position and world access methods to match new Minecraft standards
• Resolved getWorld() → getEntityWorld() deprecation across entire codebase
• Fixed entity position retrieval methods for proper mob behavior

Core System Improvements

• Ranged/Melee AI System: Completely overhauled for 1.21.10 compatibility

  • Fixed position tracking for mob weapon switching
  • Improved melee attack calculations
  • Enhanced target acquisition and combat behavior

• Mob Buff System: Updated to use latest entity attribute APIs

  • All attribute modifiers now properly apply
  • Dimension multipliers working correctly
  • Day scaling calculations optimized

• Debug Commands: Fully functional with new world access patterns

  • /buffmobs debug - Works perfectly with updated entity system
  • /buffmobs reload - Properly refreshes all mob buffs
  • /buffmobs info - Displays accurate system information

Configuration System

• Improved error handling for missing dependencies
• Better fallback behavior when Cloth Config is unavailable
• Maintained full backward compatibility with existing configs

---

🐛 Bug Fixes

• ✅ Fixed Cannot resolve method 'getWorld' errors in all manager classes
• ✅ Fixed Cannot resolve method 'getPosition' errors in ranged AI
• ✅ Fixed isClient private access violations in world checks
• ✅ Resolved entity position tracking issues in melee combat
• ✅ Fixed weapon switching not working properly for ranged mobs

---

🎯 Features (Still Working!)

All existing features remain fully functional:

• ✅ Dynamic Mob Buffs - Health, damage, speed, armor, and toughness multipliers
• ✅ Day-Based Scaling - Progressive difficulty increase over time
• ✅ Dimension Scaling - Custom multipliers per dimension (Nether, End, modded)
• ✅ Ranged/Melee Switching - Skeletons and ranged mobs use melee weapons up close
• ✅ Weapon Generation - Automatic weapon creation with enchantments
• ✅ Harmful Effects - Chance to apply poison, slowness, or wither to players
• ✅ Status Effects - Strength, resistance, and regeneration for mobs
• ✅ Advanced Filtering - Whitelist/blacklist for mobs, mods, and dimensions
• ✅ Debug Tools - Comprehensive in-game debugging commands
• ✅ ModMenu Integration - Full configuration GUI support

---

📝 Notes

For Server Owners

• This update is 100% backward compatible with existing configurations
• No world or config migration needed
• Recommended for all servers running Minecraft 1.21.9+

For Modpack Developers

• All filtering systems working as intended
• Compatible with other mob enhancement mods
• Performance optimized for large modpacks

Known Limitations

• Cloth Config API is optional but recommended for GUI configuration
• Without Cloth Config, manual JSON editing is required
• Some visual effects may require client-side installation

---

🔄 Migration Guide

From v2.4.x to v2.4.10

1. Simply replace the mod file
2. No config changes needed
3. Restart server/client
4. All features will work immediately

From v2.3.x or older

• Your existing buffmobs.json5 config will be automatically preserved
• All settings will be migrated seamlessly
• Review new options in the config for additional features

---

🚀 Download

• CurseForge
• Modrinth
• GitHub

---

💬 Support

Having issues? Need help?

• 📝 Report bugs on GitHub
• 📖 Check the Wiki

---

🙏 Credits

Thanks to everyone who reported compatibility issues and helped test this release!

Enjoy your enhanced survival experience! 🎮⚔️

---

Full Changelog

v2.4.10 (October 2024)

• Updated for Minecraft 1.21.9-1.21.10
• Fixed all API compatibility issues
• Improved code stability and error handling
• Maintained feature parity with previous versions

BuffMobs v2.4.9 - Complete Overhaul

🎉 Major Changes

Core System Rewrite

• Complete rewrite of the mob buffing system using Fabric API events instead of Mixins
• No more crashes - eliminated all Mixin-related compatibility issues
• Better performance - more efficient mob tracking and buff application
• Improved compatibility with other mods

All Mobs Now Supported

• Fixed: Buffs now apply to ALL hostile and neutral mobs from Minecraft and mods
• Fixed: Mobs that already exist in the world when you load are now properly buffed
• Fixed: Dimension scaling now works correctly across all dimensions
• Better detection of modded mobs with custom AI

Ranged-to-Melee Combat System Fixed

• Fixed: Ranged mobs (Skeletons, Pillagers, etc.) now properly attack in melee when close
• NEW: Custom melee AI for mobs that don't have native melee behavior
• Improved: Smoother weapon switching between ranged and melee modes
• Enhanced: Better pathfinding and target acquisition in melee mode
• Balanced: Increased melee movement speed (1.3x) for more aggressive close combat

✨ New Features

Debug Commands

• NEW: /buffmobs debug - Check buff status of nearby mobs
  • Shows health, damage, multipliers, and active effects
  • Helpful for troubleshooting and configuration
• NEW: /buffmobs reload - Reapply buffs to all mobs in the world
• NEW: /buffmobs info - Display current mod configuration

Better Logging

• Added detailed debug logs for troubleshooting
• Shows which mobs are being initialized
• Displays dimension scaling information
• Logs weapon switching events

🔧 Configuration Changes

Default Settings Updated

• Changed: Mod/Dimension whitelists are now EMPTY by default
  • This means ALL mods and dimensions are enabled by default
  • Use blacklists if you want to exclude specific mods/dimensions
• Improved: Better default values for balanced gameplay

🐛 Bug Fixes

Critical Fixes

• Fixed mobs not receiving buffs on spawn
• Fixed dimension multipliers not being applied
• Fixed enchantments not working on melee weapons
• Fixed attribute modifiers being removed on mob tick
• Fixed ranged mobs standing still when switching to melee
• Fixed mobs losing their target when switching weapons

Technical Fixes

• Fixed memory leaks in mob state tracking
• Fixed NBT data not persisting correctly
• Fixed concurrent modification exceptions
• Fixed race conditions in mob initialization
• Fixed goal selector conflicts between ranged and melee AI

⚙️ Technical Details

For Modpack Developers

• Removed all Mixin conflicts - fully compatible with other AI mods
• Uses Fabric Lifecycle Events for mob tracking
• UUID-based state management for reliable mob tracking
• Persistent attribute modifiers that survive world save/load
• Server-side only logic with proper client/server separation

Performance Improvements

• Reduced tick overhead by 40%
• Optimized mob scanning on world load
• Efficient HashSet tracking instead of WeakHashMap
• Lazy initialization prevents unnecessary processing
• Smart caching of dimension multipliers

📋 Known Issues

• Melee weapons may rarely not spawn with enchantments (reloading fixes this)
• Very large mob groups (100+) may cause brief TPS drops on first spawn

🔄 Migration Guide

If updating from 2.4.8 or earlier:

1. Delete your config/buffmobs.json5 file
2. Let the mod regenerate it with new default values
3. Reconfigure your settings (whitelists are now empty by default)
4. Use /buffmobs reload to apply buffs to existing mobs

🙏 Credits

Thanks to all users who reported issues and helped test this major update!

---

Issues: https://github.com/khotyz/buffmobs/issues/

BuffMobs v2.4.8 - Critical Fixes Update

🐛 Bug Fixes

1. Fixed Weapon Swap System

fixed startup crash