# Hot fix for Support for 26.X

New Structure

# BetterMob v1.3.0 – Official Fabric Release (Minecraft 1.21.11) BetterMob now officially supports **Fabric**! Bring advanced custom mobs, multi-phase boss fights, powerful skill mechanics, custom drops, and spawners to your Fabric servers and singleplayer worlds. ### 🌟 Features on Fabric: - **Server & Singleplayer Ready**: - **Dedicated Server**: Runs on the server side. Vanilla clients (or clients with only BetterModel) can join without needing BetterMob installed! - **Singleplayer**: Fully functional in local singleplayer worlds. - **BetterModel Integration**: Native compatibility with `bettermodel-fabric` for custom Bedrock models and smooth animations. - **YAML Mob Configurations**: Define your mobs easily in `config/bettermob/mobs/*.yml` (auto-generates example templates on first start). - **Multi-Phase Boss Mobs**: Set up health thresholds with dynamic display names, model swaps, equipment, and phase-transition skills. - **Skill Engine & Lifecycle Triggers**: - **Triggers**: `~onSpawn`, `~onDamaged`, `~onAttack`, `~onDeath`, `~onInteract`, and periodic `~onTimer`. - **Targeters**: `@self`, `@target`, `@trigger`, `@entitiesinradius` (`@eir`), `@playersinradius` (`@pir`), `@nearestplayer` (`@p`). - **Mechanics**: `damage`, `heal`, `message`, `actionbar`, `sound`, `velocity`, `potion`, `ignite`, `lightning`. - **Custom Drops**: Drop tables with percentage chances, min/max item ranges, and custom experience drops. - **Mob Spawners**: Player-range aware spawners respecting configurable mob limits. - **Commands**: `/bettermob spawn <mob>` and `/bettermob reload` with tab completion and permission checks. ### 📦 Requirements: - **Minecraft**: `1.21.11` - **Fabric Loader**: `>= 0.16.0` - **Fabric API**: Required - **Optional**: `bettermodel-fabric` (for custom models and animations)

## BetterMob 1.2.0 Big feature update: mob phases, WorldGuard support, independent spawns, model effects and a sorted developer API with many new events, plus another round of Folia stability fixes. ### ✨ New **Mob phases** - New `Phases` list: swap `Display`, `Model`, `Options`, `Equipment` and `Skills` by health (`<70%`, `<=30%`, `<40`) - `~onPhase` runs once when a phase starts; timers and move tasks restart with the active phase - Phase state survives chunk loads and `/bettermob reload` - `/bettermob info` shows the phases, `/bettermob validate` checks them **WorldGuard support (optional)** - Condition `region{r=spawn,arena}` - `Regions` and `NotRegions` in a mob's `Spawn` block - Region flag `bettermob-spawn`: `deny` stops natural spawn replacements and spawners in that region **Spawning** - `Spawn.Action: ADD`: independent land spawns around survival and adventure players, with `Cooldown` and `MaxNearby` - Debug chat shows the ADD spawn results, including skipped attempts **Model effects** - Mechanics: `tint`, `glowbone`, `partvis`, `meg:setitemmodel`, `lockmodel`, `modifystate`, `defaultstate` - `animation` as an alias of `state` - `@ModelPassengers`, `@mountedmodel` and `ridingmodel` also find riders that the model plugin seated itself **More mechanics** - Movement: `teleportto`, `teleporty`, `pull`, `propel`, `dismount` - Chat and players: `jsonmessage`, `speak`, `onchat`, `blackscreen`, `potionclear` - Items: `setitemnbt`, `setlore`, `consumeslot` - World and effects: `effect:firework`, `effect:blockmask`, `setchunkforceloaded`, `displaytransformation`, `raytraceto`, `settargetscore` - Particles with data: block, item, dust and color particles take their data from the line - MCPets skill lines are accepted and do nothing, with one info line in the console **Conditions and skills** - Combine conditions in brackets with `||` and `&&`, also nested - `?~condition` tests the trigger instead of the caster - New: `owner`, `mythicmobtype` (`mobtype`), `boundingboxesoverlap` - `<placeholder>` values work in condition parameters and targeter parameters - Call a skill by its name: `my_skill @target ~onTimer:100` **Item triggers** - `~onSwing`, `~onPressF`, `~onPickup`, `~onDrop`, `~onEquip` **Tools and config** - `/bettermob stats top [n]`: slowest skills and mechanics - Update notice in the console and for players with `bettermob.admin` (`UpdateCheck: false` turns it off) - `BStats: false` turns bStats off for BetterMob ### 👩💻 For developers - Sorted API packages: `api.custom` and `api.event.mob`, `.skill`, `.item`, `.spawner`, `.system` - Many new events for load, despawn, kill, combat, health, phase, signal, group alert, drop, triggrs and reloads ([API events](https://github.com/HyperGaming99/bettermob/wiki/API-Events)) - `dev-SNAPSHOT` on JitPack and the rolling `dev-build` jar for testing against unreleased API changes ### 🐛 Fixes - ADD spawns no longer land on the Nether bedrock roof - Boss bar `<mob.name>` uses the `Display` of the active phase - Tab completion only suggests options that start with the typed text - `/bettermob give` and `egg` are capped at 64 at once - Mob health is capped to the server's max health limit - Unknown mechanics warn once per name instead of filling the console - `onchat` prompts no longer run on the async chat thread on Paper - Overlapping stuns keep the original AI and gravity state until the last one ends - Event auras also fire on players and other non-BetterMob entities - `~onEquip` runs after the hotbar slot has switched - `<target.name>` in `command` no longer becomes the caster's name when there is no trigger - Spawners no longer load chunks synchronously when picking a spawn point - Many smaller fixes from a full code audit (skills, mobs, spawners, validation)

