[AnyOS] KSP Mod Admin v2 - Mod install with a few clicks

[MacTee]

 

 

 

 

 

Welcome to KSP Mod Admin v2

 

KSP Mod Admin is a mod managing tool for KSP on any OS.
It provides simple and fast mod managing and keeps your mod collection up to date.

OK, no rocket science but it speed up the installation or removal of mods and so you will have more time to do rocket science .
It also let you choose which parts of a mod should be installed.

Downloads:

KSP Mod Admin AnyOS (win)
KSP Mod Admin AnyOS (linux & mac)

Screenshots:

Features:

• KSP Version independent!
• Localized: English, German, Russian, Italian, more are coming ... (contact me if you want to help)
• Multi OS support: Win, Linux and Mac (via Mono-Project (see www.mono-project.com/))
• Supports multiple installations of KSP. Change between different KSP installations with one click.
• Support of ZIP-, RAR- and 7ZIP- mod archives.
• Add mods or crafts with drag & drop, file selection or URL (Support of KSP Forum, Curse, CurseForge, SpaceDock, GitHub and BitBucket urls).
• AVC Plugin version file detection.
• Auto detects install folder for the mod (if possible the mod will be installed to the GameData folder).
• Easy install destination control (for those cases the destination can't be auto detected).
• Choose what to include, just by hook or unhook parts of a mod.
• GameData scan for installed mods (they will be added to the mod selection if they aren't listed already).
• Read text files of a mod by double click the files.
• Update support:
  • for KSP Mod Admin.
  • for Mods (includes auto check for updates and auto install/update of outdated mods).
• Conflict detection and easy conflict solving for files that are referenced by more than one mod.
• Easy to use backup system. To backup your KSP saves or part customizations.
• Part and craft management.
• Flag management and import.
• Plugin support for "3rd party" extensions (See KSPModAdmin.Translation.Plugin as a sample).
• Project code included or on GitHub (VS2013 Solution - Language: C#).

Requirements:

• Windows:
  .Net 4.5 (Web installer included in download or see here)
• Linux & Mac:
  Mono
  • Linux install instructions http://www.mono-project.com/docs/getting-started/install/linux/
  • OSx install instructions http://www.mono-project.com/docs/about-mono/supported-platforms/osx/

Installation:

• Windows:
  • Install the .Net4.5 framework from Microsoft (Win7 or lower).
  • Just extract/copy the KSP Mod Admin folder from the zip to any location you want.
  • Start KSP Mod Admin ...

• Mac:

  • Install the Mono framework.
  • Just extract/copy the KSP Mod Admin folder from the zip to any location you want.
  • Start KSP Mod Admin via mono ...

• Linux:

  • Install the Mono framework. (by type "sudo apt-get install mono-complete" in your terminal)
  • Install Mozilla certificates. (by type "mozroots --sync --import" in your terminal)
  • Just extract/copy the KSP Mod Admin folder from the zip to any location you want.
  • Start KSP Mod Admin via mono ...

Known issues:

GitHub - Known issues

Wiki:

GitHub - Wiki

Issue tracker:

GitHub - Issue tracker

Special thanks to:

4o66, timmers_uk, Gribbleshnibit8, HubertNNN, diomedea, SVlad, TheAlmightyOS, cy-one, Stone Blue, Benzschwagel, TheCardinal, MrHanMan, Meatplow, MorisatoK, Reisu79, Jivaii, hiegova, craigmt1, LeadMagnet, Bergion, shadow651, Horman, cpottinger, Roger25000, zapman987, Pondafarr, ... any many more!

License:

• This project (KSP Mod Admin) is published under the CC BY-NC-SA 3.0 DE license.
  (With this license you are allowed to copy, change and redistribute this work, when
  • you name me (write a mail to MacTee to discuss details)
  • the redistribution is non commercial!
  • and your redistribution have the same license)

• KSP Mod Admin uses several other open source projects with different licenses (a copy of most licenses could be found here KSPModAdmin\docs\Licenses\...):

  • TreeViewAdv
    Project URL: http://www.codeproject.com/Articles/14741/Advanced-TreeView-for-NET
    License: Berkeley Software Distribution License see KSPModAdmin/Docs/Licenses/TreeViewAdvLicense.txt for details.
  • CheckBoxComboBox
    Project URL: http://www.codeproject.com/Articles/21085/CheckBox-ComboBox-Extending-the-ComboBox-Class-and
    License: The Code Project Open License (CPOL) 1.02..
  • FolderSelectionDialog
    Project URL: http://www.lyquidity.com/devblog/?p=136
    License: There’s no license as such as you are free to take and do with the code what you will.
  • SharpCompress
    Project URL: https://sharpcompress.codeplex.com/
    License: Microsoft Public License (Ms-PL).
  • HtmlAgilityPack
    Project URL: http://htmlagilitypack.codeplex.com/
    License: Microsoft Public License (Ms-PL).
  • Newtonsoft.Json
    Project URL: http://json.codeplex.com/
    License: The MIT License (MIT).

   

Support me with a download from CurseForge (Code only!)

Or =)

Feel free to contact me MacTee

Or visit the german thread.

Edited November 2, 2016 by MacTee

[MacTee]

How to guide

Don't be afraid of this long "how to", the mod handling is quite easy, just hard to explain =)

General info:

KSP MA provides for almost all controls a ToolTip, try to hover over a button if its use isn't obvious.

"Short" usage description:

After you have started KSP MA aOS the first time and you have selected a KSP install folder and a language, KSP MA is ready to use.

Additional KSP paths:

You can add additional KSP install folders (if you have more then one) via Option Tab -> Path Tab.

Add a mod:

There are several ways to add a mod to your ModSelection (the TreeView on the Mod Tab).

1. You can Drag & Drop a mod archive (.zip, .rar, .7zip or .craft) into the ModSelection.

2. With the "Add mod archive" button. You can chose a mod archive via a file browser dialog.

3. With the "Add dialog" button.

The "Add dialog" will pop up:

(If you add a mod the first time via URL you will be asked for a download folder, where KSP MA should place the downloaded mod).

After you have (just) added a mod (and not installed already) it will be shown in the ModSelection like this:

(For this mod a install path was detected automatically)

For some mods KSP MA can't detect a install path automatically they will be shown like this:

You can tell KSP MA to just dump such mods to the GameData folder with the "Fallback to GameData folder" option on the Option Tab -> Misc Tab:

But this is not recommended, cause it could lead to problems with the conflict detection.

Change mod destination:

You have to select a install folder for those mod manually by right clicking it and chose "Destination" -> "Select new destination":

This dialog will pop up to chose a new destination:

Install a mod:

After you have added your mods:

You can chose which parts of a mod should be installed by checking or unchecking the CheckBoxes next to a mod file/folder.

When you are ready with the selection of parts of your mods you have to click the "Process all mods"

This will start the installation or deinstallation of your mods.

Checked parts of a mod will be installed unchecked ones won't or will be deinstalled.

Now your mods are installed and ready to use in KSP.

You can change the part selection anytime you want, just remember to click the "Process all mods" button after you have changed the checked state of some mods / mod parts.

Remove a mod:

To remove a mod from KSP just uncheck it and press the precess button and the mod will be deinstalled, but stayes in the ModSelection.

To erase a mod from the ModSelection click the "Remove Mod" or "Remove all mods" button.

KSP MA will uninstall the mod and removes it from the ModSelection.

Mod update check support:

The "Mod update check" and "Mod update" feature will only be available for mods that where added via URL or mods that provide a AVC version file with the needed informations.

To check for mod updates click the "Update check for all mods" button:

KSP MA will then check for updates for all mods with a VersionControl.

If a mod is outdated it will be displayed in blue:

To update a mod click the "Update all outdated mods" button:

Auto mod update check configuration:

You can configure KSP MA aOS to automatically check for mod updates by the following settings:

KSP Mod Admin update check configuration:

You can configure KSP MA aOS to automatically check for KSP Mod Admin aOs updates by the following settings:

Import 1.4 KSPMA cfg to KMA²:

It seems, that a simple swapping of the Name and Key XmlAttributes in the old cfg file (from the KSP install folder), is enough.

Step by Step:

1. Copy the old KSP MA cfg file and rename it to KSPModAdmin_aOS.cfg
   
2. Open the copy in your favorit text editor
   
3. Remove the General nodes:
   

   <General>
   ...{some other settings}
   </General>
   

   
   

4. Use the Search & Replace function (ctrl + h) to rename Name=" to Name1="
   
5. Use the Search & Replace function (ctrl + h) to rename Key=" to Name="
   
6. Use the Search & Replace function (ctrl + h) to rename Name1=" to Key="
   
7. Save and KMA² should be able to read the old cfg file.
   

Known issues:

After i start KSP MA i get the following error message:

"Unexpected runtime error: "An attempt was made to load an assembly from a network location which would have caused the assembly to be sandboxed...""

This happens when windows has flaged the files of KSP MA as a web download.

You have to allow access to following files HtmlAgilityPack.dll, KSPModAdmin.Core.dll, Newtonsoft.Json.dll, SharpCompress.dll and plugins/KSPModAdmin.Translation.Plugin.dll manualy by

1. Right click the dll

2. Chose properties

3. Click "Unblock"

-> see StackOverflow article.

Edited June 4, 2015 by MacTee

[ROFLCopter64bit]

What language and is there source code?

That's just the developer inside of me talking.

[MacTee]

What language and is there source code?

That's just the developer inside of me talking.

Written in C# and yes source is included.

[ROFLCopter64bit]

Written in C# and yes source is included.

Yay Now I have more basis for silicon.

[KOCOUR]

does this work in 0.20.2?

[MacTee]

does this work in 0.20.2?

Yes, is does.

An update will coming soon, if my new born doughter let me find the time to finish the last tasks. =)

[KOCOUR]

if my new born doughter let me find the time to finish the last tasks. =)

