Player support

Public release 0.2.2 · Minecraft 26.3 / Fabric. Release boundaries.

Open Arena effects in the editor to choose Beacon effects, Fight health, and Reusable potion. You can turn each one on or off separately.

Once the boss activates, players inside its boss-bar arena get the support you've enabled. That includes players there during emergence and anyone who joins the fight late.

New default templates and the six player-count presets start with a 100 HP fight-health floor, healing on first entry, and the reusable potion enabled. Their Beacon effects defaults are different; see below. If an older file is missing these sections, you still need to enable them yourself.

Beacon effects

The supported effects are Speed, Jump Boost, Regeneration, Strength, and Resistance. You can't add Haste through these settings.

• Fresh default templates: the master switch is off; individual effect entries are enabled at level I. Turn on the master switch and adjust the individual entries for your encounter.
• Six player-count presets: the master switch is on, with only Regeneration I enabled.

Set boss_bar.area_effects.enabled to true, then enable the effects you want with a human-readable level from 1–5. Level 1 means I. Resistance V prevents all damage that native Resistance can reduce.

This partial template enables Regeneration I only:

{
  "boss_bar": {
    "area_effects": {
      "enabled": true,
      "speed": { "enabled": false, "level": 1 },
      "jump_boost": { "enabled": false, "level": 1 },
      "regeneration": { "enabled": true, "level": 1 },
      "strength": { "enabled": false, "level": 1 },
      "resistance": { "enabled": false, "level": 1 }
    }
  }
}

Eligible players receive native infinite-duration effects with icons and no particle cloud. Leaving clears only this mod's grants, normally within the existing 10-tick arena check. Grants also end on player death/disconnect/respawn and boss death/removal/unload/shutdown.

If arenas overlap, players get the strongest configured level. Leaving one arena won't remove support they're still getting from another.

Effects from potions, beacons, and other mods take priority over the arena's effect of the same type, even if they're weaker. When that effect ends, the arena effect can resume. It can also resume after effects are cleared, as long as the player is still eligible. Cleanup leaves those outside effects alone and respects other mods' Fabric permission callbacks.

Fight health

boss_bar.player_health.minimum_max_health accepts 1–1,000 HP and defaults to 100 HP. This sets a floor for maximum health; it doesn't add an extra 100 HP. If equipment already gives a player 100 or more maximum HP, that value still applies.

This partial template enables the default health floor and first-entry heal:

{
  "boss_bar": {
    "player_health": {
      "enabled": true,
      "minimum_max_health": 100.0,
      "heal_on_first_entry": true
    }
  }
}

heal_on_first_entry defaults to true: full heal once per player per encounter, including late arrivals. Re-entry, reconnect, and reload do not grant another first-entry heal.

The boss saves a ledger of up to 4,096 player UUIDs. If it fills, additional players still receive the health floor and potion but no initial heal.

Players keep the same health percentage when the floor changes later or they leave and re-enter the arena. A player leaving with 50/100 HP returns to 10/20 HP if their normal maximum is 20. Cleanup removes only this mod's named modifier, leaving base, armor, and other modifiers intact.

Overlapping encounters use the highest health floor.

Reusable potion

Settings live under boss_bar.reusable_potion:

This partial template uses the default potion policy:

{
  "boss_bar": {
    "reusable_potion": {
      "enabled": true,
      "heal_hp": 20,
      "cooldown_seconds": 15,
      "hunger_restored": 20,
      "saturation_restored": 20
    }
  }
}

The potion heals up to the player's maximum HP, restores hunger up to 20, and restores saturation up to the resulting hunger. Normal potion drinking time applies.

The cooldown starts on successful completion, uses game time, is shared by copies and overlapping encounters, and survives re-entry, reconnect, and respawn. The server checks the exact current arena both when drinking starts and when it finishes. Leaving before completion does not bypass that check.

If encounters overlap, the mod uses the potion settings from the boss with the highest healing amount. Ties are resolved consistently by boss UUID. You don't get stacked doses or a super-potion made from the best settings of every boss.

Offhand and inventory behavior

Stable 0.2.2 retains the earlier policy that can temporarily displace a personal offhand item and owns its restoration. Do not assume the later Better Combat-aware inventory placement policy is included. Test your actual equipment, inventory and grave-mod setup before opening the encounter.

Development source: potion death and grave recovery

The later source fixes a confirmed Universal Graves timing issue. The grave saved the inventory before the old death cleanup ran, so reclaiming items after the encounter ended could return the fight potion.

Cleanup runs just before Minecraft handles a confirmed player's death loot. It removes temporary inventory/cursor bottles. The inherited stable policy restores the unchanged displaced personal offhand before the grave captures it. All of that player's potion grants end; other players keep theirs. A successful totem or a mod canceling death keeps the potion. Real death with keepInventory still removes it.

Existing graves are not scanned or rewritten. If an older grave returns a saved fight bottle, attempting to use it without a current potion grant removes it and any inventory/cursor copies. Ordinary potions and personal items remain. Reconnect cleanup also removes stored inventory copies.

No extra tick check or grave dependency was added. The supplied Universal Graves 3.13.0+26.3 was tested through actual death, native respawn and grave recovery after boss removal. All 33 native tests passed with and without the supplied server pack. That is historical verification of the earlier fix, now included in stable 0.2.0. It does not establish compatibility with every grave or combat mod. See current verification.

Development source: removal and schema review

/boss remove now also releases potion grants by boss UUID when the loaded entity has no runtime state. A one-time command-boundary pass removes copied or restored fight bottles from online inventories/cursors when those players have no remaining potion grant. Another active encounter retains its grant. Personal items are preserved; world containers are not scanned. No recurring check was added. Cleanup sends Minecraft's full inventory state, including offhand/cursor, so it can correct a stale client slot cache instead of relying only on changed slots. The orphan pass sends nothing to unaffected players. Isolated native tests pass; the reported real client's display still needs a retest with a newly packaged jar. This cleanup is included in stable 0.2.2; the older optional-client test jar predates it.