Welcome to the sandbox options discussion! This page serves to give you more detailed descriptions of what certain sandbox options do/change.

Important Note:
I strongly recommend disabling the vanilla sandbox option 'Player Receive Damage From Crash' under the 'Vehicle' tab as it controls whether or not the vanilla system for causing car crash related injuries to the player. Leaving this option enabled can potentially cause the vanilla system to add injuries on top of PVI and cause more injuries than expected.

As of update 3.2, PVI now forces the above sandbox option to 'false' when the game or server boots. Users of the mod no longer need to toggle it off manually, but they can if they wish.

As of update 3.3, users may toggle the automatic disabling of the sandbox option 'Player Damage From Crash' in the 'PVI - Debug' sandbox options page.



interval

Originally posted by author:

The amount of in-game ticks that must pass before PVI checks if an injury has occured. The lower the interval, the more frequent PVI checks for collision. Helps adjust how 'touchy' PVI is with collisions at all speeds.

Type of value: Integer, Default: 20


threshold

Originally posted by author:

The minimum speed difference before and after a collision the vehicle must be experience before injuries can begin occurring. Helps adjust how 'touchy' PVI is for lower speed collisions.

Type of value: Integer, Default: 30


minSpeedForInjury

Originally posted by author:

The minimum speed the vehicle must be travelling before injuries can begin occurring.

Type of value: Integer, Default: 35


flatDamagePercent

Originally posted by author:

Controls the amount of flat damage applied to the players overall health as a percentage. By default, the flat damage applied equals: speedDifference * (flatDamagePercent/100) = flatDamage.

Type of value: Integer, Default: 30


maxDamageReduction

Originally posted by author:

The maximum percentage of damage reduction a player may receive from seatbelts and airbags from Working Seatbelts. NOTE: This setting does nothing without Working Seatbelt.

Type of value: Integer, Default: 30


knockoutsEnabled

Originally posted by author:

Enables/disabled knockouts from a car crash. NOTE: This does nothing without Real Knockout.

Type of value: Boolean, Default: true


deathFromCrash

Originally posted by author:

Enables/disables the chance of high speed and fatal speed crashes causing death.

Type of value: Boolean, Default: true


traitsAffectInjuries

Originally posted by author:

Enables/disables fast/slow healer affecting injury times. When checked, fast/slow healer recover 30% faster/slower respectively.

Type of value: Boolean, Default: true


helmetsGiveProtection

Originally posted by author:

Enables/disables the reduction of severity to head injuries when either a full or half helmet is worn.

Type of value: Boolean, Default: true


fullHelmetModifier

Originally posted by author:

The percentage reduction applied to head injuries when a full helmet is worn. Full helmet examples are motorcycle helmets, football helmets, and the airforce helmet.

Type of value: Integer, Default: 60


halfHelmetModifier

Originally posted by author:

The percentage reduction applied to head injuries when a half helmet is worn. Half helmet examples include crash helmets, riding helmets, and the police motorcycle helmet.

Type of value: Integer, Default: 40






disableVanillaCrashDamage

Originally posted by author:

When checked, PVI forces the vanilla sandbox option 'Player Damage From Crash' to false. This is highly recommended to leave checked, as it prevents the vanilla collision system from adding injuries on top of what is dealt by PVI.

Type of value: Boolean, Default: true


forceAlignVehicleDir

Originally posted by author:

Forces the driven vehicles direction to face the same as the player while driving forward, and gets forced to be opposite of the player when in reverse. This is done because the direction of vehicles--at least in testing--didn't update their direction, causing the ejection feature from Working Seatbelts to not work properly. NOTE: Do not turn this off if using the ejection feature of Working Seatbelts, or ejections will only happen in one of 8 directions.

Type of value: Boolean, Default: true






Proper Vehicle Injuries has 4 severity levels: low, medium, high, and fatal. Each of these settings are applicable to each severity of collision.


For injury times, they are weird. General rule of thumb is the higher the injury time, the longer it will last. If you want it to last between a specific number of hours, use the below formulas:
Scratch time sandbox value = desired time in hours * 0.934
Cut time sandbox value = desired time in hours * 0.34
Fracture time sandbox value = desired time in hours * 1.943