# 1.2.0 Update

## BetterMob 1.1.9 Big MythicMobs-compatibility update: many more pack lines now load without "unsupported" warnings, plus a large round of Folia stability fixes. ### ✨ New **Variables (MythicMobs names)** - Mechanics: `setvar` (with `val`, `type` and `duration`), `variablemath` (safe arithmetic, no code execution), `variablesubtract`, `variableunset` / `unsetvar` - Conditions: `varequals` / `variableequals`, `variableisset`, `variableinrange` (`0.5to2`, `>3`, ...), `stringeq` - New `target.` variable scope and the placeholders `<caster.var.x>`, `<skill.var.x>` and `<target.var.x>` - Conditions: `modelhaspassengers`, `ridingmodel`, `mounted` - Mechanics: `mounttarget`, `dismountall`, `dismountallmodel`; `mountmodel` also accepts `p=` for the seat **Display and rotation** - `setrotation{yaw;pitch;relative}`, `setpitch`, `setgravity`, `scale`, `brightness`, `setdisplayentityitem` - Placeholders `<caster.l.yaw>`, `<caster.l.pitch>`, `<caster.l.x/y/z>` **Triggers** - `~onDespawn`: when a mob is removed without dying - `~onMove:<ticks>`: when the mob moved; no cost for mobs without it - `~onSignal` with the `signal` mechanic - Addons can register their own triggers (`api.registerTrigger`) **More conditions, mechanics and targeters** - Conditions: `crouching`, `day`, `gamemode`, `outside`, `holding`, `moving`, `playerwithin`, `fieldofview`, `score{o;v}` - Targeter `@LivingInCone{a;r;rot;targetplayers}` (`@LIC`) - Mechanics: `setname`, `giveitem`, `fakeexplosion`, `recoil`; alias `effect:particle` **Mobs and tools** - Group alert and leader following for mob packs - Kill conditions (`killedmob`, `killedmobs`) and kill counts for quests - `/bettermob test <mob>`: debug output only for you - Aggro lines and threat table debugging - `/bettermob reload` reports what changed ### 🐛 Fixes - Totem `~onHit` also fires for hits on its invisible body - `shoot` aims along the caster's view when the target stands on the caster's position - Collidable is restored when a mob is loaded again or copied - AI goals are reapplied when a mob is replaced by a teleport copy - The player goal is picked for the players target selector - A mob trigger that is already running for the same mob is no longer started again (no recursion) - Duplicate-definition warnings are logged once per id ### 🧵 Folia About 30 fixes for thread safety across regions: damage and explosion sources, projectiles (flight, homing, scan), particles, spawners, cooldowns, auras, threat and retargeting, loot, delayed steps of dead mobs, and caster names in messages. ### ⚠️ Not supported yet `tint`, `lockmodel` and `meg:setitemmodel`. Riders that the model plugin seats itself (not via `mountmodel`) are not known to `@ModelPassengers`. Full list of mechanics and conditions: [Wiki](https://github.com/HyperGaming99/bettermob/wiki/Skills)

