[1.12.x] ResearchBodies V1.13.0 (15th May 2022) (2024)

ResearchBodies
is a mod that adds the functionality of tracking celestial bodies to explore them. When you start a new save, you have to choose a difficulty preset (that sets celestial bodies that are shown from the start) and values for research and discovery costs.
This mod's original Author @simon56modder has handed the reigns over to me to maintain support and develop his work going forward due to Real Life commitments.
Big thanks to him and to the other contributors below for making this mod happen. His original Thread can be found here.

ResearchBodies

What this Mod does, or how to use this mod:
This mod will Make Celestial Bodies invisible at the start of a new game. You can change which celestial bodies are visible by default by changing the difficulty setting in the Difficulty Settings Menu. This mod should be played in Career mode as it offers contracts.

At the beginning of a game you can only see a few bodies. First you have to gain enough funds to upgrade your Tracking Station to Level 2.
This will unlock the Observatory Facility. - Yes this mod adds a new Facility to the KSC that acts like a stock facility (destructible and upgradable).
Entering the Observatory you can find out information about the Celestial Bodies you know about, or what research level you are up to for discovered bodies and information about TesearchBodies related contracts.

You will be offered contracts to Search the Skies via the Observatory - or via a Telescope. This mod comes with it's own infrared telescope, but also modifies
the stock infrared telescope (That has been included from Asteroid Day).
You can also install my TarsierSpaceTechnology Telescopes which also integrate with this mod and perform in a similar way (But also can take pictures of the celestial bodies and you can see their details become progressively clearer as you research celestial bodies).

Yes that's right - This mod also alters the physical characteristics of the celestial bodies. So when you first discovery them they are just a grey blob.
As you progressively research them they will progressively become clearer.
This mod also alters the Mapview/Tracking Station so you cannot see celestial bodies you know nothing about. And gradually as you research more about them, things like their characteristics and orbits, etc become known to you.

Finding a Celestial Body:-
You can
a) randomly point your telescopes at the sky and try to scan and find bodies.
b) accept Search the Skies contracts and complete them.

Researching a Celestial Body:-
You can
a) point telescopes at bodies and scan them (or take photos of them if you also have Tarsier Space Technology mod installed).
b) accept Research Body contracts and complete them.

When the research state reaches 100%, you can finally go to this body and you earn science!

Future Expansion Ideas and Unfinished (Planned work):
- Improve the Contracts.
- Further work/tweaks and improvements to the Progressive CelestialBody Maps including support for SCANsat.
- KSPedia pages (instead of a WIKI).

License:
All Software and code in Release versions up to V1.8.1 : MIT
Parts of Code is : All Rights Reserved and code from previous versions remains MIT. Please refer to the Headers in the code files for which code is ARR and which code is MIT.
All Artwork and graphics: CC-BY-NC-SA 4.0

DOWNLOAD
This mod includes version checking using MiniAVC.
If you opt-in, it will use the internet to check whether there is a new version available.
Data is only read from the internet and no personal information is sent.
For a more comprehensive version checking experience, please download the KSP-AVC Plugin
Source Code on GitHub here
If you like my mods and you want to show your support, then you can support me on Patreon:

Install Instructions:

Dependency: You must have installed (NOW included in this package).Module Manager
Dependency: Download and install Contract Configurator Mod (This is required).
Completely delete REPOSoftTech\ResearchBodies and REPOSoftTech\ProgressiveCBMaps folders from GameData before updating from a previous version.
As of V1.8 the install folder location has been changed. Please ensure you remove \GameData\ResearchBodies folder if you have one in your install.
Un-zip into your GameData folder.

Download from SpaceDock, CurseForge, or GitHub
SpaceDock runs and makes mods available to you based purely on donation. If you don't want to pledge to me at least
Consider pledging to keep SpaceDock going if you use it.
- Please NOTE the change in License requirements listed above.

