The MinecraftEdu client is the software that runs on the local computer. It is the essential part your set up that will allow you to sign in, change your texture pack, load a custom skin, and set custom settings. Most importantly however, it is used to play the game; from the client the user can choose to connect to a server or to play by themself in the singleplayer option.
Regular Minecraft clients cannot connect to a MinecraftEdu modified server. The opposite is true as well: MinecraftEdu clients cannot connect to regular Minecraft servers.
- 1 Client Settings
- 1.1 Custom Texture Packs
- 1.2 Client Settings File
- 1.3 Automatic Parameters
- 1.4 Hidden Parameters
- 1.5 Launcher Settings File
- 2 System requirements
If you're looking to customize your client, look no further:
Custom Texture Packs
MinecraftEdu does not yet support clientside custom texture packs. This is due to the way that MinecraftEdu's custom blocks are rendered. There is though currently way to set custom texture packs for the maps you create in the server and the tutorial for that can be seen here.
Texture packs decide how blocks with the game are rendered or shown to a user. A server will decide where a block is and notify each client but it is the client's duty to decide how to display it. This is where the texture pack comes into play; Minecraft has built-in support for rendering block textures from special files added by users, meaning that users can create their own (or use someone else's) texture packs to personalize their gameplay experience.
Client Settings File
Location: <Minecraft folder>\MinecraftEduSettings.ini For most machines:
- Open the MinecraftEdu launcher
- Under the open menu choose "open Minecraft folder"
To manually locate the Minecraft folder on a Windows machine:
- Press the Windows button and "R" together to bring up the run window.
- Type "%appdata%\minecraftedu\minecraft" into the text field and press enter.
To locate the Minecraft folder on a Mac machine:
- Open your home directory.
- Open the library directory.
- Open the application support directory.
- Open the minecraft directory.
To locate the Minecraft folder on a Linux machine:
This will be located under /home/username/minecraftedu/minecraft or ~/minecraftedu/minecraft (The tilde is used to represent the users home directory).
A basic MinecraftEduSettings.ini file will look like this:
#Tue Apr 03 22:41:59 MDT 2012 version=0.98 visualfill=false advancedbuildmode=false showachievements=false consolechat=false showstats=false lang=en
Most of these options can be edited from the client and you do not need to edit manually within the file.
The first line is a date that is used to determine the first creation of the settings file.
The second line, "version," is used to denote what version of the mod you are currently using. This is set by the mod and is not meant to be changed.
Visual Fill Tool
The third line is a parameter that determines whether or not to use the visual build tool, it should be used as follows:
The visual fill tool is an option used to better take advantage of the build tools integrated into MinecraftEdu. It shows what area will be filled in (or cleared out) by the fill/clear tool. Editing this option from within the client is located by opening the options menu, then the MinecraftEdu settings menu, and then toggling the option on or off.
Advanced Build Mode
The fourth line determines whether or not a third "advanced" build mode will be available to you when signed in as a teacher. Edit accorindingly:
The advanced build mode combines the other two build modes by allowing free movement and noclip but rather than long distance building the user can place and break blocks according to a floating indicator as in the other building mode. Editing this option from within the client is located by opening the options menu, then the MinecraftEdu settings menu, and then toggling the option on or off.
The show achievements option is one of the few options that can only be edited manually. The vanilla (or unmodified) version of Minecraft has an achievement system included desgined to stimulate learning the game (such as gathering basic resources) early on and providing goals and fun things to do later in the game (such as ride a big from a cliff or create a rail longer than a kilometer). By default this is disabled to limit distraction from a teachers education purposes. To edit this, change the file as follows:
Changing the option to "true" will allow the games pop-up system to notify the user when they have completed an achievement as well as letting them view (from the pause screen) the map of achievements, future goals, and their prerequisites.
The console is generally a feature for advanced users. It's essentially an advanced chat area that has a scrolling feature to show previous messages. It also shows commands as they were typed and their results whereas in the regular chat area only a resulting message would be shown. It should be changed as follows:
Setting the option to true will change the function of the chat button to opening the console instead of the regular text entry and chat boxes. Editing this option from within the client is located by opening the options menu, then the MinecraftEdu settings menu, and then toggling the option on or off.
The show stats option is one of the few options that can only be edited manually. The stats area of Minecraft records almost all of the numbers you could possibly want, from steps taken, to number of a certain block broken, placed, and crafted. By default this is disabled to remove distraction from the learning experience, however enabling this function can provide a user with interesting statistics about their playtime. Edit this parameter as follows:
Enabling this feature will allow the Stats button to reappear in the pause menu for a player to use.
The eighth line is used to determine the language of the client:
English uses "en" as its language code. The only other current valid code is "fi" for Finish. It is possible to use any other language provided by Mojang with Minecraft, but anything implemented by the MinecraftEdu mod is only supported in English and Finish.
A hidden parameter is a line that isn't rendered in the settings file automatically. To take advantage of such a setting, the user must add the line to the file manually. This means that in an automatically generated MinecraftEduSettings.ini file this line will not be present and therefore set to a default state that will not affect your gameplay; if you prefer a setting in its default state, it is much easier to leave it missing from the file.
Use Custom Skin
Add this line to your settings file if you wish to render a custom skin from the internet as opposed to the supplied MinecraftEdu skins that can be chosen during login (added in version 0.975). For this option to work your client must be able to authenticate with Mojang's Minecraft authentication servers over the internet therefore requiring an active internet connection. If your server is run on a local area network this setting will have no effect.
use-custom-skin=<true/false> default state: false Example: use-custom-skin=false
To learn how to set up your own custom skin, see the above subject, Custom Skin.
Disable Singleplayer Button
Singleplayer button can be disabled in client by setting the parameter.
disable-sp=true to minecraftedusettings.ini file.
Disable Change Name/Gender Button
Allowing a student to change their set name and/or gender can be disabled in client by setting the parameter. This is useful if a teacher has previously set the alias name and/or gender for a student in the launchersettings.ini file prior to distributing files to students for server connection from home.
disable-startmenu=true to minecraftedusettings.ini file.
Launcher Settings File
This file determines client settings upon launching the program. Pre-editing this file can be very useful if including it in files distributed to students to take home and to remotely connect to a MinecraftEdu server.
A basic launchersettings.ini file will look like this:
language=en automatic-update-check=false client-ram=700 client-launch-parameters=%JAVAEXEC% -Xmx%CLIENTRAM%M -Xms%CLIENTRAM%M -cp %JARMINECRAFT% %LAUNCHERSTARTCLASS% %NOUPDATE% servertool-launch-parameters=%JAVAEXEC% -jar %JARSERVERTOOL% writedebuglogtofile=false alias= gender= hide-advanced-settings=false hide-launch-settings=false autoconnect-address= proxy-address= proxy-port= autologin=false OnlineMode=false rememberpassword=false
Some of these options can be edited from the client, but manual editing is useful for "locking in" a student to certain settings so that they cannot change it from home (if they don't discover this file). Many of these settings should be left alone, but some are described below.
Automatic Update Check
This line should not be changed. It prevents MinecraftEdu from trying to update itself to the most recent regular Minecraft version, as doing so would break the program.
Client RAM and Launch Parameters
These settings determine client memory usage and advanced Java commands passed on to the client's Java software. They can be edited within the Launcher settings options, if they are not disabled by the hide-launch-settings parameter in this file. They are for advanced users only.
Sets the client's name. This is useful if a teacher wants to "lock in" a student's name so that he/she cannot try to log in as another student for griefing/stealing purposes from home. For a student that the teacher wants to be named JohnSmith3, the line should read:
Please note that names cannot exceed 15 characters or they will be cut off. Also, enable the hide-launch-settings parameter so students cannot change their names back in the Launcher. It is also recommended to add disable-startmenu=true to the MinecraftEduSettings.ini file so they cannot change names in the Main Menu of the game itself.
Locks-in the client's gender. Skips the choosing screen, so it can save time for a teacher to set this (even for himself/herself), as well as useful for student identity purposes. This can be set to male or female. For example:
Hide Advanced Settings
Removes the "Advanced" button from the top of the launcher. Useful for student home installations, so that students cannot alter important settings in their home clients. Set to true to hide the button.
Hide Launch Settings
Removes the "Launch Settings" button from the top of the launcher. Useful for student home installations, so that students cannot alter their names and genders after a teacher has set them through this file. Set to true to hide the button.
If this is enabled and set to a server address, the game will automatically try to connect to that remote server upon launch. This is useful for forcing students to connect to a school server remotely from home, and for not allowing off-task play at home. A server address of 12.345.67.890 would look like this:
You can view the client system requirements here: System requirements