Download File

## [1.3.0] - Summon altars, variants, rages and anti-cheese ### Added - **Summon items & altars** — new `summon` list on a boss. Players right-click with a configured item (vanilla `item`, optional exact `name`, or a Fiw Tools `toolId`) to start the fight, optionally only on an `altar` block. Per-entry `consume`, per-player `cooldownSeconds`, `variant` and a server-wide `message`. Example: `examples/summon/ember_warden.json`. - **Spawn limits** — `spawnLimits.maxAlive` and a server-wide `cooldownSeconds` for player summons, with refusal messages telling the player why. Living bosses are counted even in unloaded chunks. State is saved in `config/fiw_bosses/data/spawns.json`. Admin `/boss spawn` is never limited. - **Difficulty variants** — named `variants` (e.g. `hard`) with `healthMultiplier`, `damageMultiplier`, `meleeDamageMultiplier`, `abilityDamageMultiplier`, `lootMultiplier`, an optional replacement `loot` table and `displayName`. Saved with the boss. - **Melee / ability damage multipliers** — phases gain `meleeDamageMultiplier` and `abilityDamageMultiplier` next to `damageMultiplier`. - **Arena leash** — `arena.radius`: a boss pulled too far from its spawn point resets (home, full health, phase 1, fight ledger cleared so nobody earns loot for the abandoned attempt). `minionsOnReset` despawns its minions or brings them to the boss. - **Anti-cheese** — opt-in `antiCheese.stuck` detection with admin-chosen actions (`teleport_to_target`, `teleport_attack`, `teleport_home`, `heal`, `reset`, `despawn`, `rage:<name>`) and optional per-occurrence `escalation`; bosses and custom minions destroy boats/minecarts they're put in (on by default, optional `vehicleRage`); opt-in `ignoreSlowBlocks` (cobweb, powder snow, berry bush, honey, soul sand...) with per-block overrides. Custom minions that can't reach their target teleport to it (`teleportWhenStuck`, on by default). Bosses still never break blocks. - **Rages & enrage timer** — named `rages` that override the current HP phase while active (abilities, multipliers, gear, protection, messages) plus `durationSeconds`, `extraHealthPercent`, `healPercent` and `bossBarColor`. Triggered by stuck actions, vehicles, or automatically `afterSeconds` into the fight. Saved through restarts. Example: `examples/anticheese/rift_sentinel.json`. - **Loot lockout** — `rewards.lockoutHours`: a player who earned rewards from a boss gets no per-player loot or reward commands from it until the lockout ends (still listed in the summary, and told how long is left). `lockoutPerVariant` chooses one shared lockout or one per variant. Saved in `config/fiw_bosses/data/lockouts.json`. - **Kill records** — total kills, fastest kill and its party, top single-fight damage and kills per player, in `config/fiw_bosses/data/records.json`. `/boss stats [bossId]`. - **Discord kill webhooks** — `settings.json` `webhooks.discord` (or a boss's own `webhook`, or `"enabled": false`) posts an embed on every rewarded kill: killer, fight time, variant, top damage, unique drops, new-record footer. Sent off the server thread, no retries. - **Shield phase (pylons)** — a phase or rage `shield` summons `count` pylons (any custom minion) in a ring; the boss takes no damage until all are destroyed, and the boss bar shows how many are left. Example: `examples/anticheese/minions/rift_pylon.json`. - **Selectable path finding** — `pathfinding` in settings.json (default `"vanilla"`, unchanged) or per boss/minion. `"shared"` lets squads chasing the same target share one path search and re-plans less often for far targets — a big saving for large minion swarms. - **Scheduled world spawns** — `schedules` in settings.json or a boss file's `schedule`: every `intervalMinutes` or at daily `times`, random pick from `locations`, server-wide countdown broadcasts, at most one live boss per schedule. Validated on reload (exactly one timing option; a boss file wins over settings.json for the same boss). - Commands: `/boss spawn <bossId> variant <name> [pos]`, `/boss limits <bossId> [reset]`, `/boss rage <targets> start <name>`, `/boss rage <targets> end`, `/boss stats [bossId]`, `/boss schedule list`, `/boss schedule trigger <id>`. - API: `FiwBossesAPI.isMinion(Entity)`, `FiwBossesAPI.getVariant(Entity)`. ### Changed - A phase's `damageMultiplier` now scales ability damage as well as melee (it used to be melee only). Use `meleeDamageMultiplier` to keep the old behavior.