Deathlink - Rougelike Control

Progression and Choice based death control.

Bringing together players from many different experiance levels often means that some players struggle while others are bored. Deathlink provides a way to challenge and reward players based on their appetite for risk.

Additionally, death is one of the few things that does not progress through the game. Deathlink changes that by providing a skill that levels up faster the longer you stay alive, and scales your death changes based on that skill.

Example Deathlink Choices

Vanilla	Minimal	Hardcore

Configuration

Deathlink has extensive yaml based configuration options. However it can be used with the default configuration.

Each of these configuration sections below can be applied to any number of profiles which users can select. Deathlink selection is one per character and is stored on the server the character is on,a character can have different selections in singleplayer or multiplayer.

Example Configuration

Rougelike3:
  displayName: Berserker
  deathStyle:
    foodLossOnDeath: true
    foodLossUsesDeathlink: true
    maxEquipmentKept: 3
    skillLossOnDeath: true
    maxSkillLossPercentage: 0.2
    minSkillLossPercentage: 0.05
    itemLossStyle: DeathlinkBased
    nonSkillCheckedItemAction: Tombstone
  deathSkillRate: 1
  resourceModifiers:
    Wood:
      skillInfluence: true
      prefabs:
      - Wood
      - FineWood
      - RoundLog
      - YggdrasilWood
      - Blackwood
      bonusModifer: 1.5
      bonusActions:
      - Harvesting
    Ore:
      skillInfluence: true
      prefabs:
      - CopperOre
      - TinOre
      - IronScrap
      - SilverOre
      - BlackMetalScrap
      - CopperScrap
      - FlametalOreNew
      bonusModifer: 1.5
      bonusActions:
      - Harvesting
  skillModifiers:
    All:
      skillInfluence: true
      skill: All
      bonusModifer: 1.2
  deathLootModifiers:
    AmberPearl:
      prefab: AmberPearl
      chance: 0.05
      amount: 1
      bonusActions:
      - Kills

Deathstyle Configuration

Deathstyle configuration governs what happens when you die.

  deathStyle:
    foodLossOnDeath: true                  # Player will loose food on death or not
    foodLossUsesDeathlink: true            # Food loss is based on skill level from loosing all foods, to none
    maxEquipmentKept: 3                    # The maximum number of equiped items to keep on death
    skillLossOnDeath: true                 # Whether or not skill loss occurs on death
    maxSkillLossPercentage: 0.2            # The maximum percentage of skill lost on death (you start here, example is 20%)
    minSkillLossPercentage: 0.05           # The minimum skill loss, at max skill level (example is 5%)
    itemLossStyle: DeathlinkBased          # Item loss style, can be None, DestroyNonWeaponArmor, DeathlinkBased, DestroyAll
    nonSkillCheckedItemAction: Tombstone   # If items are set to avoid skillcheck, what happens to them, can be Destroy, Tombstone, Save
    itemSavedStyle: Tombstone              # Items that are saved can be: OnCharacter, Tombstone
  deathSkillRate: 1                        # Rate at which Deathlink skill increases, higher is faster

Resource Configuration

Resource configuration provides a way to get additional resources from kills or harvesting

resourceModifiers:
    Wood:                     # Name of the entry, can be anything
      skillInfluence: true    # Whether or not Deathlink skill will influence this bonus
      prefabs:                # List of prefabs that this bonus applies to
      - Wood
      - FineWood
      - RoundLog
      - YggdrasilWood
      - Blackwood
      bonusModifer: 1.5       # The bonus modifier, larger is more, 1.5 is 50% more
      bonusActions:           # List of actions that will trigger this bonus can be Kills or Harvesting
      - Harvesting
    Ore:
      skillInfluence: true
      prefabs:
      - CopperOre
      - TinOre
      - IronScrap
      - SilverOre
      - BlackMetalScrap
      - CopperScrap
      - FlametalOreNew
      bonusModifer: 1.5
      bonusActions:
      - Harvesting

Skill Configuration

Skill configuration proviedes a way to grant additional XP or reduced XP for any or all skills

  skillModifiers:
    All:                      # Name of the entry, can be anything
      skillInfluence: true    # Whether or not Deathlink skill will influence this bonus
      skill: All              # The skill that this bonus applies to, can be All or any specific skill name
      bonusModifer: 1.2       # The bonus modifier, larger is more, 1.2 is 20% more

Death Loot Configuration

Death loot configuration provides a way to gain additional items on kills, specific to player Death choice

  deathLootModifiers:
    AmberPearl:               # Name of the entry, can be anything
      prefab: AmberPearl      # The prefab name of the item to drop
      chance: 0.05            # The base chance of the item dropping, 0.05 is 5%
      amount: 1               # The amount of the item to drop
      bonusActions:           # List of actions that will trigger this bonus can be Kills or Harvesting
      - Kills

Resetting a players choice

You or someone you play with has made a terrible choice, they thought they were so hardcore and now they can't stay alive.

Well! There is a solution! As an admin you can reset yours or other players death choices, ensure that you have the console enabled by setting your launch paramters in your mod manager to include -console

In game run the command dl-reset-choice [playername] eg: dl-reset-choice Midnight or dl-reset-choice 91231230123. This command will clear the players choice from the server, and remove their choice from their character. They should open their inventory again to select a new choice.

