Types of tweak records

Which kinds of tweak records exist? How are they defined? What do they mean?

Created: Jan 13 2024 by manavortex Last documented update: Jan 13 2024 by manavortex

This page is a work in progress, as the tweak database is huge and barely-documented. If you have any information that needs to be in here, please don't hesitate to sign up as an editor and start contributing!

If you just want a quick overview of a certain type of tweak, you can check Cheat Sheet: Tweaks instead.

Summary

This page lists types of tweak records with their properties and lists of occurrances in the wild. They are grouped by type, and

Please keep entries in the following format (you can copy e.g. Effector below):

Entry explanation
Heading 1: Section - Group records by type(s)

Heading 2: Name of tweak type
A brief description of what it does, and a .tweak snippet (syntax: swift). 
If you know any guides or resources using this kind of tweak, add an info box with links.

Heading 3: Properties
A table: propertyName => explanation

Heading 3: Existing <name of tweak type>
A table with name of tweak type and a brief description of what it does

Conditionals

Condition

A wrapper of Prereq with additional finetuning.

# Condition to check if attack type is ranged
Conditions.Is_Attack_Ranged:
  $type: gamedataHitPrereqCondition_Record
  invert: False
  onlyOncePerShot: True
  type: Prereqs.AttackType
  attackType: Ranged

Properties

Property nameProperty explanation

invert

trigger when the condition is not met?

onlyOncePerShot

Limit this to one procc per bullet?

type

A Prereq โ€” not the same as $type!

attackType

finetuning of type

Existing conditions

Effector nameEffector explanation

Perks.IsHitTargetAlive_inline2

Is the current target alive?

Perks.HitIsBodyPartHead_inline0

Is the current hit a headshot?

Effector

An effector is the tweak version of an if-condition: it is using Conditions or Prereqs before triggering its effect.

mods_abilities.tweak
{
    prereqRecord = "Prereqs.ProcessHitTriggered";
    percentMult = 0.25f;
    unitThreshold = 10f;
} : MultiplyDamageWithVelocity, 
{
    prereqRecord = "Perks.IsHitQuickMelee";
    value = 1.5f;
} : MultiplyDamage

Properties

Property nameProperty explanation

prereqRecord

a Prereq to check if the effector should become active

unitThreshold

a lower bound for the condition

percentMult

for a multiplier: multiply by percentage (0.25 => 125%)

value

the numeric value (1.5 => 150%)

Existing effectors

Effector nameEffector explanation

MultiplyDamageWithVelocity

Will multiply damage by percentMult (if the velocity is > unitThreshold)

MultiplyDamage

Will multiply damage by value

Prereq

The prerequisite for e.g. an Effector.

Existing prereqs

Effector nameEffector explanation

ProcessHitTriggered

Does the bullet hit anything?

IsHitQuickMelee

is the current attack a quick melee attack?

Item modifiers

StatModifier

This type of record adds a quality to an item, modifying its stats.

Qualities

Set an item's quality via statModifier

Effector name

Quality.IconicItem

BaseStats

These entries will start with BaseStats., e.g. BaseStats.ReloadTimeBonus.

Unless specified otherwise, these are numeric (multipliers/additions).

Effector name

ReloadTimeBonus

RecoilKickMin

RecoilKickMax

SpreadDefaultX

SpreadMaxX

HitDismembermentFactor

HitWoundsFactor

EffectiveRange

Last updated