Vision:
The vision of the ARPI Survival Assets is to enable missionmaker, players and zeus to simulate struggle of survival in the wilderness - but not to kill or harm players in a severe way. We want to make things difficult - but don't want "to take players out of the ongoing game".


How does it function?
Therefore we adapt the functions of the "ACE3 Field Rations Framework" to simulate hunger and thirst. Additionally ARPI provides options to catch fish, harvest vegetables and fruits, craft utilities to cook or grill meals and purify water by boiling or other procedures. The framework is highly configurable with modules in the editor. Some functions are hard-scripted to increase the speed of mission building, but most functions must be implemented with the modules.


How to set up the "ACE3 Field Rations Framework"?
To activate the framework you must use the ACE3 functions. We recommend to create a "cba_settings.sqf" in your mission file and script your ace and cba settings here. For the Field Rations Framework we recommend:

force force acex_field_rations_affectAdvancedFatigue = true;
force force acex_field_rations_enabled = true;
force force acex_field_rations_hudShowLevel = 0;
force force acex_field_rations_hudTransparency = -1;
force force acex_field_rations_hudType = 0;
force force acex_field_rations_hungerSatiated = 1;
force force acex_field_rations_terrainObjectActions = false;
force force acex_field_rations_thirstQuenched = 1;
force force acex_field_rations_timeWithoutFood = 4.5;
force force acex_field_rations_timeWithoutWater = 3.5;
force force acex_field_rations_waterSourceActions = 2;

These settings will create a noticable struggle and force the player to eat and drink at least twice in a 3hr mission, depending on physical activity.



Progress Modules
These modules can be placed in the editor and are highly configurable. We describe it here: https://psteamcommunity.yuanyoumao.com/workshop/filedetails/discussion/1400734335/3409802983882424743/

Ressources
Ressources can be anything (stones, wood, rusty metal pieces, mud, sand, raw meat, raw fish, bamboo s.o,). We try to make ressources combinable to enable the player to craft stuff by themselves. Some ressources can be gathered alltime ingame, some harvest functions must be prepared by mission-editor or in an ongoing mission by zeus. Ressouces are required to be in the players inventory (somewhere).

Garbage Sources
You can search in some trash bins and dumps for resources. Maybe you will find something to craft a tool?

Food and water
ARPI provides food and water in different qualities and types. The basic categories (in the scripts - not in the ingame labels) are "raw ressources (meat&fish)", "refined food (grilled&cooked)", "raw eatable food (fruits&vegetables)", "ambivalent food (rotten food)", "clean water" and "dirty water". Here we describe some of the functions:

• Raw ressources can be harvested with specific tools from the environment. You always can catch fish in the sea, but to encounter specific harvest places, they must be prepared by mission editor
  
• Raw ressources can be craftet at campfires to refined food
  
• Refined food gives "ace-blood" regeneration over time and will slowly increase your general health status - but it will NOT heal your permanent wounds. If your nutrition level is good, you are fitter and stronger.
  
• Ambivalent food increases one factor but also has negative effects, for example a salty sausage will increase your blood regeneration rate but increase your thirst also.
  
• You can collect dirty or clean water at different sources and refill bottles or canister
  
• Drinking dirty water can cause diarrhea - of course there are some cures for that.
  
• Dirty water can be refined in different ways to clean water
  
• Clean water will increase your ace stamina regeneration level. Drinking a whole bottle will give you a stamina-buff for a random time.

Clean Water Sources:
Land_Sink_F
Land_ConcreteWell_02_F
Land_WaterTank_03_F
Land_WaterTank_04_F
Land_BarrelWater_F
Land_WaterCooler_01_new_F
Land_Water_source_F
Land_WaterCooler_01_old_F

Dirty Water Sources:
Land_StoneWell_01_F
Land_ConcreteWell_01_F
Land_BarrelWater_grey_F
Land_WaterBarrel_F
Land_WaterTank_F
Land_WaterTank_01_F
Land_WaterTank_02_F

Fish sources:
Every ocean, river and water. You must be nearby such a source to be able to use fishing tools.

Raw meat sources:
This is a real "pain-in-the-ass-topic" in Arma3. The game engine differentiates between "local spawned" and "multiplayer spawned" animals (agents). The player cannot differentiate visually "what is what". If the player kills a "local spawned animal", there will be no option to harvest raw meat. Therefor we created the "Hunter Ability Item" which allows the player to randomly spawn animals nearby, hunt them down and harvest food (with knife or suitable tool). Of course "agents" spawned by zeus or mission-editor will also provide raw meat.

Vegetables and fruit sources:
Must be defined with the "ARPI Progress Module" or the "ARPI Gathering Module" and syncronized with an object by the mission editor.


Crafting at Fireplaces
At fireplaces you can cook and craft some items. Here some examples:

• Cooking requires meat or fish, a pot and clean water in your inventory. Cooked meals are very healthy and satisfying (and provide a high ace-blood-regeneration rate)
  
• Grilling requires only meat or fish but grilled stuff only has medium blood regeneration rate
  
• Cleaning dirty water on a campfire requires a pot, some burning material and dirty water
  
• Coal is required for some crafting reciepts. You can craft coal at campfire from burning materials.
  
• Cleaning dirty fabric shreds with cooking them is also possible. You need a pot, water and a fire source.

Questions? Bugs? Send them here!