Other Mods Support:
Tarsier Space Technology (TST) - You MUST have V7.3 or UP of TST.
TST will modify it's Telescopes to also act the same as the TB-75M telescope.
Will not offer it's contracts for Bodies you have not fully discovered.
TST telescopes can also qualify for ResearchBodies contracts, find and research bodies through using it's telescope cameras and taking pictures.
Contract Configurator Is absolutely required for ResearchBodies to work and also knows about Undiscovered bodies and bodies not fully researched when offering contracts. - You MUST have V1.24.0 or UP of CC). Please Make sure you have installed/running the Contract Configurator Version for the KSP and ResearchBodies versions you are trying to run.

Integration for other mods:
WIKI pages.
For further info, questions, and if you want to integrate to ResearchBodies and/or the Progressive CelestialBodies Maps features of this mod drop me a PM or find me lurking on IRC.

Support:
Known Issues:

None at the moment.

Be a COOL PERSON and help me by raising bugs and feature requests on GitHub here.

For support please ensure you are following these instructions.
From now on I will NOT respond to requests for support if you have not at least attempted to follow these simple steps.
NO LOGs = NO SUPPORT.

When I ask for a LOG I mean this LOG:

The Logs
These are text files that the game spits out for debugging purposes as it runs; if something broke horribly in-game, there will be something in here about it. You should upload the entire log as a file (i.e. not to pastebin); you can use dropbox or an equivalent host to upload the file. Make sure the entire file gets uploaded; you may have to zip it first, as logs can be very long. Here is where you can find the log:
1. KSP versions 1.3.1 and below:
  - Windows: KSP_win\KSP_Data\output_log.txt -OR- KSP_win64\KSP_x64_DATA\output_log.txt (depending on which used)
    - In case you installed KSP into a Windows protected directory (C:\Users, C:\Program Files or C:\Windows\ and their subfolders) the output log file may be stored in the folder called C:\Users\[username]\Appdata, this folder is usually hidden so you should enable the view hidden folders option (more information). Note that for the demo you should find the output_log.txt file located in the KSP_Data folder.
    - Steam users should right click KSP in Steam, click on Properties, then in the Properties box, click Local Files, then Browse Local Files.
  - Mac OSX: Open Console, on the left side of the window there is a menu that says 'files'. Scroll down the list and find the Unity drop down, under Unity there will be Player.log Aka Files>~/Library/Logs/Unity/Player.log
  - Linux: The log is written to /home/user/.config/unity3d/Squad/Kerbal Space Program/Player.log
2. KSP versions 1.4.0 and above:
  - Windows: C:\Users\<username>\AppData\LocalLow\Squad\Kerbal Space Program\output_log.txt
    - This folder is usually hidden so you should enable the view hidden folders option (more information).
  - Mac OSX: Open Console, on the left side of the window there is a menu that says 'files'. Scroll down the list and find the Unity drop down, under Unity there will be Player.log Aka Files>~/Library/Logs/Unity/Player.log
  - Linux: The log is written to~/.config/unity3d/Squad/Kerbal Space Program/Player.log

My own Mod Log
You will find a file in <install directory>\GameData\REPOSoftTech\ResearchBodies\Plugins\PluginData\ResearchBodies.log.

If you would be so kind as to supply BOTH of these log files when reporting a problem it makes my life so much easier and it makes it more likely I will respond more quickly to you.

Whilst I agree CKAN is a great mod for those that can't use Zip tools. I take no part, nor am I interested in maintaining the CKAN mod metadata for my mods.
Please don't ask me about it but refer to the CKAN mod thread if you are having issues with CKAN or the metadata it maintains.

Change Log:

Spoiler

