Battle Brothers

File information

Last updated

Original upload

Created by

Seth

Uploaded by

seferonipepperoni

Virus scan

Safe to use

Tags for this mod

About this mod

A configurable implementation of player persistence beyond ordinarily game-ending defeats and death scenarios.

Requirements
Permissions and credits
Changelogs
Overview

In the vanilla game, for any origin that features a player character, there are two mechanisms that lead to a game over - one is the actual death of the player character, and the other is a victory condition check which, when unsatisfied, forcibly kills all brothers in the roster and forces a game over. 

This mod defuses both of these mechanisms in a manner intended to feel congruent with the base game. Brothers with the player character trait will always, all other things being equal, be forced unconscious rather than killed (and are therefore immune to fatalities), and a defeat out in the field (all brothers dead or unconscious, with at least one brother alive) no longer causes a game over. Brothers without the player character trait remain mortal. Player characters become mortal once again when they sustain too many permanent injuries incurred upon successive defeats (configurable).

Persistence does not provide blanket immunity against all killing blows. Player characters can still be killed in the following ways:

  • being swallowed whole by tier 3 nachzehrers and failing to kill them before combat end,
  • being devoured by the kraken,
  • remaining charmed or left in a nightmare/asleep state by combat end,
  • by background-specific events if and only if using modded scenarios, backgrounds, or events that permit them,
  • and if the configurable permanent injury threshold is exceeded by too many permanent injuries sustained.

Configuration

This mod can be configured in a number of ways, mostly to do with controlling the application of injuries to the player. This includes:

  • the base chance for the player to sustain permanent injuries upon defeat,
  • whether the player character trait tool-tip is modified to reflect changes brought by Avatar Persistence,
  • whether eligible items are removed at random from the player's stash upon defeat,
  • whether the elixir can confer player character status upon non-player characters upon consumption,
  • and the threshold of number of injuries beyond which the player character loses persistence.

Item Loss

As of v2.0.0, item loss upon death functionality has been added, and can be disabled from the MSU settings panel. The item removal algorithm is selective - it will never remove unique/event-specific items, but can potentially remove named items. The number of items removed and the chance for individual items to be removed can also be configured.


Cures

Finally, this mod also includes an item, the elixir, that cures permanent injuries when consumed by and only by the player character. This item is only available in the marketplaces of settlements with temples.

The elixir also has the special property of being able to confer player character status to any non-player character, if configured to do so. Be warned that this also means that the death of this character will, as per vanilla logic, result in the end of the current campaign.

The chance to find this item is user-configurable, and can be disabled entirely if so desired.

Installation

Drop the zip file into Battle Brothers\data. Do not extract the zip file.
If updating, please delete the pre-existing file before placing the zip within your data folder.

Dependencies

This mod (v2.0.0) was tested on modding script hooks v21.1 and MSU v1.2.7. Older versions may work, but are unsupported.

As of 2.0.0, this mod no longer requires MSU, but will interface with it to provide additional configurability if desired.


Known Issues

  • Persistence does not handle or modify in-game events in any way. Some events, such as the Icy Cave location event, will allow for the player character to "die" (as reflected in event flavour text), but Persistence will, if conditions obtain, keep the player character alive as per usual. As the correction of event text is out of scope for Avatar Persistence, this issue will remain unsolved. (v1.1.2)

Please report bugs in the Bugs section along with your log file (found in Documents\Battle Brothers).

Compatibility
There are no compatibility issues being tracked as of version v2.0.0.
Please report compatibility issues in Posts along with your log file (found in Documents\Battle Brothers).


Credits & Thanks


AdamMil01 for modding script hooks.
Paul Taaks for the incredible art of Battle Brothers, as used in the thumbnail and the header.
The MSU team for the revolutionary MSU.
Enduriel, TaroEld and Uberbagel for so much advice, insight, and guidance.
As always, Overhype Studios for Battle Brothers.