Having problems with KerbalEdu?
Do you have questions about the purchasing process or licensing? Check out the FAQ below or use the contact form to get in touch
Starting from version 1.3.1e859 we have integrated KerbalEdu with the TeacherGaming platform. This means you now have more lesson plans availabe for use with KerbalEdu, and you can get analytics about how your students learn when they play the game. You can create your classes and students on TeacherGaming Desk, that is how you get those ids. Please see this blog post for step by step instructions on how to upgrade your existing KerbalEdu licenses to a TeacherGaming platform account.
We are interested in all kinds of projects and initiatives. Please contact us!
Check our forum area for starters - KerbalEdu Forum.
You may also check our old google group - Kerbal Teachers.
And remember to check out KerbalEdu in social media - @KerbalEdu in Twitter.
Yes, from version 1.3.1e859 onwards they can play it from anywhere. They just need to know their TeacherGaming Class ID and Student ID so that they can login. However, please note that only as many students as you have licenses for can play at the same time. This means that if you have more students than you have licenses for some of them may not get to play if the full amount of students are already playing.
Our game works on Windows (PC), OS X (Mac), and Linux.
At this time we are not considering a tablet version.
Minimum requirements:
You have an old version of KerbalEdu (older than 1.3.1e859)! Please get the new version. This blog post has instructions on how to get it.
If you for whatever reason want to keep using the old version, you can try these instructions.
There are three possible reasons why this happens.
You have an old version of KerbalEdu (older than 1.3.1e859)! Please get the new version. This blog post has instructions on how to get it.
If you for whatever reason want to keep using the old version, you can try these instructions.
KerbalEdu is unable to contact the license server. Check that your firewall allows it to connect to server.kerbalspaceprogram.com port 443 (https).
There is also possibility that the mac address of your primary network interface has somehow changed. For example VPN or virtualisation software may cause this. Find a way to change it back, or contact us to reset your license.
You have an old version of KerbalEdu (older than 1.3.1e859)! Please get the new version. This blog post has instructions on how to get it.
If you for whatever reason want to keep using the old version, you can try these instructions.
KerbalEdu is unable to contact the license server. Check that your firewall allows it to connect to server.kerbalspaceprogram.com port 443 (https)
You are trying to run the game with a user that doesn't have write access to the installation folder. KerbalEdu needs write access to its installation folder in order to work properly.
New versions of KerbalEdu (1.3.1e859 or newer), integrated with TeacherGaming Desk
Recommended installation procedure
1.) Download TeacherGaming App from app.teachergaming.com to any computer with the same OS as the other computers you want to install on.
2.) Install KerbalEdu from the TeacherGaming App
3.) Copy the whole TeacherGaming App installation folder to the other computers.
You can use the administration software of your choice to automate step 3.
KerbalEdu needs full write access to its installation folder.
If your user accounts are restricted from writing there and KerbalEdu is run by those users with those restricted rights, it will not function properly. First symptom of this is usually the game logo in the main menu reading only Kerbal and not KerbalEdu, and KerbalEdu version number not appearing in the lower right corner of the screen.
Cloud saves
From version 1.3.1e859 onwards KerbalEdu saves are by default uploaded to TeacherGaming Desk as cloud saves on a per student basis. This means that every student has his/her own saves by default. This means you shouldn't need to do anything for students to have their own save games in a network installation
Save games and user home folders.
If you really want to KerbalEdu still has the functionality to redirect save games. You can do this by inserting the line
externalSavesDirectory = *path to user KerbalEdu saves directory*
for example
externalSavesDirectory = H:\KerbalEduSaves
in the edusettings.cfg file in the installation directory.
Note that you can only do this if you disable the cloud saves first. To disable cloud saves set tgCloudSavesDisabled = False also in the edusettings.cfg file in the installation directory.
Older versions of KerbalEdu (older than 1.3.1e859)
The license system.
When KerbalEdu is run the first time on a computer it asks for the license key. This key is saved in *installation_directory*/KSP_Data/sharedclasses.uclass on Windows and Linux, and in KSP.app/Contents/sharedclasses.uclass on OS X. After that, and on every subsequent launch of the game, this key and the mac address of the computer are sent to the license server (server.kerbalspaceprogram.com port 443) to check if the computer is allowed to run KerbalEdu. The server keeps a list of mac addresses associated with the key. To check if a computer is allowed to run KerbalEdu the server simply checks if it has the mac address on the list associated with the key and if it is not either does not allow the game to run or if there are still unused licenses on the key adds it to the list. Running the Remove License tool removes the mac address of the computer it is run on from the list, leaving one license unused.
So to do a network install you can simply install on one computer, create the aforementioned sharedclasses.uclass file with the license key (and 2 trailing newlines), and then copy the installation directory over to all the other computers. Or run the installer on all of them and then copy the sharedclasses.uclass only. To do an uninstall just run RemoveLicense.exe (or other OS equivalent) in the installation directory on each of the machines and then remove KerbalEdu. Our Windows uninstaller should run RemoveLicense automatically. Also remember to configure your firewalls so that server.kerbalspaceprogram.com port 443 (https) can be accessed by KerbalEdu for the license check.
NOTE! It is important that the sharedclasses.uclass file for a distributed install contains only the license key and 2 trailing newlines. If you input the key by running the game once, you need to remove everything in the file after the license key and replace those with the newlines.
2.) KerbalEdu needs full write access to its installation folder.
If your user accounts are restricted from writing there and KerbalEdu is run by those users with those restricted rights, it will not function properly. First symptom of this is usually the game logo in the main menu reading only Kerbal and not KerbalEdu, and KerbalEdu version number not appearing in the lower right corner of the screen.
3.) Save games and user home folders.
KerbalEdu has functionality to redirect save games. You can do this by inserting the line
externalSavesDirectory = *path to user KerbalEdu saves directory*
for example
externalSavesDirectory = H:\KerbalEduSaves
in the edusettings.cfg file in the installation directory.
Please note that this directory needs to be empty at first. Redirection works by copying the saves from the redirection directory to the saves folder in the installation directory when starting the game and copying them back to the redirection folder when quitting. So if you for example would set externalSavesDirectory = H:\ it would try to copy the entire contents of H:\ to the saves directory in the installation when starting the game.
If you are using Windows or OS X, update using the TeacherGaming App.
If you are using Linux, go to store.teachergaming.com, log in and go to Profile->Downloads.
If you don't yet have a TeacherGaming account, see this blog post for instructions on how to transfer your existing KerbalEdu licenses to a TeacherGaming Account.
New versions of KerbalEdu (1.3.1e859 and newer)
You should start the game so that it loads the main menu once before trying to launch missions from the web browser (EHC or Mission Library). The game registers itself as a url handler for the kerbaledu:// url scheme when it is run for the first time.
Older versions of KerbalEDU
In Windows the installer should have done this for you, but seems for some reason it didn’t. Open command line to the installation directory. Run the following command (remember the KSP.exe parameter, it is needed):
registerurlhandler.cmd KSP.exe
On Linux you always have to do this manually. On Linux run the following command in the installation directory:
./registerurlhandler.sh
On OS X the installer should also have done this. We don’t know how to fix it if it didn’t. If you figure it out, please tell us.
Licenses work on a per computer basis. For each license purchased, one computer can run the software. This means that any number of students can play the game, but only on as many computers as you have licenses.
The licenses do not expire or require any future fees after the purchase.
The licenses are not transferrable. The institution that buys the licenses will own them. If you have a good reason why you'd like to transfer the ownership, we promise to consider it.
Newer versions of KerbalEdu (1.3.1e859 and above) don't require an activation, they instead require a login every time you run the game. So you can reinstall as many times as you want and on as many computers as you want. Only limitation is that only as many students (class id & student id pairs) can run the game simultaneously as you have licenses for.
For older versions, if you are moving to another computer or are going to significantly change your hardware setup, you should first run the RemoveLicense tool found in the installation directory.
We have a 30 day reclamation period from the date the order was sent and during it you may cancel your order at anytime or ask for a refund. All accounts will be instantly closed after the refund. In case of any suspicious activity or a possible fraud, TeacherGaming LLC holds the right to suspend any licenses or payments.
