By default MinecraftEdu installation will go to application data folder (though you can also customize the installation path), which can cause some problems on distribution. You can find some tips & tricks to troubleshoot the most common installation problems in this chapter.
Solving problems in distribution
Location where MinecraftEdu will be installed can be customized so user could install MinecraftEdu into folder which does not get cleared when computers starts. Another way to tackle the distribution problem is to use local profiles. So for instance, you can create account "minecraftedu" to every computer in where MinecraftEdu has been installed.
Distributing MinecraftEdu Manually
As you'll need to install MinecraftEdu into all of your student's computers, it is recommended that you first install MinecraftEdu into one computer, define all settings in that one computer how you would like to have them on other computers and then use a USB thumb drive or make a shared network drive from where you can copy the files to other computers into desired location. Final step is to launch MinecraftEdu Launcher once in other computers and press "File -> Create Shortcut to Desktop" to create shortcut of MinecraftEdu Launcher into desktop.
Deploying client files automatically using Active Directory
You can use this guide if you use Active Directory in your network. This guide explains how to 'push' updates to client machines from a server.
- Create a profile on one client machine by logging in with your 'special' username into Windows. (We use minecraft as our login name)
- Install MinecraftEdu on the client machine, with the appropriate settings.
- Copy the installed MinecraftEdu directories from the appropriate place on the client machine (windows is %appdata%/roaming/) to a location that the user 'minecraft' can access on the network, we use 'our primary domain controller'/netlogon.
- Copy the desktop shortcut to the same place as Step 3.
- Set up an Active Directory script to execute a minecraft.bat file when user minecraft logs on. (your network admin will need to do this)
- Create the minecraft.bat, in the appropriate place again for me this is in netlogon, with code in bottom of this title.
- Add a file, in this case 164.txt to the minecraftedu directory on the network.
- Now you should only have to install on one client machine, copy the updated directories to your network area, include a version#.txt, make sure you update to the new file in the minecraft.bat file and it will update each machine when students log in.
IF EXIST PATH\LOCAL\minecraftedu\164.txt exit If NOT EXIST PATH\LOCAL\.minecraft md PATH\LOCAL\.minecraft IF NOT EXIST PATH\LOCAL\minecraftedu md PATH\LOCAL\minecraftedu xcopy PATH\NETWORK\.minecraft PATH\LOCAL\.minecraft /s /y xcopy PATH\NETWORK\minecraftedu PATH\LOCAL\minecraftedu /s /y copy PATH\NETWORK\"minecraftedu launcher.lnk" PATH\LOCAL\desktop
Please note, it does take a little longer to log in once this is set up, but only on the first run through, after that the version checking prevents recopying an install that is already there.
Below explains what each line of the bat file does.
IF EXIST PATH\LOCAL\minecraftedu\164.txt exit- This is the version check, so if 982.txt exists on the local machine, the script stops and nothing is copied. This means that if you want to update your install you will need to update this file and the bat file each time.
If NOT EXIST PATH\LOCAL\.minecraft md PATH\LOCAL\.minecraft- This checks to see if the local .minecraft directory exists, if not it creates it.
IF NOT EXIST PATH\LOCAL\minecraftedu md PATH\LOCAL\minecraftedu- This checks to see if the local minecraftedu directory exists, if not it creates it.
xcopy PATH\NETWORK\.minecraft PATH\LOCAL\.minecraft /s /y- This copies the .minecraft folder from the network location to the local machine, the /s forces it to copy sub directories, and the /y suppresses confirmation requests.
xcopy PATH\NETWORK\minecraftedu PATH\LOCAL\minecraftedu /s /y- This copies the minecraftedu folder from the network location to the local machine, the /s forces it to copy sub directories, and the /y suppresses confirmation requests.
copy PATH\NETWORK\"minecraftedu launcher.lnk" PATH\LOCAL\desktop- This copies the link from the network location to the desktop of the local machine.
Another option is to tie the same script in Step 6 above to a set of computers as a windows startup script in Active Directory, instead of Step 5. This removes the ability for students to log in and play Minecraft on any school computer, but also allows you to easily keep the computers you want Minecraft on up to date with the latest version.