upperBound

Originally posted by author:

The maximum speed limit for a collision to be considered that severity. If the upper bound of low speed collisions is 50km/h, then any collision that happens when going less than 50km/h will be considered low severity. These values should be in ascending order, where low speed upper bound < medium speed upper bound < high speed upper bound. Fatal speed collisions are anything that happen over high speeds upper bound.

Type of value: Integer, Defaults: (Low = 50), (Medium = 80). (High = 110), (Fatal > 110)


scratchTimeMin

Originally posted by author:

The minimum amount of time a scratch will take to heal.

Type of value: Integer, Defaults: (Low = 7), (Medium = 10). (High = 15), (Fatal = 25)


scratchTimeMax

Originally posted by author:

The maximum amount of time a scratch will take to heal.

Type of value: Integer, Defaults: (Low = 16), (Medium = 20). (High = 30), (Fatal = 35)


cutTimeMin

Originally posted by author:

The minimum amount of time a laceration will take to heal.

Type of value: Integer, Defaults: (Low = 10), (Medium = 15). (High = 25), (Fatal = 45)


cutTimeMax

Originally posted by author:

The maximum amount of time a laceration will take to heal.

Type of value: Integer, Defaults: (Low = 20), (Medium = 20). (High = 30), (Fatal = 55)


fractureTimeMin

Originally posted by author:

The minimum amount of time a fracture will take to heal.

Type of value: Integer, Defaults: (Low = 20), (Medium = 25). (High = 70), (Fatal = 100)


fractureTimeMax

Originally posted by author:

The maximum amount of time a fracture will take to heal.

Type of value: Integer, Defaults: (Low = 30), (Medium = 30). (High = 90), (Fatal = 140)


injuryChance

Originally posted by author:

The chance rolled for each individual injury to occur until the maximum number of injuries has been attempted. If maxInjuries is set to 3 and injuryChance is 70%, each injury will have a 70% chance of occurring.

Type of value: Integer, Defaults: (Low = 30), (Medium = 50). (High = 80), (Fatal = 100)


maxInjuries

Originally posted by author:

The maximum amount of injuries (regardless of injury type) that will occur in any singular collision.

Type of value: Integer, Defaults: (Low = 1), (Medium = 2). (High = 3), (Fatal = 4)


scratchChance

Originally posted by author:

Given an injury will occur, this is the chance that it will be a scratch.

Type of value: Integer, Defaults: (Low = 100), (Medium = 60). (High = 20), (Fatal = 5)


cutChance

Originally posted by author:

Given an injury will occur, this is the chance that it will be a laceration.

Type of value: Integer, Defaults: (Low = 0), (Medium = 25). (High = 40), (Fatal = 35)


deepWoundChance

Originally posted by author:

Given an injury will occur, this is the chance that it will be a deep wound with a scratch.

Type of value: Integer, Defaults: (Low = 0), (Medium = 15). (High = 25), (Fatal = 35)


deepGlassChance

Originally posted by author:

Given an injury will occur, this is the chance that it will be a deep wound with glass shards and a laceration.

Type of value: Integer, Defaults: (Low = 0), (Medium = 0). (High = 15), (Fatal = 25)


fractureChance

Originally posted by author:

The chance of a fracture occurring.

Type of value: Integer, Defaults: (Low = 0), (Medium = 10). (High = 40), (Fatal = 40)


fullLimbFractureChance

Originally posted by author:

The chance that an entire limb will be fractured (thigh, shin and foot for example).

Type of value: Integer, Defaults: (Low = 0), (Medium = 0). (High = 15), (Fatal = 35)

deathChance

Originally posted by author:

The chance for a character to immediately die from a collision.

Type of value: Integer, Defaults: (Low = 0), (Medium = 0). (High = 0), (Fatal = 20)


knockoutChance

Originally posted by author:

The chance that the player will be knocked out on collision. NOTE: This does nothing without REAL KNOCKOUT.

Type of value: Integer, Defaults: (Low = 0), (Medium = 10). (High = 20), (Fatal = 30)