# BetterMob 1.1.6 ## Highlights - **Message language setting.** Console and command messages now come from `lang/<code>.yml`. English (`en`) and German (`de`) are included, add your own by copying `lang/en.yml`. Pick one with `Language:` in `config.yml`. **The default is now English**, set `Language: de` to keep the German messages. - **Reloading updates living mobs.** `/bettermob reload` now binds mobs that are already alive to their new definition: stats and options are re-applied, timers are restarted without duplicates, the model is re-attached and `~onLoad` skills run again. - **Boss bar module.** `Modules: BossBar:` shows a health bar to nearby players, with `Title`, `Range`, `Color`, `Style`, `CreateFog`, `DarkenSky` and `PlayMusic`. The title supports `<mob.name>`, `<mob.hp>`, `<mob.maxhp>`, `<mob.id>` and PlaceholderAPI. - **Finer permissions.** Every subcommand has its own node: `bettermob.spawn`, `.list`, `.reload`, `.skill`, `.give`, `.killall` and `.debug`. `bettermob.admin` still grants all of them. The help and tab completion only show what you may use. - **PlaceholderAPI support.** Placeholders in mob names and in the `message` and `command` mechanics, plus `%bettermob_...%` placeholders for mob and skill counts. ## New commands - `/bettermob killall [mob|*] [world]` removes all living BetterMob mobs, or just one type and/or one world, and tells you how many. It also cleans up leftover helper armor stands of `totem` skills. - `/bettermob stats [on|off|reset]` shows living mobs per type, running timers and loaded skills and packs. With profiling on (`Stats: on` or `/bettermob stats on`) it also lists the slowest skills (calls, average, maximum) and logs a warning when a run takes longer than `StatsWarnMillis`. Nothing is measured while it is off. ## For developers - New example plugin in `examples/api-example` (custom mechanic, spawn and death events, spawning a mob through the API). It builds against the published version via JitPack and is compiled in CI. - `BetterMobAPI.reload()` now does exactly what `/bettermob reload` does. - The skill engine was split into one class per mechanic, targeter and condition. The public API did not change, custom mechanics work as before. - JUnit tests for the parsers, language files, permissions, mechanic names, boss bar titles and statistics run in the CI. ## Fixes - Mobs that load after a restart or chunk reload get their AI goals and sunburn protection applied again. - Placeholder names are matched independent of the server's locale. - Totem hit bodies are tagged (`bettermob_helper`), and leftovers are removed on startup and when chunks load. ## Updating from 1.1.5 - **Permissions:** `/bettermob` no longer requires `bettermob.admin` itself. If you gave players single nodes before, check them against the new list. Ops and `bettermob.admin` keep full access. - **Config:** new keys `Language`, `Stats` and `StatsWarnMillis`. Existing config files keep working, missing keys use their defaults. - **Messages:** if you parse console output, note that it is English now unless you set `Language: de`. - Requirements are unchanged: Paper 1.21+ (Folia supported), Java 21. Full documentation: https://github.com/HyperGaming99/bettermob/wiki

