Stope

Stope 1.2.0

Mob groups, mob control, and a trigger-to-reaction vocabulary, for Strength In Numbers. Nothing changes in game until a mod uses them.

API

• MobHurtCallback, MobKilledCallback, MobTargetChangedCallback, AnimalBredCallback, MobGroupChangedCallback, ReactionStartedCallback (experimental): server-side mob, group, and reaction events.
• MobGroups, GroupDefinition, MobGroup, LeaderChoice (experimental): same-type mob groups with leaders, centers, and loss tracking; MobGroups.anyInLineOfFire tells whether a grouped mob stands between a shooter and its target.
• MobControl, TargetVeto (experimental): alarm, avoid, attack, move, hold, and calm any mob, whether it runs goals or a brain; MobControl.isEngaged tells whether a mob has an attack target; MobControl.moveStoppedShort tells whether its last move ended short of an unreachable point; MobControl.leap launches a mob into a hop; alarm can take a speed. A held or moving goal mob does not attack. A move to a point the mob cannot reach ends once it has walked as close as a path gets. Moving orders stop horses eating. An attack order that runs out leaves the target to the mob's own AI, brain mobs included; calm takes back everything Stope set.
• ReactionBinding, Reactions, Triggers, Reaction, ReactionContext, ReactionParams, EntityMatcher (experimental): bindings from JSON, reaction and trigger registries, and the primitive reactions flee (with optional speed and direction), avoid, defend and join_attack (with optional release), follow_leader.
• PlayerGuide (experimental): copies a guide shipped in a mod's jar to its config folder, refreshed whenever the guide changes.
• SettingsScreen (experimental, client): a settings screen built from toggles, number fields, and headings, with Done and Cancel; Done can apply changes on the hosted server's thread. Escape with unsaved changes asks to save, discard, or keep editing. Now suggests Mod Menu.
• Now requires the Fabric API modules fabric-entity-events-v1 and fabric-lifecycle-events-v1.

Build

• New api-sources jar holding only the public API sources, published to Maven and attached to the Modrinth upload.
• check now runs strict Javadoc linting on the API package and a scan for AI-tool references in source files.

Docs

• Complete Javadoc on every public API type and member, including thread and side rules.