Congratulation man!

[MacTee]

Congratulation man!

Thank you! =)

[MacTee]

Ok here it is ... The new version of KSP Mod Admin v1.1.0

What is new? See first post.

[MacTee]

ups there was a bug ... <squish> ...

[TheCardinal]

First of all, congratulations on the birth of your daughter.

Amazing that you still have found the time to update this application.

I must say, you've done a superb job! This is a perfect way to use KSP and (all) the mods to the fullest!

Everyone has some parts which he or she likes the most and uses frequently. Now everyone can without having to add several parts which aren't used anyway. If you change the text on the button from "Lunch Kerbal Space Program" to "Launch Kerbal Space Program", it will be perfect.

The only real objection i have at the moment is "Why didn't i create that program".

[MacTee]

First of all, congratulations on the birth of your daughter.

Amazing that you still have found the time to update this application.

I must say, you've done a superb job! This is a perfect way to use KSP and (all) the mods to the fullest!

Everyone has some parts which he or she likes the most and uses frequently. Now everyone can without having to add several parts which aren't used anyway. If you change the text on the button from "Lunch Kerbal Space Program" to "Launch Kerbal Space Program", it will be perfect.

The only real objection i have at the moment is "Why didn't i create that program".

Thank you!

And the button will be renamed in the next iteration

