FARGE v4.1.0 Alpha Readme
License: CC0 1.0 Universal (see License.txt)

AI Authorship Disclaimer: The majority of the code in this mod was written by an AI. No code was plagiarized from other mods. This Readme is human-written. 

SUMMARY:

This mod implements a basic form of ground effect in KSP 1.12.5 games which use Ferram Aerospace Research! This will make takeoffs easier and landings harder. Ground Effect Vehicles are much more viable now as well. This phenomenon manifests as difficulty slowing down or a tendency to "float" over the runway instead of descending.

Version 4.1 now implements wingspan calculation. Craft will experience a drag reduction of 50% at half their wingspan above ground. The drag reduction effect tails off as you approach a radar altitude equal to your wingspan, and then goes away. This more closely mimics real-life behavior and craft with very large wingspans will now fly appropriately well in ground effect.

SUPPORT:

Please raise an issue on GitHub! Ensure debugMode = true in your settings and please provide your player.txt and KSP.txt logs.

CREDITS:

This mod does not redistribute content from other software. However, I'd like to give special thanks to the following people:

Capital-Asterisk (GitHub) for their original concept and implementation of ground effect in non-FAR KSP games. Their work is a great implementation of this phenomenon and is what got me interested in adding a simplified version of ground effect to FAR as well!

dkavolis (GitHub) and ferram4 (GitHub) and many others for their work on Ferram Aerospace Research.

linuxgurugamer (GitHub) for their tireless work on supporting KSP 1 mods and modders. More than half of problems I experienced while troubleshooting were solved after reading a forum post from LGG.

COMPATIBILITY:

-This mod is built for KSP 1 version 1.12.5
-This mod REQUIRES Ferram Aerospace Research and all its dependencies
-This mod works with and RECOMMENDS Kerbal Wind and KerbalSoaring
-This mod has not been tested with other planet packs but should be compatible


CAT:

.::::----===========++++++++++++++++++++++==+:     ==============---------------
::::::---==========++++++::++++++++++++++++==      ===============--------------
::::::---===========+++++::::+++++++++++++++        ==================-=--------
=:::::---============+++++:-  =++***+++++++         =======================-----
===--::----==========+++++:-=:  +**+++++++          =======================-----
=====--------=========+++++:::.   ..-.              ========================----
:=+====-------==========+++:: :.    .               ======================------
--==+++===-------==========.::: :..:::              +==================---------
======+++===-::----=========:: .::::::.            .=============---------------
++======+++===-:::::---===-:: .:-:::::              ==========------------------
*++++===========:::::::---:     =::::                ==========-----------------
--=*+===-----=====:::::::-:    ::::::.. ...          ==============-------------
-::::======:---=====:..:::=:::=+::::::::::::...      ============-===-==--------
::::::::*====-:::=====:.::**+==.  ..:::.::::::..   .:=============-==-=--=------
@*=::::.::-+====-:::====::=**==:   ::::::::::::::::::=======================----
@@@@*=-::::::++==========-=**+=-: ...::::::::::::::::========================-=-
@%%@@@@*==-:::::+====--:-=**+*=-.    .::::::::::::::-========================---
%@@@@@@@@@*=:::.. ===---:-**+==*=-:::.:::::::::::::::=========================--
%##@@%%@@@@@@*.   ======:-=%*==-*+=::::::..::::::::::==========================-
%*@%@@%@#@#%@%%%* ==--=-==+#*=-::::.........:...:::::-++=======================-
*%**#%#**##%%%%#@-====-=--%*+=:::::............::::::-=++======================-
########%##%%%#@@*===---==#*=-::::..:.........::::::::+++++=====================
*%*@@*@@@@#@@%#%@*===----#*+=-:::::.............::::::+++=+=====================
*@@%@@%@@#@@@#*%%-===----#*+=::::.....:......:::::::::+++++====================-
@%@@@*@@*@@%@%@@+:===---=#*=-:::::::::..:..:::::::::::+++++======+=============-
@@@*@@%@@@@@@%%%+===----=#*=--:::::::::.:::::::::::::=++++-==+*++++-===========-
%@@@%@@@*@@@@%@@*+==----=%*+=-::::::::.::::::::::::::=+++**+++++==+:==========--
@@+@@@*@@@*@@%*@*+===----#*+=--::::::::::::::::::::::=+++**+=++===++=========---
@@@%*@@@*@@@*#@@=+==----+**+=--::::::::::::...::::::::+++**===+++++==========---
%*@@@%*@@@%@@@%@:===----***+=-:::::::::::::.::::::::::++++*+==+++++=========----
@@#%@@@@*@@@*#%%:===----:#*==-:::::::::::::::::::::::=++++*++++===++=========+=:
@@@@%+@@@@%#*%#%====----=#*+=-:::::::::::::::::::::::-=+==+++=--========----==: 
+@@@@@@#%@@@#@@*#===-----%**=:::::::::::::::::::::::: ===============--------:.:
@@#+@@@@@@%*#@@@*===-----*#*=-::::::::::::::::::::::.  :--------------------:+=:
@@@@@%+%@@@@#%@=====----==#*+-::::::::::::::::::::::   ::::::---------------:**=
@@@@@@@@@%##*#%++====----=%#+=-:::::::::::::::::::::    ::::::-:-------------+%-
%#+*%@@@@@@@@%#+=====----**#*=-:::::::::::::.:::::::     --------------------=%:
@@@@@@%%#**%@@%=+====----#**#+=::::::::::::.::::::::      --------------------%#
@@@@@@@@@@@+@@@-+====---:**=#=-:::::::::::...::.::::.     :------------------:+=
#%%@@@@@@@@*@@@.+=====--:-%==+-::..::::::::.::::::::.      -------------------+=
%%%%@@@@@@@*%@@:+=====--:=%*==::...::::::.....::::::.     ..------------------==
@@@@@@@@@@@#***=++=====-::=%+=-:......:.:...:::::::.   ...:::-----------:       
==##@@@%#*####*#+++===-:::=*#+-::....:::::...:::::.  ....::::---------          
::::#%%@@@@*%@=#+++==--:::-=%*=::....----:::::::::.........::=-------           
==--=-==+**%%@=++++@@==++===+#+:::..:+===-:..::::...........                    
+=.:::=++++====+++=@#.. *=***%*=::.. ====-:..:::::.........                     
:::.::=#=++====++=@.:... :--:*#=::.  ===--::.::::........ .                     
=-::=-==--:---=+====--..:*####%+-:.  .=-::::::.........   :                     
:::..:===%::.:-====***********#*=:.   --::...:::.         :=+*********          
::##.+-===-*%%%###*********####*=:.   -:::..::::.         :-===+++++++          
::**:%%%%%%%%%%###********#####*=-:.  :.-:...:::...       .::::::::---          
%%%%%%%%%%%%%%###************##+=:::..: ::.:::::. .    .....::::::::...         
%%%%%%%%%%%%%%##**************=#*=:-:::=::...::::  ........:::::::.....         
.-*%%%%%%%%%%###*************+#*=:....:*:--::..:::-:::::::.:::::::.:...         
............:=*##*************+*:.....:+--=-:.::::====---::::::::::::::.        
........................:=****+..     .:.    ::.....::::::::::::::::::::...     
.......................... ..........::======-:.:::.:::::::::::::::::::::.......
==:::%#%=:  .......... .. .....................::-====--::::::::::::::::::::.:..