V1.12.0*Re-compile for KSP 1.10.x.*Fix RemoteTech MM patch file.V1.11.0*Re-compile for KSP 1.8.x*Code Garbage generation improvements.*Add Remote Tech antenna to TB-75.*If you encounter a planet without having discovered or fully researched it it will now no longer set it to fully discovered.Instead it will initially set the discovery to 40% and then over time whilst the vessel stays in the SOI of the planet it will slowly increase the discovery percentage.V1.10.0 *Re-compile for KSP 1.7.x*Fix NREs when entering Tracking Station.V1.9.9*Re-compile for KSP 1.6.1*Fixed issue with ResearchBodies UI if opening in flight before you have opened the Observatory UI at the KSC.V1.9.8*Re-compile for KSP 1.5.1*The Search for the skies contract will now randomly discover a body within observable range. https://github.com/JPLRepo/ResearchBodies/issues/34*Fixed issue with Wernher instructor portrait appearing double. https://github.com/JPLRepo/ResearchBodies/issues/36V1.9.7*Re-Compile for KSP 1.4.1*Implement caching of textures (thanks to AlexALX for their contribution)*Russian Localization (thanks to AlexALX for their contribution)*Removed custom French localization, now uses the KSP Stock Localization for French.*Contract Configurator dependency updated. You must have Contract Configurator v 1.24.0 installed for this mod to work.V1.9.6*Re-Compile for KSP 1.3.1*Fixed orbiting text in Observatory. The sun no longer orbits the sun.*Fixed the research complete message always saying you can now send a vessel to the the bodies parent body. Now shows the correct one.*Fixes to Tarsier Space Technology (TST) integration for researching Galaxies not showing up in the OBservatory or being persisted correctly.*When finding TST galaxies they don't show the Found message twice any more and they show the actual localized Galaxy name instead of their internal name.*Fix harmless NRE when leaving flight scene with the ResearchBodies UI window open.*ResearchBodies Log files are now kept and timestamped in the \GameData\REPOSoftTech\ResearchBodies\Plugins\PluginData folder.*You need Contract Configurator v1.23.3 with this version of Research Bodies.*Removed shinyness changes from the celestial bodies - for the color and detail changing.V1.9.5*Fix fix loading different saves in the one KSP session to show body visibility correctly.*Fix fix discovery of bodies via telescopes and contracts actually appearing in the Observatory (related to the previous).*Fix the OBservatory background texture not showing in any other UI window that uses the default KSP UI skin.*Show the correct Observatory Ranges when Kopernicus is installed in the Observatory Facility upgrade stats window.V1.9.4*Fix Tracking Station and Observatory Upgrade Level checks for contracts.*Fix Range checks for Observatory and Vessels with Telescopes for contracts.*Fix MapNodes appearing in MapView when there are orbits available for any contracts.*Localized strings for the Observatory Facility UI Menus and added Range Information to it's UI.*Fix Bodies discovery levels when you switch saves in the same KSP session, including modded bodies.*Added Background and Contract information to the Observatory Facility UI.V1.9.3*Fix Instructors showing in other KSC Facilities - now only show in the Obervatory.*Fix a few issues with discovery of bodies using the TB-75. NOTE: TB-75 can only DISCOVER previously unknown bodies.It cannot be used to further research a found body by scanning manually. It does have a role to play in the research contracts though thatallow you to further discover information about the bodies.*If you load a save file that was created before you installed ResearchBodies - ResearchBodies will now correctly update the save with thenecessary ResearchBodies information and automatically turn ResearchBodies on. The default difficulty setting will be used as to whichbodies you will be able to see.*You should restart KSP any time you disable or enable ResearchBodies in a save game.*Added Part module info for the telescope parts to display in the extended tooltip in the parts picker in the SPH/VAB.*Fix issue with save file reloading not resetting the visible bodies in the Tracking Station/MapView.*Enabled old mode of clicking to research in the Observatory, etc if the current game is a sandbox or science sandbox game. But this is notmuch fun at all. The mod is intended to be used in Career game mode.*Fixed issue with the popup window not clearing in Flight when the telescope found a body.V1.9.2 - For KSP 1.3.0 Major release and enhancements*Fixed typo in locales for Characteristics and Orbit in UI.*Added Observatory SpaceCenter Facility. Yes - this Facility acts exactly like a stock one. It has TWO upgrade levels that provide different features, functions and contracts for Finding an Researchingcelestial bodies.*New Game and Settings for this mod are now accessed via the Stock Difficulty Settings for new game and existing game.*Fixes issue with Contract Configurator.*Fixes integration with TST (V6.6 and above).*Bodies occluding the telescopes are taken into account when searching for new bodies.*Capped Research Percentage at 100%*Amended Contract processing to use Weighting System override in KSP 1.2.1 so that contracts should not be generated for undiscovered bodies.*Fixed GUI for when Research State is < 10%.*Added pop-up menu when a body is found in flight.*Integrated Contract Configurator mod for ResearchBodies Contracts. Contract Configurator mod is now a dependency and must be installed alongside this mod.*You can no longer just click and research bodies from the Observatory. You must complete contracts or find and research them via the telescopes.*Full 1.3.0 Localization/Language support. Game is translated into French and Spanish. To access French, as it is not supported by KSP yet, you have to go into the* difficult settings and select French manually. For all other languages simply set your language for KSP to your language.* Note - Mod support Russian, Japanese, Chinese - but has not been translated at this stage. Contract text is not translated to French or Spanish currently.* You now have to use contracts or Telescopes to advance research on celestial bodies (no more just click in the UI).* Changed default research and science values - to something a bit more balanced.* Celestial Bodies that you have not discovered no longer appear in the Mapview or Tracking Station; icons do not appear and tab, alt-tab do not work for undiscovered bodies.* If you also use TarsierSpaceTechnologies Telescopes you need to update it to V6.8V1.9.1 - Development BuildWARNING: This is a Pre-Release still under development!!Changes since last Dev version.Repositioned Observatory models.Fixed TST integration.Added SAS, hibernation mode and ModuleDataTransmitter to the TB-75 telescope.Fixed Obstruction code for TB-75.Fixed GUI for researched bodies.Began adding Contract Configurator integration for contracts.Two Basic contracts available, but are not properly integrated. Testing feedback much appreciated.Make the debugging settings option dynamically update from the in-game mini-settings.Lots of CC integration changes started (WIP)...- NOTE: ResearchBodies now REQUIRES Contract Configurator V1.22.2Added Observatory Ranges and allow old researchin career mode settings to Database file.Increase screen msg timeouts.V1.9.0 - Development Build

