BetterMob

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)
• 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)