[MacTee]

New version 1.2.0

Now with integrated WebBrowser for direct download and adding of mods.

[TheCardinal]

Bug notification: Only the first Downloaded mod (with the browser) is placed in the chosen directory, the following mods are added to the KSPModAdmin directory.

[MacTee]

Bug notification: Only the first Downloaded mod (with the browser) is placed in the chosen directory, the following mods are added to the KSPModAdmin directory.

thanks!

and fixed ...

On donwnload of non *.Zip files a MessageBox will popup.

In the next version *.craft files will be supported too.

[TheCardinal]

One of the things i'm missing in the Mod Admin at the moment is a button to remove all the selection marks. At the present all the marks have to be removed one at a time.

[MacTee]

One of the things i'm missing in the Mod Admin at the moment is a button to remove all the selection marks. At the present all the marks have to be removed one at a time.

Do you want a multi select for the Mod-Selection, so you can deinstal & remove more then 1 mod with 1 click?

Or do you meen a button to unhook all checkboxes of the Mod-Selection (this is already implemented check contextmenu)

[MacTee]

New Version 1.2.2 -> see first post.

[MacTee]

v1.2.4

- Loading of older configs bug (v 1.2.3 only) fixed.

v1.2.3

-Crash during resize of window fixed - Thanks to Dave (sry cant answer you via email -> the adress seem to be broke)

Edited July 7, 2013 by MacTee

[xtremedew]

No Problem - Glad to see this working again. Keep up the good work!

[MrHanMan]

I'm getting the following unhandled exception when trying to select a new destination on an item in the root of an addon.

Full text here

Edited July 10, 2013 by MrHanMan

[MacTee]

I'm getting the following unhandled exception when trying to select a new destination on an item in the root of an addon.

Thanks for reporting the issue!

I think i already fixed this bug in the next version (1.2.5 coming soon).

But to be sure can you give me the name of the addon please.

And maybe you remember which item causes the trouble. (was it a file or directory?)

[MrHanMan]

MechJeb and Kerbal TV were the first I noticed it on. I just tested a bit more, and it looks like it does it everytime if you ever hit the select folder dialog. The next time you open it, I get that error.

Edited July 10, 2013 by MrHanMan

[TheCardinal]

I've had the same problems previously but as everything seemed to work, i didn't give it much thought. However it now appears not all required mods are transferred. (That was a very expensive realisation as a very large spacestation i've been vanished due to a missing part.

I won't be using 1.2.4 anymore. If i can, i will go back to a previous version (or await 1.2.5)