Tutorials/Galacticraft Installation Guide
- 1 Installation
- 2 For Minecraft 1.5.2 or earlier:
- 3 Moving On
- 4 Troubleshooting
- 4.1 This is all very complicated, isn't there an installer?
- 4.2 I don't know where to find the files I downloaded!
- 4.3 I don't know where to find the .minecraft folder
- 4.4 Minecraft won't launch at all
- 4.5 Minecraft keeps crashing while the game launches
- 4.6 The game launches but then crashes when I start playing a saved world
- 4.7 MultiMC problems
- 5 Installing Forge
First a question: Do you already have Forge installed and working?
Yes: So you are able to play other mods in Minecraft? Great, in that case installing Galacticraft is very easy.
No: First follow the guide at #Installing_Forge, then come back up here!
Installation Guide for Galacticraft 2 and Galacticraft 3
On the [Downloads page], find the version you want to play.
Galacticraft 3 is for Minecraft 1.7.10.
Galacticraft 2 is for Minecraft 1.6.4. That's a little older, but a lot of the big modpacks (for example Tekkit or Feed The Beast) are still using it.
(Note: there is not yet any Galacticraft version for Minecraft 1.8, although it is planned for the future. For now, like most other mods, you will need to be using Minecraft 1.7.10 or earlier to play Galacticraft. Minecraft 1.7.10 is where the "community" has currently based itself.)
For the version you have chosen, you will need to download three files for Galacticraft:
On the Downloads page, the red ones at the top of the list are the latest version and recommended for most players. Don't be scared to download these latest versions, they have the latest fixes. If for any reason the latest does not work for you, you can then try an earlier version instead - but also, tell us about the issue at the Support area of the forum. (Do not try to use the Developer builds, those are only for programmers!)
Before moving on to Step 3, please check carefully that the downloads of all three files completed.
Move the three Galacticraft files you just downloaded into your
.minecraft/mods folder. (Don't have a /mods folder? See #Installing_Forge. Don't know how to find the .minecraft folder on a PC or on a Mac? See here) Make sure to delete any previous versions of the Galacticraft and MicdoodleCore files which were previously in your /mods folder.
Start Minecraft using the standard (vanilla) Minecraft launcher from Mojang and hit Play. It really should be that easy.
Extra Note for first timers: if this is literally the first time you have started playing with mods (or maybe you just tried out Minecraft 1.8 for a bit to see the rabbits and now you rolled back to 1.7.10 to play a modded game) then you will need to set the Minecraft launcher to launch the 1.7.10 version of "Forge". Choose the Forge profile (bottom left). Make sure it's for the correct Minecraft version which you want to play (bottom right):
If the Forge profile is not currently set for the Minecraft version you want to play, click Edit Profile, look in the center of the screen (Version Selection), there is a selection box called Use version: - change it to the version you want. Normally the Forge versions are found near the end of the versions list. [Official guide from Mojang on this.]
Minecraft 1.7.2 support
Galacticraft 3 is for Minecraft 1.7.10, but actually it is also compatible with Minecraft 1.7.2 if you must use that. We do recommend 1.7.10 (unless maybe you are using a really old laptop with weak Intel graphics, which maybe cannot support Minecraft 1.7.10 but still works on 1.7.2). Whichever version you prefer, the exact same Galacticraft download files work in Minecraft 1.7.2 and in Minecraft 1.7.10, isn't that smart?
Some players like to have mods from multiple Minecraft versions available on their computer - maybe a favorite list of mods from 1.6.4, as well as the current playing versions in 1.7.10.
Launching Minecraft will most likely crash if you mix mods for different Minecraft versions in the
But there's an answer for that: in the
/mods folder you can make subfolders:
1.6.4for your 1.6.4 mods
1.7.10for your 1.7.10 mods
Put the mods for different Minecraft versions in the correct subfolders, and you should be golden. They will not get mixed up, and Forge will automatically load the correct ones for the Minecraft version when you play.
If you have
1.7.10 subfolders, you might want to copy the latest Galacticraft 3 files into both of them! (Remember, Galacticraft 3 works equally well in 1.7.2 or 1.7.10.)
If you're tinkering about with different versions like this, please be careful when loading your saved game worlds - if you made a world in 1.6.4 and you load that world when playing 1.7.10, then the world will be converted to 1.7.10 format and you will not be able to go back to using it in 1.6.4.
For Minecraft 1.5.2 or earlier:
- Install Forge (Drag the Forge class files into your
- Drop the Galacticraft jar file into your
- If you decided on Basic Components, click the "Load Basic Components" button when it appears after launching Minecraft.
- You're done!
Once you have the mod installed (and now would be a good time to install any other mods you want) and your Minecraft loads up OK, you may start your adventure to space!
Read on with the Galacticraft Getting Started Guide to get you started with all the basics.
If you are playing with other mods, or building your own modpack, you might also want to read Compatibility.
This is all very complicated, isn't there an installer?
Actually, we hope it's not too complicated if you followed the steps! There is no official installer for Galacticraft. Some people do make unofficial installers. We strongly recommend you do not use them. First, they will likely install an out-of-date version of the mod, as the installer guys do not update as often as we update the mod. Secondly, who knows what other adware, spyware or viruses they might be installing on your computer as well. Thirdly, some unofficial installers may be breaching Galacticraft's licensing - Galacticraft is freely available, open source software so if anyone is trying to charge you for it then they are a knave and a charlatan, and we'd like to hear about it.
I don't know where to find the files I downloaded!
Often your web browser has a Downloads menu which will open up a list of recent downloads and you can check there whether the downloads are completed yet. In Firefox it's under the Tools menu. (If you found them, you can also right-click the downloads and choose 'Open Containing Folder' to see the folder where the download files are at.) If you still can't find them, maybe ask a friend or family member to help you?
I don't know where to find the .minecraft folder
This can be tricky to find!
On a Windows PC there's a trick: in the Windows Start menu, click Run, then enter
%APPDATA% in the box. That will open up the Application Data folder. The Application Data folder has the
.minecraft folder in it, normally it's the first folder shown. There are videos on YouTube which can help with this. Once you've found it, you might want to create a shortcut to this folder and place the shortcut on your desktop for next time.
On a Mac the folder is named
minecraft (no dot at the start) and you can find it at
~/Library/Application Support/minecraft. That
~ symbol means the current user folder. You might be able to find the right folder by searching under Macintosh HD/Users using Finder - see next paragraph - but the easiest way to get to the minecraft folder quickly - and without a lot of searching around in Finder - is simply to open up Terminal, and type the following exactly:
open ~/Library/Application\ Support/minecraft, then press the Return key. This should open up the minecraft folder in Finder immediately. Pro Tip: You can start Terminal by typing 'Terminal' into Spotlight (use Cmnd+Space to bring up Spotlight) and double-clicking Terminal in the search results. Congratulations, if you're using Terminal to do stuff you are a Mac power user!
A problem you will likely encounter if you do not use Terminal and instead just try searching for the minecraft folder in Finder, is that on most Macs the
Library folder is a hidden folder by default. That makes it difficult to find the minecraft folder using Finder, but you can still get to the minecraft folder very easily using Terminal as explained above. If you want to use Finder to find it, you may first need to set your Mac to show hidden files and folders in Finder, which is quite complicated!
Minecraft won't launch at all
You need to figure out whether Minecraft is starting to launch (shows the white Mojang loading screen) and crashing - see next step - or whether it is not even getting that far. If it's not even getting that far:
- Make sure you know how to launch regular (unmodded) Minecraft using the Minecraft launcher.
- In the launcher, switch to the Forge profile, see screenshot above, and in the bottom right of the screen (orange circle in that screenshot) make sure it's showing a Forge version - the example in the screenshot is Forge version 10.12.2.1147 which is the correct one for playing modded Minecraft 1.7.2. Click the Edit Profile button if that's not showing up correctly, and change the Use version: setting to the one you need, and hit Save Profile.
- Click Play. It should be that simple!
Minecraft keeps crashing while the game launches
- First thing to check is whether it's Minecraft + Forge which are crashing, or a mod which is crashing. So, empty out your
/modsfolder totally. Click Play. It should launch Minecraft with only Forge installed, no mods. The game main menu will say, bottom left, "3 mods loaded". (That's Forge, FML and MCP - the framework for modded Minecraft but no actual mods!) Create a New World. Check it plays OK.
- If there's a crash with no mods then you need to fix your Minecraft + Forge. Most likely it doesn't have enough memory (try the default memory settings, in the launcher click Edit Profile and untick the JVM arguments box). Or maybe it's not installed correctly (a bad download?). Or if the crash says Exception in native code then most likely it doesn't like your video driver, try updating the video driver and also it's important to make sure the video settings on your PC have all the OpenGL settings fully enabled.
- If you can launch OK with no mods, then start adding mods back into the
/modsfolder, maybe start with Galacticraft's three files (GalacticraftCore, Galacticraft-Planets, MicdoodleCore) and check that you can play OK with those installed.
- Galacticraft actually checks for a few common installation problems when it starts - if you see a text box reporting a problem, do what it recommends and do not just hit the Ignore button!
The game launches but then crashes when I start playing a saved world
- Try updating to the latest version of Galacticraft.
- If that doesn't fix it, read the first few lines of the crash report, starting from the top - often (not always) it names right there the mod which is causing the problem.
- If it's a Galacticraft problem, you can ask for support on the forum. You will be asked to post a copy of your crash report (find it in folder
.minecraft/crash-reports) and maybe other information as well.
- Be patient, most problems are fixable and people on the forum will help you, but it can take a day or two to find the answer.
- Are you using MultiMC as a launcher? Don't. MultiMC is not recommended for Galacticraft.
- Some people have made it work OK but if you have even a small error in your MultiMC setup then you can have problems launching modded Minecraft.
- After Mojang's Minecraft 1.8.4 security update, some players are reporting crashes when starting the game with Optifine + MultiMC:
This is an Optifine issue and is fixable by updating Optifine to 1.7.10-B6. It is not a Galacticraft issue.
- The other main thing to watch is that you have all the vanilla and library files (that's Minecraft, LWJGL, Forge, and maybe LiteLoader and more) in the Version tab and all the mod files from the /mods folder, including Galacticraft, in the Loader tab. If you mix them up, it won't work.
- If you have problems with MultiMC, please don't expect support from the Galacticraft team, either figure it out yourself or use the vanilla launcher like everyone else.
First up, Galacticraft only works for the Windows PC, Mac, or Linux versions of Minecraft (or any other computer which can run Java). You can't play Galacticraft in console (XBox360, Playstation, etc) or mobile (Minecraft Pocket Edition) versions of Minecraft. That's out of our hands, if you want it then go bug Mojang or Microsoft to make mods available in the console versions...
To play any mod in Minecraft, you need three things:
- the mod
All three of these need to be a version matching the Minecraft you want to play.
Actually, it's better to think about this as matching the version of the Minecraft to the mod you want to play. So if you want to play Galacticraft 3 (that's our latest version with all the new features including Asteroids) then it will have to be either Minecraft 1.7.2 or Minecraft 1.7.10. And frankly, Minecraft 1.7.2 is fairly buggy (it has some nasty visual bugs where you see 'cracks' or lines of light between blocks). So Minecraft 1.7.10 is the one you should be going for.
Download Minecraft 1.7.10 from an official source if you don't have it already. (The Minecraft launcher, under Edit Profile, Use Version, should have a list of all the Minecraft versions available on your installation.) If you don't have it, recently Mojang's main Minecraft download page is only linking to the latest Minecraft 1.8 versions, but Mojang also makes all the older Minecraft versions available on its official (Amazon-backed) download server. [Download link for the official 1.7.10 version] For other versions, many Minecraft community sites will give you the links. Check every download link carefully: as long as it's coming from amazonaws.com that should be from the official source.
Now install Forge for Minecraft 1.7.10. (If you are already playing modded Minecraft, most likely you already did that, so why are you reading this?) It's pretty easy because Forge has an installer you can download - there's even a Windows installer, named 'Installer-win' - Forge Download page. Forge has many versions, you should choose the Minecraft version you want, then use the Latest build of Forge under that (note, in Minecraft 1.7.2, Galacticraft definitely requires the latest version (that's 10.12.2.1147) not the recommended version of Forge; in Minecraft 1.7.10, Galacticraft should run fine on any of the recent Forge versions). If you plan to play on a server with other people, it would be an idea to ask the server owner which exact Forge version the server uses, and use the same.
Download the Forge installer, find the installer file you just downloaded, and run it. When you run the Forge installer, it should present you with a short menu with three choices: select 'Install client' and then hit install. Problems? See Forge official guide.
Installing Forge on a Mac: download the 'Installer' version of Forge, not the 'Installer - Win' version! This downloads a .jar file. The .jar file is runnable on your Mac just by double-clicking on it, but on most modern Macs your security settings (Gatekeeper) will cause it to throw this error message when you try that: App can't be opened because it is from an unidentified developer. Have no fear, there is a simple solution. Just Ctrl-click on the .jar file and choose 'Open'. It will give you the same 'App can't be opened ...' error message, but this time there is an extra button you can click, called 'Open'. Click the 'Open' button and the Forge installer should run normally: choose 'Install client' and it should automatically install Forge on your Mac.