WARNING: This is a Pre-Release still under development!!
V1.9.0-Develop (10-23-2016) == DEVELOPMENT BUILD
*Fixed typo in locales for Characteristics and Orbit in UI.
*Added Observatory SpaceCenter Facility. Yes - this Facility acts exactly like a stock one. It has TWO upgrade levels that provide different features, functions and contracts for Finding an Researching celestial bodies.
*New Game and Settings for this mod are now accessed via the Stock Difficulty Settings for new game and existing game.

*Fixed Reflection for Contract Configurator compatibility.
*Re-positioned Observatory models to correct locations.
*Fixed TST integration.

*Remove log message for stock Contract removal.

V1.8.1 (07-30-2016) ==Now ignores Contract Configurator Contracts as it is now fully ResearchBodies aware.If you use Contract Configurator Mod then get this update. Otherwise there is nothing much for you in this small update.Changed License - Permissions granted from previous authors. All software code is now MIT license. All Graphics and Artwork remains CC BY-NC-SA 4.0

V1.8.0 (07-10-2016) ==*Re-factored so much of the code... Under the hood now uses Scenarios to automatically save and load the game state to the persistent.sfs file.*If you have an old researchbodies.cfg file in your save folder V1.8.0 will read it and convert it into the new format,save your game into the persistent.sfs file anddelete the old savegame file (researchbodies.cfg).*Moved Mod Folder from \GameData\ResearchBodies to \GameData\REPOSoftTech\ResearchBodies. Please ensure you remove any \GameData\ResearchBodies folders from your install.*The database file and locales files remain as the default settings for new games.*Fixed a whole bunch of little bugs along the way (both real and potential).*Re-factored how the Discovery mechanism works. So no more clicking forever, but still some randomness. There was a potential bug that meant the moreyou clicked and didn't find anything the less likely you would on following clicks, which only reset when you changed game scene.*Science reward for finding a body with the telescope is now the base science reward (that you get in the Observatory) PLUS the science reward that isset in the config file for each telescope part.*Some more screen messages, eg: When you don't actually have enough EC to scan for bodies (previously you got no indication that was the problem).*Fixed the Part Menu - messages now display correctly for when you discover and don't discovery bodies. Also added a list of the alreadydiscovered bodies to the Menu so you can see what bodies have been discovered and it will update when you do discovery new bodies in flight.*The ResearchBodies part action button (right click menu) is now disabled (not visible) if ResearchBodies is not enabled in current save file. eg: sandbox game and config has enableinsandbox = false.*Ignored/Auto-discovered Bodies (based on difficulty setting at start of new game) also display these automatically in the Observatory menu.*If you enter the SOI of a previously un-discovered Body or a Body that has not been fully researched it will now be automatically discovered andit's Research Program will be fully completed. Might look to change this in a future version to auto-discover but depending on the vessel type(Probe or manned/kerballed) set the research percentage to a more appropriate amount and perhaps require the vessel to remain in SOI toincrease the research percentage over time. (But that's for a FUTURE version).*Input (keyboard) Control locks are set on for new games until you select your new game settings. (can't use menus, flight, etc).*Compatible with Asteroid Day for KSP 1.1.3 update.*NOW the BIG one:- Progressive CelestialBody visibility is now included. Yes the celestial bodies will start with very low detail in flight andin the tracking station. As you find them and research them, the details become clearer. This is still very basic functionality. Plan to expand thisgreatly to include other mod integration like SCANsat scanning to provide the final levels of details.V1.7.2(06-01-2016)==*ChangedContractcancellation(whenacontractisgeneratedforabodynotyetdiscovered)toWithdrawinsteadofCancel.Thiswillnotpenalisereputation.*FixedbugwhereabovecodewascausingissueswhencancellingcontractsmakingtheMissionControlbuildinginaccessible.*IgnoreBodieswithRadius<100m(Sigma/BinariesinKopernicus)andhandlesbarycenter/orbitsofsigmabinaries.*AddedsupportforBlizzyToolbar(canswitchbetweenStockAppLauncherIconandToolbarintheSettingsMenu-However,itdoesnotsavethissettingbetweengamesessions-nextversion).*Re-factorandclean-upofthecodestarted.*IfKopernicusisinstalledchangestherangeofthetelescopeto540millionkilometers.(standardis100millionkilometers).*AddedabilitytodoTooltipstotheGUIwindows(Haveonlyaddedafewfornow,moretocome).*Changedthein-flightTelescope-ResearchBodieswindowtoindicatetheECusageeachtimeyoupresstheSearchbutton.*Addedamessagetothein-flightwindowtoindicateiftherearebodieswithintheangleofthetelescopebutaretofarawayforthetelescopetodetectthem.*FixedissueswithKopernicusinstalledandactuallydiscoveringcelestialbodies.*Movedcachedatainto/ResearchBodies/Plugins/PluginDatatoavoidresettingModuleManagercacheloadonstartupwhenthesefileschange. V1.7.1(05-10-2016)==*FixederrorswithV1.7usingdeprecatedRenderingManagercallscausingParttobreakKSP.*AddedKSP-AVCversionchecking. v1.7(05-04-2016)==*UpdatedforKSP1.1.2*ResearchBodieswindowcanbeopenedeveniftrackingstationislevel1,howeveritsfeaturesaren'tuseable.*AddedhovertextforResearchBodiesicon*ModuleManagerisnowversion2.6.24 v1.6(01-27-2016)==*AddedJPLRepo'scodeinordertomakeacompatibilitybetweenTSTandResearchBodies*Tweakedtelescopestats*Buildedwith1.0.5*ModuleManagerisnowversion2.6.18*Happynewyear v1.5(10-10-2015)==*Addeddifficultyselectionpanelongamesavestart*AddedSpanishlocale*Tweakedtelescopestats v1.4(08-26-2015)==*NewtelescopemodelmadebyforumuserWell*Completeoverhaulofthetrackingprocess:*firstfindacelestialbodyinspacewiththetelescope*thengobacktothespacecenter,launcharesearchplanforthisbody.*whentheresearchstateis100%youcanlaunchvesselstoit*AddedWernhervonKermanportraittospacecenterUI*AddedLocalesystem*AddedFrenchlocale*findingbodieswiththetelescopenowrewardsscience*ModuleManagerisnowversion2.6.7*APIaccessibilityforothermods*tweaksontelescopestats  v1.3(07-27-2015)==*Trackingbodieswithtelescopenowrequireslookinginthedirectionofthebodytotrack-->NOTE:stillneedstobeunderthe75millionskmradius*Addedtextsonbodydiscovery*Trackingstationnowrequiresbeinglevel2or3inordertotrack(configurabletoallowtrackingwithlevel1)*RemovedspacefieldUI,backtobutton v1.2.2(07-07-2015)==*FixedprioritysetforKopernicusmods v1.2.1(07-06-2015)==*Hotfix*updatesource v1.2(07-05-2015)==*BetterUI*TweaksonTB-75Mstats*Possibilityformodderstoremovebodiesfromtheignorelistusing'!body' v1.1(07-03-2015)==*AddedTB-75MTelescopepart*trackingusingthetelescopedoesnotcostscience/funds!*Improvedtrackingprocess*betterinternallogic*tweakedpriorities*harderthanbefore*Reducedsciencecost*Thehigheryourtrackingstationlevelthebetterthetrackingprocessis*AddedModuleManager(forAsteroidDayofficialmodcompatibility)*Correctedsmallproblemwithcurseforge*updatedsource v1.0(07-02-2015)==*InitialRelease

