From 15bed8e12209db2f1d5e38d6325d9cd20f32258c Mon Sep 17 00:00:00 2001 From: BaerMitUmlaut Date: Thu, 15 Sep 2016 02:25:32 +0200 Subject: [PATCH 1/6] Added advanced fatigue documentation --- docs/wiki/feature/advanced-fatigue.md | 99 +++++++++++++++++++ .../framework/advanced-fatigue-framework.md | 28 ++++++ 2 files changed, 127 insertions(+) create mode 100644 docs/wiki/feature/advanced-fatigue.md create mode 100644 docs/wiki/framework/advanced-fatigue-framework.md diff --git a/docs/wiki/feature/advanced-fatigue.md b/docs/wiki/feature/advanced-fatigue.md new file mode 100644 index 0000000000..197fed9e03 --- /dev/null +++ b/docs/wiki/feature/advanced-fatigue.md @@ -0,0 +1,99 @@ +--- +layout: wiki +title: Advanced Fatigue +description: Human fatigue simulation based on scientific formulas. +group: feature +category: realism +parent: wiki +mod: ace +version: + major: 3 + minor: 7 + patch: 0 +--- + +## 1. Overview + +Advanced Fatigue is a human fatigue simulation based on the information and formulas provided by Bohemia Interactive Simulations, which are [publicly available online](https://manuals.bisimulations.com/vbs3/3-0/downloads/VBS_AdvFatigueSys.pdf) and apparently used in VBS3. However, just to make this clear again, none of VBS3 code was taken over, this is an independant implementation. + + +### 1.1 Basics + +Advanced Fatigue is based on scientific formulas that try to predict human performance, which enables ACE to provide a fairly accurate fatigue simulation with understandable in-game results in terms of performance. This means that any movement will be taken into account and may have an impact on both your short term and your long term fatigue: running around all mission will influence how long and how far you can run later, but if you're more conservative with your energy, you might benefit from that when you actually need more power. + + +### 1.2 Fatigue Influences + +Your stamina will be drained more or less depending on various factors, some of them more severe than others. Here's a short list of all currently implemented fatigue influences: + +- **Character stance:** Moving upright, crouched or prone. +- **Weapon holding:** Lowering your weapon, raising it or moving with the gun high ready +- **Movement speed:** Running, jogging or walking +- **Gear weight** +- **Terrain steepness:** Walking on slopes, up or down hill +- **Injuries:** Pain and blood volume +- **Carrying:** Both units and objects +- **Environment temperature** + + +### 1.3 Effects of High Fatigue + +Depending on how much your character is fatigued you will experience various visual, audible and physical symptoms: + +- Breathing sounds (with different intensity and frequency) +- Black flashing border when hitting the bodies limits +- Not being able to sprint +- Not being able to jog +- Slowed down movement whilst swimming or diving +- Weapon sway (majorly reduced when crouched or prone) + + +### 1.4 Stamina Bar + +ACE provides a stamina bar similar to the one in vanilla Arma 3. You can enable and disable it through your ACE options menu. If you want to move the stamina bar, simply move the vanilla one in the GUI game options, the Advanced Fatigue one will move to the same location (this requires a restart though). + +The Advanced Fatigue stamina bar has a few changes compared to the vanilla one to improve both immersion and user feedback, inspired by Dslyecxi's custom stamina bar. It will initially have a very low opacity which rises with the loss of stamina. Additionally it will first turn from white to orange and bright red afterwards. + + + +## 2. Simulation Details + +Since Advanced Fatigue is based on real life biological systems we will explain some of them in more detail here. + + +### 2.1 How Human Stamina Works + +Human stamina is based on the availabilty of adenosine triphosphate (ATP), which is a molecule used by the body to transfer power. Small amounts of ATP are already stored readibly available within muscle cells and larger amounts are generated by several pathways, which then transfer the ATP through blood to the muscles. There are quite a few pathways which generate and store ATP, so instead of simulating all of them, we merge them into 3 generic pathways. + + +### 2.2 ATP Pathways + +Each pathway has different properties: They store different amounts of ATP and can provide and regenerate different amounts of ATP per second. You can compare this to having three differently sized barrels filled with water, each having a differently sized faucet and opening at the top to refill it with water. + + +#### 2.2.1 Anaerobic Pathway + +This pathway is essentially responsible for your short term stamina. It has a very small capacity of ATP available (2300 mmol), which is can provide a lot of ATP very fast (13.3 mmol/s), but also replenished very quickly (56.7 mmol/s). This pathway is pretty much what limits how long you can jog or sprint in one go, which is why we use it as an indicator for the stamina bar. + + +#### 2.2.2 Aerobic Pathways + +The two aerobic pathways store way bigger amounts of ATP than the anaerobic one, the first one stores over 1700 times as much ATP (4000 mol) and the second one still over 36 times as much ATP (84 mol) as the aerobic pathway. However, they can also provide (13.3 and 16.7 mmol) and replenish (6.6 and 5.83 mmol) a lot less ATP then the aerobic pathway. + +This means that while these will last a lot longer, they do not have such a large impact on your short term performance. Instead, they will drain slowly during the day, which means that at the end you will have less power available than at the beginning, depending on how much you exhausted yourself. However, at that point they will start influencing your short term performance. + + +### 2.3 ATP Consumption + +At any time the body consumes a certain amount of ATP - even when not moving. Since the aerobic pathways have so much ATP available, they will be drained first, and when you're not moving they can usually cover all the ATP you need. They can actually mostly regenerate the same amount of ATP that is used as is consumed, which means standing still has no effect on your performance. Once you exert yourself a little more, by jogging for example, more ATP is needed, and the anaerobic pathway comes into play. It will fill in the rest of the ATP needed. + + +### 2.4 ATP Pathway Fatigue + +Another factor that comes into play here is pathway fatigue - the pathways themselves can fatigue too! That means, the more ATP the pathways have to provide, the slower they will will be able to, limiting how much ATP can overall be provided by each pathway. If we take into account that the aerobic pathways have provide their ATP first for any consumption, that means that the anaerobic pathway will have to provide more ATP if the aerobic ones are fatigued. This is how the long term fatigue effect is created. + + + +## 3. Dependencies + +{% include dependencies_list.md component="ace_advanced_fatigue" %} diff --git a/docs/wiki/framework/advanced-fatigue-framework.md b/docs/wiki/framework/advanced-fatigue-framework.md new file mode 100644 index 0000000000..f99d780c78 --- /dev/null +++ b/docs/wiki/framework/advanced-fatigue-framework.md @@ -0,0 +1,28 @@ +--- +layout: wiki +title: Advanced Fatigue Framework +description: Explains the effects of various Advanced Fatigue mission settings. +group: framework +parent: wiki +mod: ace +version: + major: 3 + minor: 7 + patch: 0 +--- + +## 1. Global Settings + +ACE provides four settings to tweak Advanced Fatigue. Adjust these factors depending on how hard you want your experience to be. + +- **Performance factor:** This influences the overall performance of players, malnourished or super soldiers, everything is possible. +- **Recovery factor:** Do you like looking at the landscape or think breaks are boring? Whatever the case, this influences the lenght of your stamina breaks. +- **Load factor:** If you believe a Javelin is the perfect companion for your .50 BMG sniper rifle you probably should tweak this setting. +- **Terrain factor**: Not everyone is used to mountainous terrain. Tweak this until you feel more at home. + +Note that while there currently is no restriction on the value of these settings, it's generally recommended to keep them between 0 and 2. + + +## 2. Unit Specific Settings + +When double clicking a unit you can find a performance factor slider under the ACE options. This unit specific factor will override the global setting, but is only applied to that unit, unless you select multiple and change the slider for all of them at once of course. From a93aad10a0816fac2447197a6854d3029c2a53cf Mon Sep 17 00:00:00 2001 From: PabstMirror Date: Wed, 14 Sep 2016 20:00:18 -0500 Subject: [PATCH 2/6] Fix speeling --- docs/wiki/feature/advanced-fatigue.md | 4 ++-- docs/wiki/framework/advanced-fatigue-framework.md | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/wiki/feature/advanced-fatigue.md b/docs/wiki/feature/advanced-fatigue.md index 197fed9e03..f82bd9dd83 100644 --- a/docs/wiki/feature/advanced-fatigue.md +++ b/docs/wiki/feature/advanced-fatigue.md @@ -14,7 +14,7 @@ version: ## 1. Overview -Advanced Fatigue is a human fatigue simulation based on the information and formulas provided by Bohemia Interactive Simulations, which are [publicly available online](https://manuals.bisimulations.com/vbs3/3-0/downloads/VBS_AdvFatigueSys.pdf) and apparently used in VBS3. However, just to make this clear again, none of VBS3 code was taken over, this is an independant implementation. +Advanced Fatigue is a human fatigue simulation based on the information and formulas provided by Bohemia Interactive Simulations, which are [publicly available online](https://manuals.bisimulations.com/vbs3/3-0/downloads/VBS_AdvFatigueSys.pdf) and apparently used in VBS3. However, just to make this clear again, none of VBS3 code was taken over, this is an independent implementation. ### 1.1 Basics @@ -63,7 +63,7 @@ Since Advanced Fatigue is based on real life biological systems we will explain ### 2.1 How Human Stamina Works -Human stamina is based on the availabilty of adenosine triphosphate (ATP), which is a molecule used by the body to transfer power. Small amounts of ATP are already stored readibly available within muscle cells and larger amounts are generated by several pathways, which then transfer the ATP through blood to the muscles. There are quite a few pathways which generate and store ATP, so instead of simulating all of them, we merge them into 3 generic pathways. +Human stamina is based on the availability of adenosine triphosphate (ATP), which is a molecule used by the body to transfer power. Small amounts of ATP are already stored readibly available within muscle cells and larger amounts are generated by several pathways, which then transfer the ATP through blood to the muscles. There are quite a few pathways which generate and store ATP, so instead of simulating all of them, we merge them into 3 generic pathways. ### 2.2 ATP Pathways diff --git a/docs/wiki/framework/advanced-fatigue-framework.md b/docs/wiki/framework/advanced-fatigue-framework.md index f99d780c78..7ef836b7f2 100644 --- a/docs/wiki/framework/advanced-fatigue-framework.md +++ b/docs/wiki/framework/advanced-fatigue-framework.md @@ -16,7 +16,7 @@ version: ACE provides four settings to tweak Advanced Fatigue. Adjust these factors depending on how hard you want your experience to be. - **Performance factor:** This influences the overall performance of players, malnourished or super soldiers, everything is possible. -- **Recovery factor:** Do you like looking at the landscape or think breaks are boring? Whatever the case, this influences the lenght of your stamina breaks. +- **Recovery factor:** Do you like looking at the landscape or think breaks are boring? Whatever the case, this influences the length of your stamina breaks. - **Load factor:** If you believe a Javelin is the perfect companion for your .50 BMG sniper rifle you probably should tweak this setting. - **Terrain factor**: Not everyone is used to mountainous terrain. Tweak this until you feel more at home. From 200d620d117a356e2930401bb81b7b4f4376acad Mon Sep 17 00:00:00 2001 From: PabstMirror Date: Wed, 14 Sep 2016 22:18:42 -0500 Subject: [PATCH 3/6] spellfix2 --- docs/wiki/feature/advanced-fatigue.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/wiki/feature/advanced-fatigue.md b/docs/wiki/feature/advanced-fatigue.md index f82bd9dd83..1f7cdf8c82 100644 --- a/docs/wiki/feature/advanced-fatigue.md +++ b/docs/wiki/feature/advanced-fatigue.md @@ -61,9 +61,9 @@ The Advanced Fatigue stamina bar has a few changes compared to the vanilla one t Since Advanced Fatigue is based on real life biological systems we will explain some of them in more detail here. -### 2.1 How Human Stamina Works +### 2.1 How Human Stamina Works -Human stamina is based on the availability of adenosine triphosphate (ATP), which is a molecule used by the body to transfer power. Small amounts of ATP are already stored readibly available within muscle cells and larger amounts are generated by several pathways, which then transfer the ATP through blood to the muscles. There are quite a few pathways which generate and store ATP, so instead of simulating all of them, we merge them into 3 generic pathways. +Human stamina is based on the availability of adenosine triphosphate (ATP), which is a molecule used by the body to transfer power. Small amounts of ATP are already stored readability available within muscle cells and larger amounts are generated by several pathways, which then transfer the ATP through blood to the muscles. There are quite a few pathways which generate and store ATP, so instead of simulating all of them, we merge them into 3 generic pathways. ### 2.2 ATP Pathways From 207944a3a2ecd479650a45e5856ac02851ff428d Mon Sep 17 00:00:00 2001 From: BaerMitUmlaut Date: Thu, 15 Sep 2016 12:51:18 +0200 Subject: [PATCH 4/6] Fix pabst --- docs/wiki/feature/advanced-fatigue.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/wiki/feature/advanced-fatigue.md b/docs/wiki/feature/advanced-fatigue.md index 1f7cdf8c82..423f45de6e 100644 --- a/docs/wiki/feature/advanced-fatigue.md +++ b/docs/wiki/feature/advanced-fatigue.md @@ -63,7 +63,7 @@ Since Advanced Fatigue is based on real life biological systems we will explain ### 2.1 How Human Stamina Works -Human stamina is based on the availability of adenosine triphosphate (ATP), which is a molecule used by the body to transfer power. Small amounts of ATP are already stored readability available within muscle cells and larger amounts are generated by several pathways, which then transfer the ATP through blood to the muscles. There are quite a few pathways which generate and store ATP, so instead of simulating all of them, we merge them into 3 generic pathways. +Human stamina is based on the availability of adenosine triphosphate (ATP), which is a molecule used by the body to transfer power. Small amounts of ATP are already stored readily available within muscle cells and larger amounts are generated by several pathways, which then transfer the ATP through blood to the muscles. There are quite a few pathways which generate and store ATP, so instead of simulating all of them, we merge them into 3 generic pathways. ### 2.2 ATP Pathways From e59727d322c6e2d1467c80e05d378ee2e319ba1f Mon Sep 17 00:00:00 2001 From: jonpas Date: Fri, 16 Sep 2016 03:34:54 +0200 Subject: [PATCH 5/6] Remove dependencies list prefix --- docs/wiki/feature/advanced-fatigue.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/wiki/feature/advanced-fatigue.md b/docs/wiki/feature/advanced-fatigue.md index 423f45de6e..7ef8b6b03f 100644 --- a/docs/wiki/feature/advanced-fatigue.md +++ b/docs/wiki/feature/advanced-fatigue.md @@ -96,4 +96,4 @@ Another factor that comes into play here is pathway fatigue - the pathways thems ## 3. Dependencies -{% include dependencies_list.md component="ace_advanced_fatigue" %} +{% include dependencies_list.md component="advanced_fatigue" %} From ed91aec84b8b551ae2f3f9cb15335ffe9fa6413f Mon Sep 17 00:00:00 2001 From: BaerMitUmlaut Date: Mon, 19 Sep 2016 20:37:43 +0200 Subject: [PATCH 6/6] Fixed usage of aerobic instead of anaerobic --- docs/wiki/feature/advanced-fatigue.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/wiki/feature/advanced-fatigue.md b/docs/wiki/feature/advanced-fatigue.md index 7ef8b6b03f..acf7df8276 100644 --- a/docs/wiki/feature/advanced-fatigue.md +++ b/docs/wiki/feature/advanced-fatigue.md @@ -78,7 +78,7 @@ This pathway is essentially responsible for your short term stamina. It has a ve #### 2.2.2 Aerobic Pathways -The two aerobic pathways store way bigger amounts of ATP than the anaerobic one, the first one stores over 1700 times as much ATP (4000 mol) and the second one still over 36 times as much ATP (84 mol) as the aerobic pathway. However, they can also provide (13.3 and 16.7 mmol) and replenish (6.6 and 5.83 mmol) a lot less ATP then the aerobic pathway. +The two aerobic pathways store way bigger amounts of ATP than the anaerobic one, the first one stores over 1700 times as much ATP (4000 mol) and the second one still over 36 times as much ATP (84 mol) as the anaerobic pathway. However, they can also provide (13.3 and 16.7 mmol) and replenish (6.6 and 5.83 mmol) a lot less ATP then the anaerobic pathway. This means that while these will last a lot longer, they do not have such a large impact on your short term performance. Instead, they will drain slowly during the day, which means that at the end you will have less power available than at the beginning, depending on how much you exhausted yourself. However, at that point they will start influencing your short term performance.