FAQ

Frequently Asked Questions

This page is a wiki; please feel free to contribute, and be bold with your edits!

Why do I need the CKAN? Can't I just go to the forums/Curse/KerbalStuff to download mods?

If you're a human, yes. However, the CKAN can also install, manage, and upgrade your mods automatically with just a few clicks. Installing a mod, or collection of mods, becomes as easy as ticking some boxes on the client and hitting "install".

Because CKAN knows which version of KSP you're running and the dependencies of the mods you are installing, it can help you in choosing only mods that are supported for your version, leading to safer, more stable installs.

Will you support Curse for indexing mods?

We would love to be able to detect and index new releases from Curse, but Curse does not provide an API that we can access to do so.

If you're from Curse, then please hop on our IRC channel, or open an issue, and say hi!

I want the newest version of mod X but CKAN only provide the previous one

CKAN employ bots to regularly check for updates of the indexed mods. Sometimes this doesn't work as well or fast as one might hope. Normally you will be able to see the update within hours of it hitting the repository the bots check for info (normally Github or Kerbalstuff). Some mods are maintained via other solutions and if that is the case it might be longer before CKAN indexes the new version. If you have seen a mod go without updates for a prolonged period of time even though a new version is available please tell us.

How do mods become available via the CKAN?

They need to be indexed using a simple metadata file. These metadata files are hosted on the CKAN-meta repository: anyone can contribute to it to make more mods available (when possible, it's courteous to inform a mod author that you're adding it).

For mods that are distributed through a site that gives us API access, this can be as simple as writing only a few lines. See adding a mod to the CKAN for more information.

What is the NetKAN?

The NetKAN refers to our army of bots: they tirelessly watch out for new releases and keep the index up to date, so that you will be notified of eventual updates the next time you update your client's list.

These bots download the mod, extract any embedded metadata they find, and combine it with the release information to produce new entries in the CKAN index.

What's the difference between a .ckan and a .netkan file?

Unless you're writing metadata, you don't have to care. If you are writing metadata, then the difference is:

• .netkan file - Something which contains a $kref field, and hence is not a valid CKAN document, but which can be transformed into one with the addition of external metadata.
• .ckan file - A fully rendered document describing a specific version of a mod, which no references to external metadata required.

The netkan.exe program can "inflate" a .netkan file into a .ckan one by looking up external metadata. The advantage of us having .netkan files is that we can inflate them automatically when new releases come out, meaning you need only write them once, and we'll index new versions forever.