Current Contributors (V1.7.1 above):
@JPLRepo - All codes changes, packaging, support, English Translation.
@simon56modder - French Translation.
@fitiales - Spanish Translation.
@MerlinsMaster - Observatory model and texture
@AlexALX - Caching of CB textures and Russian translation.

Original Contributors (up to V 1.7):
@simon56modder : Original Code, French and English locale
@Well : Telescope model and texture
@fitiales : Spanish locale
@JPLRepo : code made for compatibility with Tarsier Space Technologies

[1.12.x] ResearchBodies V1.13.0 (15th May 2022) (2024)

Future Expansion Ideas and Unfinished (Planned work):- Improve the Contracts.- Further work/tweaks and improvements to the Progressive CelestialBody Maps including support for SCANsat.- KSPedia pages (instead of a WIKI).

License:All Software and code in Release versions up to V1.8.1 : MITParts of Code is : All Rights Reserved and code from previous versions remains MIT. Please refer to the Headers in the code files for which code is ARR and which code is MIT.All Artwork and graphics: CC-BY-NC-SA 4.0

Future Expansion Ideas and Unfinished (Planned work):
- Improve the Contracts.
- Further work/tweaks and improvements to the Progressive CelestialBody Maps including support for SCANsat.
- KSPedia pages (instead of a WIKI).

License:
All Software and code in Release versions up to V1.8.1 : MIT
Parts of Code is : All Rights Reserved and code from previous versions remains MIT. Please refer to the Headers in the code files for which code is ARR and which code is MIT.
All Artwork and graphics: CC-BY-NC-SA 4.0