---

The pitch

Vanilla has three bosses. You've beaten all of them.

FIW Bosses hands you the toolkit Mojang didn't: drop a JSON file into config/fiw_bosses/bosses/, run /boss reload, and a fully custom encounter is live on your world — changing tactics as its health drops, summoning minions, taunting your players, and dropping exactly the loot you decide.

It isn't one hardcoded boss bolted onto the game. It's a framework: HP-threshold phases, per-phase ability loadouts, custom minions with their own AI, pre-fight and pre-death dialogue, custom skins, hot reload — one config schema that behaves the same on every loader and version it supports.

🧩 Both-sides mod. Install the matching jar on the server and every client that joins it.

---

!Short showcase

---

Sixty seconds to your first boss

config/fiw_bosses/bosses/storm_caller.json

{
  "id": "storm_caller",
  "displayName": "&b&lStorm Caller",
  "health": 500,
  "speed": 0.28,
  "phases": [
    {
      "hpThresholdPercent": 1.0,
      "abilities": [
        { "type": "chain_lightning", "cooldownTicks": 120, "params": { "bounces": 5, "damage": 10 } },
        { "type": "beam", "cooldownTicks": 180, "params": { "damage": 4 } }
      ]
    }
  ]
}

/boss reload
/boss spawn storm_caller

That's the whole loop. Tweak the file, reload, fight again — no restart, ever.

---

What you can build

🔥 Phase-based fights — every boss can rewrite its own rules as it bleeds. Each phase changes speed, damage, equipment, the minion pool, transition messages, sounds, particles, and its entire ability set.

🧠 Eight movement styles — hit_and_run, guard_point, phase_walk, hover, sniper, berserk, plus classic strafing or plain vanilla pathing. Your sniper kites; your berserker hunts.

👥 Custom minions — true FIW minions with skins, gear, abilities, AI modes and loot, or plain vanilla mobs for quick summons. Minions can escort the boss, hold a position, or fight on their own.

🎭 Disguises — keep full FIW logic but render a boss or minion as any vanilla or modded mob with renderEntity, or use a real player skin. Your "zombie" can cast meteors.

💬 Fight flow & dialogue — start a boss dormant and invulnerable until a player right-clicks it; play pre-fight lines, then begin. Hold it at 1 HP for last words before it falls.

♻️ Hot reload & persistence — /boss reload re-reads everything live, deleted configs are removed from the world, and a boss's phase survives server restarts.

50+ abilities, mixed and matched

Abilities are small, tunable attack modules. Stack them on a phase, set cooldowns, tune the params, and a moveset is born.

Ability	What it does
domain	Seals players in a sphere with its own attack set
phantom_dash	Wall-clipping zigzag dashes that snap to safe ground
rift_cleave	Tears a delayed damaging line through the floor
fear_burst	Warden-style soul burst: Darkness, Weakness, knockback
mirror_image	Particle decoys, invisibility, position swaps
wither_crown	Orbiting wither skulls that fire one by one
last_breath	Low-HP channel — fail to interrupt it and eat a soul blast
rewind	Records position + health and snaps back when low
second_wind	One-shot auto-revive that negates a fatal blow
adaptation	Grows resistant to whatever's been hurting it most

…and dozens more — slams, beams, meteors, orbital strikes, tornadoes, sonic booms, judgment marks, divine executions, summons, heals, shields, and ultimates. The full list and every parameter live in the documentation.

---

Supported versions

Loader	Minecraft	Java
Fabric	1.21.11	21
NeoForge	1.21.11	21
Fabric	1.21.8	21
NeoForge	1.21.8	21
Fabric	1.21.1	21
NeoForge	1.21.1	21
Fabric	1.20.1	17
Forge	1.20.1	17

Fabric builds need Fabric API. One boss file behaves the same on all eight targets.

Optional: Fiw Tools — when present, equipment and loot can reference its items by toolId; when absent, those entries are skipped and nothing breaks.

---

Commands

/boss needs op level 2; /boss reload needs op level 3.

/boss spawn <id> [x y z]      /boss list        /boss kill <id> | all
/boss minion spawn <id>       /boss minion list /boss minion kill <id> | all
/boss reload

---