Shared Damage

# Shared Damage

`Shared Damage` is a Fabric mod that links player damage across the server.

If one player gets hurt, the rest of the affected players also take collateral damage.

It is built for chaos survival, challenge runs, cooperative punishment mechanics, and multiplayer content where every mistake matters.

By default, collateral damage cannot kill secondary players, so the mod stays dangerous without instantly wiping the whole group from one bad hit.

## Highlights

- Shared damage across all online affected players
- No infinite collateral chains
- Secondary players can be protected from collateral death
- Armor, enchantments, effects, and mitigation can be respected
- Damage multiplier support
- Include and exclude damage type filters
- Cross-dimension support
- Client-side stacked HUD
- Vanilla actionbar fallback for players without the client mod
- English and Spanish language files
- Damage source aliases per language
- Permanent and temporary blacklist support
- Runtime on/off commands
- Config reload command

## How It Works

When a player takes valid damage, the mod propagates that damage once to the rest of the affected players.

It does not create recursive damage chains.

That means:

- one original hit
- one propagation pass
- no infinite loops

## Client And Server

This mod works as a gameplay mod on the server, with optional client-side enhancement.

If a player has the mod installed on the client:

- they get a custom stacked HUD
- repeated messages can stack as `x2`, `x3`, `x4`
- multiple lines can be displayed at once

If a player does not have the mod installed on the client:

- the shared damage system still works
- they receive vanilla actionbar feedback
- server-side fallback messages can still use color

## Installation

### Server

Install the mod on a Fabric server for the shared damage mechanic itself.

### Client

Installing the same mod on the client is optional, but recommended if you want:

- stacked HUD messages
- repeated message grouping
- a cleaner visual feedback system

## Dependencies

This mod requires:

- `Minecraft 26.1.2`
- `Fabric Loader`
- `Fabric API`
- `Java 25`

Recommended setup:

- install the correct `Fabric Loader` version for `Minecraft 26.1.2`
- install `Fabric API`
- place `Shared Damage` in the `mods` folder

If you want the custom HUD, install the mod on the client too.

## Commands

- `/shareddamage reload`
  Reloads config and language files.

- `/shareddamage on`
  Enables shared damage and saves the new state to config.

- `/shareddamage off`
  Disables shared damage and saves the new state to config.

- `/shareddamage toggle`
  Switches shared damage on or off.

- `/shareddamage status`
  Shows whether shared damage is currently enabled.

- `/shareddamage blacklist add <player>`
  Permanently blacklists a player.

- `/shareddamage blacklist add <player> <duration>`
  Temporarily blacklists a player. Examples: `30s`, `10m`, `2h`, `1d`.

- `/shareddamage blacklist remove <player>`
  Removes a player from the blacklist.

- `/shareddamage blacklist list`
  Lists current blacklist entries.

## Config

Main config:

- `config/shareddamage.json`

Language files:

- `config/shareddamage/lang/en.json`
- `config/shareddamage/lang/es.json`

Blacklist:

- `config/shareddamage/blacklist.txt`

### Example Config

```json
{
  "sharedDamageOn": true,
  "sharedDamageMode": "standard_shared_damage",
  "includedDamageTypes": [],
  "excludedDamageTypes": [],
  "collateralDamageMultiplier": 1.0,
  "minimumSecondaryHealth": 1.0,
  "enableClientFeedback": true,
  "maxActionbarLines": 3,
  "language": "en",
  "debugLogging": false,
  "printKnownDamageTypesOnStartup": true,
  "crossDimensionSharing": true,
  "affectGameModes": [
    "survival",
    "adventure"
  ],
  "protectSecondaryPlayersFromCollateralDeath": true,
  "collateralDamageUsesVictimMitigation": true,
  "showOriginalPlayerName": true,
  "clientFeedbackMode": "actionbar",
  "syncConfigToClients": true,
  "reloadConfigCommandEnabled": true,
  "disabledDimensions": [],
  "logDamageEventsToConsole": false
}
```

### Config Options

- `sharedDamageOn`
  Enables or disables the whole system.

- `includedDamageTypes`
  Damage types allowed to propagate.

- `excludedDamageTypes`
  Damage types blocked from propagation.

- `collateralDamageMultiplier`
  Collateral damage multiplier. Supports decimal values like `1.5`.

- `minimumSecondaryHealth`
  Minimum health a secondary player can be left at from collateral damage.

- `enableClientFeedback`
  Enables actionbar or HUD feedback.

- `maxActionbarLines`
  Maximum number of stacked custom HUD lines. Range: `0` to `6`.

- `language`
  Current message language. Default: `en`.

- `crossDimensionSharing`
  Allows damage to propagate across dimensions.

- `affectGameModes`
  Defines which game modes are affected.

- `protectSecondaryPlayersFromCollateralDeath`
  Prevents collateral damage from killing secondary players.

- `collateralDamageUsesVictimMitigation`
  Lets the secondary player's own armor, enchantments, and effects apply.

- `showOriginalPlayerName`
  Shows who triggered the shared damage message.

- `disabledDimensions`
  List of disabled dimensions.

## Blacklist

Blacklisted players do not participate in shared damage.

That means:

- they do not trigger shared damage
- they do not receive shared damage

Temporary entries use the same `blacklist.txt` file and expire automatically.

## Language Support

The mod ships with:

- `en.json`
- `es.json`

These files can be edited to customize:

- actionbar text
- command messages
- damage source aliases

### Damage Alias Examples

```json
"damage_type.in_fire": "fire",
"damage_type.on_fire": "burning",
"damage_type.mob_attack": "mob attack"
```

```json
"damage_type.in_fire": "fuego",
"damage_type.on_fire": "quemadura",
"damage_type.mob_attack": "ataque de mob"
```

## Good For

- challenge servers
- hardcore multiplayer runs
- SMP chaos events
- cooperative punishment mechanics
- content creator multiplayer series

## Notes

- The default setup is meant to be punishing but still playable.
- By default, collateral damage does not kill secondary players.
- Installing the mod on the client gives the best feedback experience.