=== HEV OS ===

• This program closely replicates the audible response mechanics of the HEV Suit in Half-Life (1998) by Valve.

• Inputs:

  • hit - User recieves physical damage ranging from 1 - 50 hit points (HP).
  • hazard - User recieves energy damage ranging from 1 - 40 HP.
  • heal - Heals the user's health by 15 (HP).
  • repair - Repairs the suit's armor by 15 armor points (AP).
  • armor - The suit's voice reads out the current armor value.
  • quit - Exits the program.

======== Health & Armor ========

• Health (health) and Armor (armor) have their own pools. Both range from 0 - 100.

• armor negates how much health gets subtracted from a physical hit. The original formula is as follows: (hit * 0.80 / 2)

• To explain this, armor will absorb 80% of the hit, divide it by 2 (so 40%) and deduct from the current armor value, up until where the user is at 0 armor, at which point 100% of the hit is commited to health instead. Regardless, whenever there is armor, health will take the remaining 20% of the hit. Even if the user has 100% armor, health is still affected when taking physical damage.

• Upon a hazard, damage goes straight to armor and health is totally unaffected. If there is 0 armor, hazard damage is applied to health instead.

**** Health Alerts ****

• When health is at certain thresholds, there is a chance for 3 different voice lines to play:

  • if health <= 50: play.seek_medic.wav - (50% chance)
  • elif health <= 30: play.health_critical.wav - (65% chance)
  • elif health <= 6 and > 1: play.near_death.wav - (90% chance)

• By default, all 3 have a chance to play and can be configured in the top config.

• When health drops to 0, a death sound will play.

**** Armor Alerts ****

• A small audible alarm will play if either a physical or energy hit >= 30 is rolled.

• If armor drops to 0, there is a 50% chance (default) that a voice line will play stating armor compromised.

======== Hit - Physical Damage ========

• Upon a hit, the user will take damage ranging from 1 - 50.

• There are currently 4 different major hit sounds and 4 different minor hit sounds. One of them will randomly play.

• If hit >= 25, a major hit sound will play. Otherwise a minor hit sound will play.

• There is a 40% chance (default) that a voice line will play, that follows up alerting the user that either a major or minor hit has been detected.

======== Morphine Shot ========

• Additionally, there is a 44% chance (default) if the aforementioned major hit detected line played, the suit will play an extra voice line that administers a morphine shot.

======== Hazard - Energy Damage ========

• Upon a hazard, armor will take damage ranging from 1 - 40. Health is unaffected, as long as there is armor.

• Randomly, 1 of 6 hazard sounds will play. The hazards themselves do not currently have a sound effect, so, a voice line will play detecting the random hazard.

• Current hazard types are [heat, shock, bio hazard, blood toxins, chemical, radiation]

• If either of the 4 [bio hazard, blood toxins, chemical, radiation] voice lines play, there is a 50% chance (default) that an additional voice line will play, stating that vital signs are dropping.

======== Healing and Repairing ========

• There are 2 commands to replenish health and armor. They are:

  • heal
  • repair

• Both items heal/repair by 15, individually.

• Both items play their respective sounds as found in the game.

• Both also play a different sound if trying to heal/repair when that value is at max (100).

• After the armor repair sound has played, the suit will dynamically play a voice line stating the new armor value. This is read out in increments of 5, which is rounded to the nearest multiple of 5, this behaviour is similar to how it worked in the original.

======== Armor Readout ========

• Upon armor readouts, the suit will play a couple of varying boop noises and play a dynamic voice line that reads the exact current armor value.

• If armor is 0, another sound will play to signal that there is no armor currently left and no voice line will play.

======== Resources ========

• Features are based on the findings in this video: https://www.youtube.com/watch?v=6oPGjA5-4AM (1:40)

• Additional information based on my own findings: https://youtu.be/zAka_vIXxtw?si=ACw29pQapn8aEZTp