## BetterMob 1.1.5 Adds factions, working auras, a debug system and a much larger set of skill mechanics and targeters. The code is also reorganised into feature packages (no change for users or for the public API). ### Added - **Factions**: `Faction:` in a mob file. Mobs of the same faction never target or hurt each other (also through arrows and skills). New `faction{faction=A,B}` condition. Players can join a faction with the permission `bettermob.faction.<name>` or a `factions:` list in `config.yml`. - **Aura effects**: auras now run `oS` (start), `oE` (end), `oT` (every `i` ticks) and `oH` (when the aura's event happens). `cE=true` cancels that event while the aura is active. - **Debug system**: `Debug: off|info|verbose` in `config.yml` and `/bettermob debug [off|info|verbose|filter <id>|filter clear|chat]`. Logs triggers, skill runs (and why they stopped), mechanics, missing AI goals and bone offsets. Costs nothing while off. - **`shoot`**: projectile types `arrow`, `spectral_arrow`, `trident`, `snowball`, `egg`, `fireball`, `smallfireball`, plus `spread`, `gravity` and the hooks `oh`, `oe`, `ot`. - **`totem`**: `md` (duration), `i` (interval), `ot` (every tick), `oe` (at the end) and `oh` (when hit, through an invisible body). - **New mechanics**: `velocity` (`SET`/`ADD`/`MULTIPLY`/`DIVIDE`, `repeat`), `freeze`, `bodyrotation` (BetterModel head/body limits), and `stun` options `ai`, `g`, `f`, `state` (model animation). - **New targeters**: `@Caster`, `@Mob`, `@Origin`, `@Location`, `@TargetLocation`, `@Owner`/`@Parent`, `@LivingEntitiesInRadius`, `@PlayersInRadius`. All multi-target targeters take `limit` and `sort`. New conditions `isMob` and `hasTag`. - **Release notes** of dev builds and releases list every commit since the last release. - **Issue templates** for bug reports, feature requests and pack compatibility. ### Fixed - Particle `repeat` now works for location targets such as `@ModelPart` and follows the moving bone - An unknown targeter is reported once instead of silently targeting the default ### Changed - `@PIR` keeps its behaviour (nearest player) and is now a `@PlayersInRadius` with `limit` 1 - Source code sorted into packages (`mob`, `skill`, `ai`, `model`, `drop`, `item`, `pack`, `command`, `service`, `util`); class names, the plugin main class and the `api` package are unchanged ### Known limits - `@Owner` only works for mobs created with `summon` - `shoot` speed and damage are estimates compared to MythicMobs - Model attach is not part of the debug log

## BetterMob 1.1.5 (dev build) Unstable pre-release of the `dev` branch. Everything below is on top of 1.1.4. ### Added - **Factions**: `Faction:` in a mob file. Mobs of the same faction never target or damage each other (also through arrows and skills). New `faction{faction=A,B}` condition, usable on the caster and inside `@EntitiesNearOrigin` / `@EntitiesInRadius` conditions. - **Aura effects**: auras now actually run. `oS=[...]` at the start, `oE` at the end, `oT` every `i` ticks, `oH` when the aura's event happens (`onDamaged`, `onAttack`, `onDeath`, `onShoot`). `cE=true` cancels that event while the aura is active. - **`totem` duration**: `md` (ticks), `i` (interval), `ot=[...]` on every interval, `oe=[...]` at the end. The totem stops early if the caster dies. - **`bodyrotation`**: `headUneven`, `bodyUneven`, `minHead`, `maxHead`, `minBody`, `maxBody`, `stable`, `duration`, `delay` now configure BetterModel's body rotator (BetterModel only). - **Release notes**: dev builds and releases list every commit since the last release. - **Issue templates** for bug reports, feature requests and pack compatibility. - **README**: new "Model engine support" table showing what works with BetterModel and what with ModelEngine. ### Known limits - `velocity`, `freeze`, `shoot` projectile types other than arrows and particle `repeat` on location targets are still missing. The Elite Pillager's spawn aura logs a warning for its `velocity` line until that is added. - `totem` ignores `oh`.