If you are having trouble matching an existing player in the game, be sure to turn logging on for Deathlink, and validate the steam ID or player name you are using matches a player in the game.

Localization

External localization can be configured at BepInEx\config\Deathlink\localizations. This folder and the default localization will be generated and added the first time this mod runs. New localization keys will be added to localization files as they are added to the mod. Existing localization keys will not be changed, so your localization customizations are safe.

Questions, Bug reports and feedback

Got a bug to report or just want to chat about the mod? Drop by the discord or github.

0.8.7

- Improves fallback when loading player profile data

0.8.6

- command support for RCON by tristan

0.8.5

- Improve dl-reset-choice now supports:
	- Matching player name
	- Player platform account name
	- Player platform ID

0.8.4

- Fixes AzuExtendedInventory integration

0.8.3

- Removed Repacker
- Improves server relay for reset-choice command

0.8.2

- Fixes scroll visibility of death choices
- Adds more failsafes for invalid death choice configurations
- Improves deahtlink reset command matching to player names or ids
- Adds backpack integration to avoid deathlink destroying player backpacks (just items in the pack)
- Adds missing wood types to the default list of wood harvestables

0.8.1

- Adds a Deathlink choice reset command `dl-reset-choice`
	- Can be used locally or on a server (only by admins)
	- Requires that the target player is online

0.8.0

- Adds support for storing death configuration as a player private key, this is now the default method
- Syncs player deathlink key on server join
- Optionally falls back to yaml configuration if no key is found
- Fixes a bug with AzuExtendedInventory integration where items might not be saved correctly
- Fixes an issue with remote deathlink configuration not being applied if it was synced after the players preferences were loaded
- Adds an integration to WackyMMO
	- Allows WackyMMO XP loss on death
	- Allows WackyMMO XP gain from deathlink progression
	- Adds configuration to disable WackyMMO XP loss on death
	- Adds configuration to tune XP loss/ XP gain rates

0.7.5

- Improves Death transpiler compatibility with other mods

0.7.4

- Fixes an issue re-adding remote deathlink configurations

0.7.3

- Kill drops rewards now require the player has hit the target creature
- Death XP Penalty is scaled correctly
- Added an integration for Almanac Classes, which allows gaining and loosing Almanac XP

0.7.2

- Fixes probability comparisons for low chance kill drops

0.7.1

- Fixes divide by zero for rarity based loot rolls
- Adds harvest multipliers support to pickable items

0.7.0

- Multiplayer Overhaul
- Death configuration is now managed by profiles
- Players on a server can choose which deathlink profile they want to use
- Selected choice and bonuses/penalties are visible in the compendium
- Death profiles can influence many aspects
	- Increase/decreased gathering yields
	- Drops from enemies
	- Skill gains/penalties
	- What happens to your items on death
	- How many items you can keep on death
	- How much food you keep on death
- Dependencies have been updated to current version of Jotun

0.5.5

- Fixes equipped items not being saved to tombstone when they are removed

0.5.4

- Prevent shuffling of items on death
- Fix some items appearing as duplicated ghosts

0.5.3

- Refresh inventory state to prevent ghost items

0.5.2

- Added localization and external localization support (Bepinex/config/Deathlink/localization)

0.5.1

- Fixes an issue that would prevent saving any equipment
- Changes the default maximum equipment saved style to be an absolute value (this will not change existing configs)

0.5.0

- Adds a system to allow configuring skill reduction rates on death
	- Skills can now be configured to be reduced by a percentage, like vanilla
	- Skills GAINS since the last death can also be reduced by a configurable percentage
	- Skills which can lose XP can be configured
		- Configure which skills do not loose gained XP
		- Configure which skills do not loose XP on death
- 

0.4.1

- Fix minimap marker on death NPE

0.4.0

- Added MaxPercentResourcesRetainedOnDeath which provides an alternative to MaximumEquipmentRetainedOnDeath and can the behavior between the two can be toggled with MaximumEquipmentRetainedStyle
	- This allows for scaling of the amount of equipment saved for a variety of different playstyles, and the option for more linear progression between the start of the game to the end of the game
- Fixes an edgecase for retaining food on death
- Fixes an edgecase for retaining items on death that would result in the player retaining less items than intended
- Added DeathSkillPercentageStyle which allows for scaling of saved items based on total player inventory size and not just items in the players inventory
- Lowered the skill floor for item loss, particularly impactful for extremely large inventories (80+)
- Increased base XP rate for all activities

0.3.4

- Fix non-skill checked items being processed incorrectly

0.3.3

- Update default frequency of skill gains

0.3.2

- Fixes AzuExtendedInventory integration not shuffling saved equipment
- Fixes MaxItemsSaved resulting in the same items regularly being saved

0.3.1

- Adds a max number of equipment items saved option
- Adds the option to save all items to the tomb stone

0.3.0

- Fixes old binary being included
- Adds AzuEPI integration
	- Supports saving items from quickslots added by any mods that use AzuEPI
	- Saving of items is not ordered and may not result in the item staying in the slot (unless it is equipment)
- Logo fixes

0.2.0

- Add configurable food clearing on death
- Add configurable food clearing based on skill level on death
- Added configuration to add or not add a map marker on death

0.1.0

- Initial release
- Add death resistance skill
- Add configurable death item loss/destruction
- Add seperate configurable tier for items which are either dropped, or destroyed
- Add skill tracker and skill xp reduction control