Difference between revisions of "Compatibility"

From Galacticraft Wiki
Jump to: navigation, search
 
(94 intermediate revisions by 3 users not shown)
Line 1: Line 1:
This information is for [[Galacticraft 3]].  '''First off, you really should update to the latest version - it will have the latest compatibility fixes.'''  Some people do not seem to understand what ''latest version'' means.  It means the one in <font color=red>'''red'''</font> at the top of the [http://micdoodle8.com/mods/galacticraft/downloads Downloads] page.
+
==Galacticraft 4: Compatibility notes==
  
For Galacticraft 2 compatibility information, see [http://forum.micdoodle8.com/index.php?threads/known-incompatibilities-and-cross-mod-issues-1-6-4.4313/ forum thread]
+
Galacticraft 4 is currently compatible with most other mods.  For extra notes about Sponge compatibility on servers, see [[Sponge]].
 +
 
 +
If you come across compatibility issues, please (1) check the latest Galacticraft version as we make compatibility improvements all the time; (2) if there's still a problem in the latest, let us know on Github. Also try installing '''PlayerAPI''' mod, that can fix some compatibility issues. (The compatibility notes for Galacticraft 3, below, may also be relevant.)
  
==Galacticraft 3==
 
Galacticraft 3 is a dual version for both Minecraft 1.7.2 and Minecraft 1.7.10.
 
  
For Minecraft 1.7.2 use Forge version 1147 (Latest), for Minecraft 1.7.10 use Forge version 1204 or later - either Latest or Recommended versions will be fine. (If playing on a server make sure all player's Forge versions match the server!)
+
====Player inventory tabs====
  
This topic will cover any known incompatibilities and what you can do about them. This topic will be updated when new issues come to light.
+
'''Custom NPCs'''  In Minecraft 1.10.2 and 1.11.2, please make sure to use the latest (25 May 2017 or later) version of this mod with Galacticraft, older versions had inventory tab overlapping issues.
  
As a general rule, you should be using the latest version of Galacticraft. Some people don't seem to understand what '''latest version''' means. It means the one in red at the top of the list on the [http://micdoodle8.com/mods/galacticraft/downloads downloads] page. The latest version will often include compatibility fixes with other mods which have come to light after 'stable' versions of Galacticraft have been released - so the latest version is '''more''' stable than the 'stable' version.
+
'''More Player Models'''   In Minecraft 1.10.2 and 1.11.2, please make sure to use the latest (25 May 2017 or later) version of this mod with Galacticraft, older versions had inventory tab overlapping issues.
  
If using Galacticraft with other mods or in modpacks, it is also strongly recommended to read [[Config#World_Generation]].
+
'''TechGuns''' uses its own inventory tabs which overlap with ours - if this is affecting you, please ask the TechGuns developer to update and use our API for compatibility.
  
==Issues and bugs in other mods (and how to fix them!)==
 
  
All of the issues described in this section are caused by other mods.  The latest versions of Galacticraft include workarounds so that problems will not arise, or there are steps you can take to fix these issues yourself, see below.
 
  
===Buildcraft API===
+
====Fixed compatibility issues====
Buildcraft somewhat unhelpfully changed the way it interfaces with other mods, after its original Minecraft 1.7.10 version was released.  An "API" is a small slice of the mod which other mods can use for compatibility.  Some other mods include the Buildcraft API in their .jar files (examples: '''Engineers Toolbox''', '''Enhanced Portals''', '''Forestry''') - this is called "distributing" the API, it's not best practice but some mods do it anyway.  Depending on version, some of those other mods distribute older versions of the Buildcraft API, some distribute newer versions.
 
  
Galacticraft does '''not''' distribute the Buildcraft API.  Our mod is one of the smarter mods which does not distribute any API.  Galacticraft will adapt itself to ''use'' whichever version of the Buildcraft API it finds (so our mod is compatible with old ''and'' new Buildcraft).
+
'''Avaritia''' Infinity Armor and other mods with custom hi-poly armor - please update to Galacticraft 4 build 152 or later, to have the armor drawn correctly on planets
  
If you have a modpack with 2 other mods which contain 2 different versions of the Buildcraft API then you may see a crash like this whenever placing down ''any'' Galacticraft machine:
+
'''Finder Compass'''  To prevent client disconnects, please update your Galacticraft 4 to build 4.0.1.143 or newer.
<pre>java.lang.NoSuchMethodError: buildcraft.api.core.JavaTools.getAllFields(Ljava/lang/Class;)Ljava/util/List;
 
at buildcraft.api.mj.MjAPI.getMjBatteryField(MjAPI.java:196)</pre>
 
  
It's not a Galacticraft bug. You are seeing it with a Galacticraft machine only because of the 2 other mods installing 2 incompatible partial copies of the Buildcraft API, which are interacting badly with each other. If it was not Galacticraft crashing here then most likely something else in your game would crash later when interacting with Buildcraft. If there's any fingers to point, it's partly the Buildcraft guys for updating the API mid-versions without preserving 100% backwards compatibility - that will always produce problems like this - and partly the modpack for not taking care not to mix mods with 2 different versions of the Buildcraft API.
+
'''JourneyMap''' If you are using JourneyMap waypoint teleports to travel between different planets, please update your Galacticraft 4 to build 4.0.1.143 or newer.
  
There are two ways for players (or server owners or modpack makers) to fix this:<br>
+
'''Forge - mods missing screen'''  If you get a crash with this type of error when you start the game: <code>java.lang.NoClassDefFoundError: cah</code> (Minecraft 1.10.2 might show <code>bxl</code> instead of <code>cah</code> there) it might be Forge trying to give you that brown screen naming the required mods "missing", but crashing instead of showing the screen. To solve this issue, try updating Galacticraft and MicdoodleCore to the latest version.
1. update all mods in your pack to the latest (that should work if the mod with the old Buildcraft API is updated now)<br>
 
2. search through all the .jar files in your modpack for the ones with a <code>buildcraft</code> folder - there must be at minimum two mods with this - and figure out which one is an old one which needs updating, or maybe delete the buildcraft folder from the .jar and resave the .jar (at your own risk, but it usually works out OK), or else you might have to uninstall it if there is no update.
 
  
Alternatively, if that does not fix it then you can disable Buildcraft energy (MJ) compatibility in Galacticraft, which will prevent the crash from being triggered from Galacticraft machines but not actually fix the underlying problem so you might still see problems with other mods.<br>
 
1.  Galacticraft version 3.0.8.260 and later will auto-disable Buildcraft compatibility in this situation, with a warning message in the log linking to here<br>
 
2.  in earlier versions of Galacticraft (since 3.0.7.251), you can manually disable Buildcraft compatibility with a setting in <code>power-gc3.conf</code>
 
  
====Any other Buildcraft issues====
 
For more Buildcraft compatibility notes see [[Buildcraft]].
 
  
Installing the Buildcraft mod '''after you already created a world with Galacticraft installed''' is not advisable in Galacticraft version 3.0.8.264 or earlier.  (It's never a good idea to change mods which affect world generation, after you created the world already.)  If you do add Buildcraft to an existing world, in those older versions of Galacticraft, you will '''lose all the Galacticraft oil in the world''' (Forge will warn you and ask you if you want to continue).  The reason this happens is that Buildcraft also generates Buildcraft oil in the world, and you cannot have 2 different fluid blocks both named "oil".  Obviously, if you add the Buildcraft mod after you already created a world then oil in existing chunks will be deleted and Buildcraft oil will only be generated in any ''newly generated'' chunks, so you may have to walk quite far to find some oil...
+
====Known compatibility issues====
  
Newer versions of Galacticraft attempt to handle that in a smarter way.  If you install Buildcraft in an existing world, the Galacticraft oil blocks (and any which you have in tanks) will be renamed to "oilgc".  You can still use that oil with the [[Portable Oil Extractor]] and in a Galacticraft [[Refinery]] (from version 3.0.9.292).  Buildcraft oil will also work just as well.  Galacticraft [[Oil Canister]] will work normally.  Older chunks will keep their Galacticraft oil reservoirs, newly generated chunks will have Buildcraft oil.
+
All '''Shaders''' mods - please switch off shaders when you leave the Overworld and travel to other planets - shaders mods cannot understand the dark or differently colored sky on the Moon and other planets.
  
To be clear about this: there is no problem at all if you install Buildcraft and Galacticraft together ''before'' you create a world (that's the recommended approach) - in that situation, Buildcraft oil will generate in the world, Galacticraft underground oil reservoirs will not generate, and Buildcraft oil can be used as [[oil]] in Galacticraft. Phew!
+
'''Advanced Rocketry''' is a space-themed mod which has made some overlapping content with Galacticraft.  If Advanced Rocketry and Galacticraft are installed ''together'', Advanced Rocketry may take over some of the space dimensions, for example you may have some features of Advanced Rocketry's oxygen system or gravity on the Moon instead of Galacticraft's features on the Moon.  For example, players have complained they can't breath on the Moon when they are wearing [[Oxygen Mask]], [[Oxygen Gear]] and full Oxygen Tanks - if you're wearing those then it's Advanced Rocketry which is stopping you breathing, not us.  We are hoping the Advanced Rocketry guys will provide a config or other solution to avoid this conflict (like they did in the 1.7.10 version of their mod)
  
===Crashes on the Moon and how to fix (CoFHCore 'Flat Bedrock' feature)===
+
'''WAILA''':  some versions of WAILA have a bug where the color of grass, leaves, sand and some other blocks changes to grey when the player is mounted in a vehicle, including a Galacticraft rocketIf using '''WAWLA''' with WAILA, please make sure to use the '''latest''' Galacticraft version.
The CofHCore 'Flat Bedrock' feature (which can be enabled in CofH configs) has a bug and it will sometimes cause crashes during Galacticraft's world generation on the Moon. The solution is in the CoFHWorld.cfg file set the number of layers of bedrock to 1, that should be ok(In recent versions of CoFHCore the config file is <code>CoFH/Core/Common.cfg</code>.)
 
  
''Note: if playing on a server, this is a server-only fix.''
+
'''Cubic Chunks''' mod causes multiple weird issues with Galacticraft if you build outside the 0-255 height range - for example it can interfere with rocket launch and landing.
  
===RF API===
+
'''ViveCraft''' is compatible with Galacticraft, but it needs you to set a config setting: "Disable Vehicle Third-Person and Zoom"=true
Similar to the Buildcraft problem, the RF API was also updated after its original Minecraft 1.7.10 release was already being used by several other mods, with the similar consequences: some of the other mods using RF API use the older version, and some use the newer.  Some of the mods expecting the newer version will crash if only the older version is present.
 
  
For example, Mekanism (versions 7.1.1 or 7.1.2) will crash like this if used alongside non-latest versions of RF mods:
+
Minor issues reported with '''PlayerRevive''' and '''Valkyrie Warfare''' mods.
<pre>java.lang.NoClassDefFoundError: cofh/api/energy/IEnergyProvider
 
at mekanism.common.util.CableUtils.isOutputter(CableUtils.java:156)</pre>
 
The crash can be triggered by connecting a Mekanism Universal Cable to a machine from another mod - including Galacticraft machines, prior to Galacticraft version 3.0.8.258.
 
  
The solution is to update the RF mod (for example MinefactoryReloaded) to the latest version.
+
'''Custom NPCS''' has been known to cause issues when loading a modpack with Galactacraft 4
  
===DragonAPI===
+
==Galacticraft 3: Compatibility with other mods==
If you're reading this section of this page, it's probably because you are still using DragonAPI 1.7.10 version 2 which is not the latest version.  '''The issue here has been fixed in DragonAPI 1.7.10 version 3 and later, and players should update to that.'''
+
All information below is for [[Galacticraft 3]], all recent versions - that's to say '''1.7-3.0.12.500''' and above.
  
More info: in recent Galacticraft versions DragonAPI v2 will be detected during startup and you will be referred to this page. In earlier Galacticraft versions (prior to 3.0.6.234), the game would crash when you take a rocket, with this in the crash report:
+
This topic will cover any known incompatibilities and what you can do about them. This topic is constantly updated when new issues come to light.
<pre>java.lang.NoSuchMethodError: micdoodle8.mods.galacticraft.api.prefab.world.gen.WorldProviderSpace.getCelestialBody</pre>
 
  
The issue was because of DragonAPI v2 force-loading a piece of outdated Galacticraft code in advance of Galacticraft itself. As mentioned above, this has long since been fixed in DragonAPI v3But if for some reason you have to use DragonAPI v2 (because of a modpack which has not updated), then you can fix the issue yourself by a manual edit of the DragonAPI.jar.
+
'''First off, you really should update to the latest Galacticraft version - it will have the latest compatibility fixes.'''  The latest is the version at the top of the list on the [http://micdoodle8.com/mods/galacticraft/downloads Downloads] pageThe latest version includes the latest compatibility fixes - so it should normally be the most stable version.
  
Steps:
+
For Galacticraft 2 compatibility information, see [http://forum.micdoodle8.com/index.php?threads/known-incompatibilities-and-cross-mod-issues-1-6-4.4313/ forum thread]
*  Find the DragonAPI 1.7.10 V2.jar file in your <code>.minecraft/mods</code> folder
 
*  Open the .jar using any program which can create a Zip file (for example, [http://www.7-zip.org/download.html 7Zip] is free and open source)
 
*  Delete the folder <code>micdoodle8</code>
 
{{Listend}}
 
  
''Note: if playing on a server, it will need to be fixed on both client '''and''' server.''
+
==Minecraft and Forge versions==
 +
See [[Tutorials/Galacticraft_Installation_Guide|Installation Guide]] for details of the Minecraft, Forge and Java version requirements.
  
 
==General compatibility notes==
 
==General compatibility notes==
 +
We intend for Galacticraft to be compatible with all popular mods.  If you are having mod compatibility issues, please (1) update to latest Galacticraft (2) read this page to look for any specific issues and how to fix them.  For severe issues - crashes or other obvious incompatibility - please report them to us on the Github issues list, if not already covered on this page.
  
===Any other mod with 'Fake Player' detection===
+
If using Galacticraft with other mods or in modpacks, it is also strongly recommended to read [[Config#World_Generation]].
A few mods detect and block actions by 'fake players'. Robots, golems, and some other machines which can mine or harvest like players can, are examples of fake players.  Fake player detection can get messed up by Galacticraft (because the regular player is replaced by a Galacticraft player with extra inventory slots, oxygen gear, etc) so that the other mod might block action by real players as well.  Some mods - examples: Extra Utilities, Blood Magic - have added extra code for full Galacticraft compatibility, which we appreciate. (If you are having problems with those two, check you are using really latest versions.)
 
  
We are not aware of any other mods with current issues, but if it happens, as a workaround, most other mods should work 100% OK with Galacticraft if you have the '''PlayerAPI''' mod installed - so just place PlayerAPI-1.7.10-1.0.jar in your /mods folder.
+
 
 +
===Certain powerful blocks not working in another mod - solution: use Player API===
 +
A few mods detect and block actions by 'fake players'. 'Fake players' are robots, golems, and other things or machines which can mine or harvest like the player - anything which can simulate a right-click on blocks. For some mods, some things - usually the most powerful features, for example portals and altars - are only usable by real players, not by fake players, so the mod tries to detect and block fake players.  Fake player detection can get confused by Galacticraft because the regular player is replaced by a Galacticraft player with extra inventory slots, oxygen levels, etc - if that happens, the other mod might block action by real players as well, when Galacticraft is installed.
 +
 
 +
If you are having problems of this kind with any other mod - basically something the player normally can do in the mod works fine if Galacticraft is not installed, but stops working and just seems to do nothing with Galacticraft installed - then first check you are using latest versions of both mods.    Some mods - examples: Extra Utilities, Blood Magic - have added extra code for full Galacticraft compatibility, which we appreciate.  (But even in the latest version of Extra Utilities, the portals to the Deep Dark and the Last Millennium do not work with Galacticraft unless Player API is installed: see next paragraph.)
 +
 
 +
If updating to latest versions did not solve the problem, then often issues of this kind will fix themselves if you have the '''Player API''' mod installed.  To install Player API just place [http://www.mediafire.com/?b8tgyx21fvecr4n PlayerAPI-1.7.10-1.4.jar] in your /mods folder.  You don't need to do anything else: Player API simply works in the background, helping inter-mod compatibility.
  
 
''Note: if playing on a server, PlayerAPI will need to be installed on both client and server.''
 
''Note: if playing on a server, PlayerAPI will need to be installed on both client and server.''
  
 
===Any other mods with energy and pipe connections===
 
===Any other mods with energy and pipe connections===
As of version 3.0.6.240, Galacticraft 3 has full power compatibility with:
+
As of version 3.0.6.240 and all later versions, Galacticraft 3 has full power compatibility with:
 
* Mekanism
 
* Mekanism
* IndustrialCraft 2
+
* IndustrialCraft 2 (and GregTech)
 
* BuildCraft
 
* BuildCraft
 +
* RailCraft
 
* Thermal Expansion​
 
* Thermal Expansion​
 
* EnderIO
 
* EnderIO
* any mod using RF power
+
* any other mod using RF power
 
{{Listend}}
 
{{Listend}}
  
That should also give compatibility with most / all mods. (Except GregTech, latest versions of GregTech have deliberately chosen to break power compatibility with other mods.) Any power compatibility issues, please let the developers know via the [https://github.com/micdoodle8/Galacticraft/issues Github issues list].
+
That should give compatibility with most / all mods. For GregTech, you might need to update to recent (end 2017 / early 2018) versions.  Any power compatibility issues, please let the developers know via the [https://github.com/micdoodle8/Galacticraft/issues Github issues list]. ''Note that Galacticraft configs allow players and server owners to switch off compatibility with some other power mods, if it is unwanted.  So check your configs before reporting issues.''
  
 
For information on power conversion ratios between mods, and how you can control whether conversion has losses or is loss-free, see [[Energy#Conversion_Ratios|Energy]].
 
For information on power conversion ratios between mods, and how you can control whether conversion has losses or is loss-free, see [[Energy#Conversion_Ratios|Energy]].
  
Fluid pipes from all mods should work with Galacticraft liquids. That does not mean you could use fluid containers from other mods in GC machines, some of the GC machines will take canisters only.
+
Fluid pipes from all mods should work with Galacticraft liquids. Galacticraft machines which handle liquids will accept fluid pipe connections from other mods - but note that (in Galacticraft 3) Galacticraft's ''oxygen'' and ''hydrogen'' systems will not accept gas pipes from other mods except Mekanism - in [[Galacticraft 4]] the machines work with all pipes.  Galacticraft machines which use liquids (for example [[Fuel Loader]]) will accept Galacticraft's own canisters, also buckets of the right type of liquid from other mods - perhaps also other types of fluid container, try it and see.
  
If you have wire or pipe connection issues with any of these mods (and it's not already listed in the Known Issues, link above) please do let us know.
+
If you have wire or fluid pipe connection issues with any of these mods (and it's not already listed in the Known Issues, link above) please do let us know.
  
 
===Code in other mods which looks for 'air' blocks===
 
===Code in other mods which looks for 'air' blocks===
A few mods are coded to look only for vanilla air blocks when they are looking for space for something (for example, looking if there is enough room to build a multiblock structure). That is outdated coding. It will cause those mods to fail in some places with Galacticraft - for example in a [[Sealed Space|sealed space base]]. The other mods should update their code to use Block.isAir() or World.isAirBlock() for the air checks. The Bukkit teleportation plugin, Essentials, has the same problem - it won't let you teleport into a sealed space.
+
A few mods are coded to look only for vanilla air blocks when they are looking for space for something (for example, looking if there is enough room to build a multiblock structure). That is outdated coding. It will cause those mods to fail in some places with Galacticraft - for example in a [[Sealed Space|sealed space base]].
  
If you have the Factorization mod installed, it has a nice feature called [AirInspector] which checks the code of all mods and tells you - in the logs - if a mod has this air block problem. It's then a question of showing those logs to the other mod authors and asking them to fix it.
+
The Bukkit teleportation plugin, Essentials, has the same problem - it won't let you teleport into a sealed space.  We recommend players who want to use Essentials teleport commands to access their base use an [[Air Lock]], or you can maybe ask the Essentials team to fix this by using a Block.isAir() test.
 +
 
 +
If you have the Factorization mod installed, it has a nice feature called [AirInspector] which checks the code of all mods and tells you - in the logs - if a mod has this air block problem. It's then a question of showing those logs to the other mod authors and asking them to fix it. The other mods should update their code to use Block.isAir() or World.isAirBlock() for the air checks.
  
 
===Sealing blocks from other mods===
 
===Sealing blocks from other mods===
For [[Sealed Space#Working with other mods|sealers]] to work correctly, you might have to set the glass blocks from other mods - and any other special blocks which must be sealed on all 6 sides in Galacticraft core [[config]]. Read [[SealableIDs|Sealable Block IDs]] for full instructions.
+
For [[Sealed Space#Working with other mods|sealers]] to work correctly, you might have to set the ''glass'' blocks from other mods - and any other special blocks which must be sealed on all 6 sides - in Galacticraft core [[config]]. Read [[SealableIDs|Sealable Block IDs]] for full instructions.
  
Glass is a special block because you can't place a torch on it. So think about anything else which you can't place a torch on...
+
Glass is a special block because you cannot place a torch on it. So think about anything else which you can't place a torch on...
  
 
You do not need to set regular solid blocks as sealable (e.g. ore blocks or machine blocks), Galacticraft already knows those are sealable. Galacticraft also understands about blocks which are solid on one side only, for example Facades in Forge Microblocks.
 
You do not need to set regular solid blocks as sealable (e.g. ore blocks or machine blocks), Galacticraft already knows those are sealable. Galacticraft also understands about blocks which are solid on one side only, for example Facades in Forge Microblocks.
Line 118: Line 106:
 
You cannot set leaves, or any block made out of cloth, gravel or sponge materials, as sealable - air goes through these blocks. This includes vanilla wool blocks and mod blocks made out of wool or cotton etc.
 
You cannot set leaves, or any block made out of cloth, gravel or sponge materials, as sealable - air goes through these blocks. This includes vanilla wool blocks and mod blocks made out of wool or cotton etc.
  
''Note: if playing on a server, this is a server-only setting.''
+
''Note: if playing on a server, Sealable IDs is a server-only setting.''
  
 
===Ores from other mods not generating on planets===
 
===Ores from other mods not generating on planets===
 
This is normal, Galacticraft 3 blocks other mods from generating ores on the Moon and other planets.
 
This is normal, Galacticraft 3 blocks other mods from generating ores on the Moon and other planets.
  
There is a [[Config#Adding_ores_from_other_mods|config setting]] which can enable the oregen from other mods, but it has problems:
+
There is a [[Config#Adding_ores_from_other_mods|config override]] which can enable the oregen from other mods, but it has problems:
* other mods will then generate all their ores, treating Moon Rock and Mars Stone as if they were plain stone (Galacticraft 3.0.6.230 and later) which makes for a bit of a mess underground
+
* other mods will then generate ''all'' their ores, treating Moon Rock and Mars Stone as if they were plain stone which can make things look untidy underground
 
* other mods will also try to generate their other features and structures on the Moon, for example Natura clouds and flowers, IC2 rubber trees, Tinker's Construct slime islands, and many others; these are usually unwanted
 
* other mods will also try to generate their other features and structures on the Moon, for example Natura clouds and flowers, IC2 rubber trees, Tinker's Construct slime islands, and many others; these are usually unwanted
 
* there can be 'Already Decorating!' crashes which are caused by rare bugs in the other mods' code (maybe they weren't expecting to be generating on the Moon?)
 
* there can be 'Already Decorating!' crashes which are caused by rare bugs in the other mods' code (maybe they weren't expecting to be generating on the Moon?)
 
{{Listend}}
 
{{Listend}}
  
So we generally advise you not to enable that config setting.  Instead, since version 3.0.4 Galacticraft offers a feature where Galacticraft will add other mods ores at the same time when it is generating Galacticraft's own ores on the Moon and Mars. You have to specify in Galacticraft's config the block IDs of the ores to generate, and how rare it is etc. Full instructions on this are [[Oregen|here]].
+
So we generally advise you not to enable that config setting.  Instead, Galacticraft 3 offers a feature where Galacticraft will add other mods ores at the same time when it is generating Galacticraft's own ores on the Moon and Mars. You have to specify in Galacticraft's config the block IDs of the ores to generate, and how rare it is etc. Full instructions on this are [[Oregen|here]].
  
 
(Alternatively, since version 3.0.6.239 you can use CoFHCore custom oregen for similar control over this process, though that's a little more complex: link [[Config#Adding_ores_from_other_mods|here]].)
 
(Alternatively, since version 3.0.6.239 you can use CoFHCore custom oregen for similar control over this process, though that's a little more complex: link [[Config#Adding_ores_from_other_mods|here]].)
Line 135: Line 123:
 
''Note: if playing on a server, this is a server-only setting.''
 
''Note: if playing on a server, this is a server-only setting.''
  
==Notes on some specific mods (fixable issues)==
+
===Mods which use Global IDs for their entities===
====EnviroMine====
+
Galacticraft does not use Global Entity IDs (and has not done since December 2014).
If EnviroMine's "food rot" feature is enabled, please be sure to be using Galacticraft version 3.0.6.249 or later.  (With earlier GC versions, there can be crashes when rockets are placed or when traveling to any planet or moon and spawning a lander.)
+
 
 +
Some mods do still use Global IDs, which causes entity ID conflicts if the ID numbers clash. '''VoidMonster''' is one.  '''OreSpawn''' was another (that's a huge mod with sub-mods (eg. Girlfriends) which add many new mobs to the game.)
 +
 
 +
If using any of these other mods, please update your Galacticraft to version 3.0.12.426 or later, that will fix any possible incompatibility between Galacticraft and those other mods' entities (though the other mods may still clash with each other).
 +
 
 +
''(Earlier Galacticraft versions may also be OK, though from versions 377 to 423 there could be entity registration problems in the other mods if the other mod chose entity IDs in the range 120-129 and loaded after Galacticraft.  And if for some reason you are still using a version of Galacticraft ''prior to 245'' you can change entity ID settings in Galacticraft's <code>core.conf</code> and <code>mars.conf</code> to try to solve conflicts.  Normally it's only the creature mob entity IDs which will need to be changed - so Evolved Zombies, Evolved Creepers, Evolved Spiders, Evolved Skeletons, the two bosses, Alien Villagers, and Slimeling and Sludgeling.  Change them to higher numbers (between 175 and 255) until you find ones which work.  Entity ID settings in config files have no function in versions of Galacticraft 3 higher than 245, and can safely be edited out.)''
 +
 
 +
==Notes on some specific mods in Minecraft 1.7.10 (including fixable issues)==
 +
 
 +
====Optifine====
 +
As of Galacticraft 3 version 426, there is full compatibility with Optifine Standard and Ultra - for example '''Optifine_1.7.10_HD_U_C1'''
 +
 
 +
Earlier Galacticraft versions had an issue where Optifine made the oxygen helmet and tanks invisible. (Optifine Lite did not have this problem.)  It was previously recommended to install '''SmartRender''' from SmartMoving mod with '''PlayerAPI''' and '''RenderPlayerAPI''', to overcome this Optifine problem.  Installing those extra .jars is '''not''' necessary to use Optifine with Galacticraft version 426 or later.
 +
 
 +
(Fixable issue) Do not use the outdated version '''Optifine_1.7.10_HD_U_A4'''.  It could make some of Galacticraft's blocks invisible, it had the same problem with other mods like Applied Energistics and Tinker's Construct.  This was fixable by updating Optifine to version '''Optifine_1.7.10_HD_U_B5''' or later.
 +
 
 +
====Mekanism====
 +
Galacticraft generally pairs very well with Mekanism.  Note that Mekanism was (as of March 2015) updated from v.7 to v.8.  In Minecraft 1.7.10 versions:
 +
 
 +
* Galacticraft 3.0.11.306 (and later) has dual support for '''Mekanism v.8 and Mekanism v.7'''.
 +
 
 +
* Galacticraft 3.0.9 (and earlier versions) had support for '''Mekanism v.7''' onlyMekanism v.8 should not be used with these older Galacticraft versions - Mekanism v.8 gas systems (for example, Pressurised Tubes) will crash if used with Galacticraft 3.0.9 or earlier.
 +
{{Listend}}
 +
 
 +
====Tinker's Construct====
 +
Full compatibility. Remember to set Clear Glass as a [[SealableIDs|Sealable Block ID]] in Galacticraft core config, if you want to build space bases out of Clear Glass.
 +
 
 +
We have made it so Tinker's Construct stone torches work like regular torches in space - they will extinguish if there is no air, and re-light if oxygen is provided.
 +
 
 +
Galacticraft's metals from extraterrestrial sources (Meteoric Iron, Desh, and Titanium) cannot be smelted in a Tinker's Construct furnace nor made into any Tinker's Construct tools, and we have no current plans to add this feature - the space metals are not similar to any of the existing types of metal.
 +
 
 +
====IC2 (IndustrialCraft2)====
 +
Full compatibility.  IC2 batteries (of suitable tiers) can be charged in Galacticraft [[Energy Storage Module]] and [[Energy Storage Cluster]] and can power Galacticraft machines, and the other way around.  Galacticraft power systems (Aluminium Wires, Energy Beams or Energy Storage Modules) can be used to power all IC2 machines, except for the Electric Kinetic Generator and the Electric Heat Generator.
 +
 
 +
There was an energy dupe (free energy creation) between IC2 and Galacticraft prior to Galacticraft version 410.  Please update to version 411 or later if you are affected by this - servers should update.
 +
 
 +
Sealed versions of some IC2 cables can be made in Galacticraft - look up which ones in NEI.
 +
 
 +
====Buildcraft====
 +
Full compatibility.  For detailed Buildcraft compatibility notes see [[Buildcraft]].
 +
 
 +
Sealed versions of some Buildcraft pipes can be made in Galacticraft - look up which ones in NEI.  These are stable as of Galacticraft version 426, and also work with BuildcraftCompat.
  
 
====Smart Moving====
 
====Smart Moving====
All recent GC3 builds (since 3.0.3.201) are fully compatible with Smart Moving and other mods which use the Player API.  (There may be minor rendering issues with some versions, e.g. Galacticraft parachute strings not rendering properly, we are working on fixing those.)
+
Galacticraft 3 is fully compatible with [http://minecraft.curseforge.com/projects/smart-moving Smart Moving] (requires [http://minecraft.curseforge.com/projects/smart-render Smart Render] and [http://minecraft.curseforge.com/projects/player-api Player API]) as of GC3 version 3.0.12.426 (tested with SmartMoving-1.7.10-15.6, SmartRender-1.7.10-2.1 and PlayerAPI-1.7.10-1.4.)  Galacticraft has been mostly compatible with Smart Moving since GC 3.0.3.201 but some issues remained, recently fixed in version 426.
 +
 
 +
''For full compatibility with Galacticraft - to see the player oxygen tanks etc - you must install [http://minecraft.curseforge.com/projects/render-player-api Render Player API] with Smart Moving.  (Tested with RenderPlayerAPI-1.7.10-1.4.)''
 +
 
 +
====Animated Player====
 +
Like other mods that change or affect the player model and its animations, Animated Player can break some Galacticraft animations (e.g. holding rocket, parachute descending etc). The problem can be fixed by installing [http://minecraft.curseforge.com/projects/render-player-api Render Player API] and [http://minecraft.curseforge.com/projects/player-api Player API].
 +
 
 +
(Tested Animated Player 1.5.0 and Animation API 1.2.2: these are compatible with Galacticraft if you have Player API 1.4 and Render Player API 1.2 or later installed.)
  
 
====RenderDecorator and VoxelPlayer====
 
====RenderDecorator and VoxelPlayer====
Like other mods that change or affect the player model and its animations, RenderDecorator and VoxelPlayer can break some Galacticraft animations (e.g. holding rocket, parachute descending etc). It can be fixed by installing '''Render Player API'''. [https://github.com/micdoodle8/Galacticraft/issues/1337 Link].
+
It's the same story for RenderDecorator and VoxelPlayer. Install [http://minecraft.curseforge.com/projects/player-api Player API] and [http://minecraft.curseforge.com/projects/render-player-api Render Player API] and things should be OK.
 +
 
 +
====RenderPlayerAPIEnhancer====
 +
Galacticraft is compatible with RenderPlayerAPIEnhancer since GC version 426.  Earlier GC versions could cause rare client-side crashes if a mob (for example Zombie Pigman, Zombie or Skeleton) spawned wearing special types of modded armor from another mod (for example Glowstone Armor from Mekanism).
  
====Animated Player====
+
====EnviroMine====
It's the same story for Animated Player. Install '''PlayerAPI''' and '''Render Player API''' and things should be OK.  (Specifically, Animated Player 1.5.0 with Animation API 1.2.2 has been reported to be compatible with Galacticraft if you have Player API 1.4 and Render Player API 1.2 installed.)
+
If EnviroMine's "food rot" feature is enabled, please be sure to be using Galacticraft version 3.0.6.249 or later.  (With earlier GC versions combined with EnviroMine, there were crashes when rockets were placed on launch pads - it didn't look anything connected with EnviroMine, but it was.)
 +
 
 +
====Sync====
 +
Galacticraft is fully compatible with Sync mod, since GC version 426. Prior Galacticraft versions could lose part of Galacticraft's functionality when changing planets after a player was cloned.
 +
 
 +
====Ex Nihilo====
 +
Torches can be used to heat Ex Nihilo crucibles even in space environments, if there is oxygen so that the torch is burning. (This is as of Galacticraft version 411 and later.)
  
 
====Mariculture====
 
====Mariculture====
 
The recipe clash between GC [[Copper Canister|canisters]] and Mariculture vats can be fixed by a setting in Galacticraft core config which allows an alternative recipe for canisters.
 
The recipe clash between GC [[Copper Canister|canisters]] and Mariculture vats can be fixed by a setting in Galacticraft core config which allows an alternative recipe for canisters.
  
Note also that Mariculture disables other mods' smelting recipes for aluminum ore, so you won't be able to smelt Galacticraft [[Aluminum Ore]] at all, if Mariculture is installed.
+
Mariculture disables other mods' smelting recipes for aluminum ore, so you won't be able to smelt Galacticraft [[Aluminum Ore]] at all, if Mariculture is installed.
 +
 
 +
If combining Mariculture with GregTech5, it's advisable to set Mariculture config:
 +
<pre>Biome Top Block Replacements > Enable = false</pre>
 +
(otherwise it can cause issues when Galacticraft is generating other planets).  [https://github.com/joshiejack/Mariculture/issues/256 More details on this] from Mariculture developer joshiejack.
  
 
====GregTech====
 
====GregTech====
In recent GregTech builds the power systems are not compatible with IC2 or another mod, including Galacticraft - see above.
+
In 2016 some GregTech builds the power systems were not compatible with IC2 or any other mod, including Galacticraft.  We understand from GregTech developer that there is compatibility in 2017 versions, please try updating to latest.
  
The other mods ''oregen'' on planets IDs config setting ([[Compatibility#Ores_from_other_mods_not_generating_on_planets|link]]) will not work to generate GregTech ores on Galacticraft planets.  It's because GregTech uses a non-standard, extra-complicated way of identifying ore blocks in the world.  Fortunately there is a third-party plugin for GregTech, [http://forum.industrial-craft.net/index.php?page=Thread&threadID=11039 GalactiGreg by BloodAsp], which can fix that for you.  People also give some tips there on Galacticraft sealer config settings when playing with GregTech.
+
Galacticraft's [[Compatibility#Ores_from_other_mods_not_generating_on_planets|feature]] allowing other mods ''oregen'' on planets will not work to generate GregTech ores on Galacticraft planets.  It's because GregTech uses a non-standard, extra-complicated way of identifying ore blocks in the world.  Fortunately there is a third-party plugin for GregTech, [http://forum.industrial-craft.net/index.php?page=Thread&threadID=11039 GalactiGreg by BloodAsp], which can fix that for you.  People also give some tips there on Galacticraft sealer config settings when playing with GregTech.
  
====Tinker's Construct====
+
====Extra Utilities====
Full compatibility. Remember to set Clear Glass as a [[SealableIDs|Sealable Block ID]] in Galacticraft core config, if you want to build space bases out of Clear Glass.
+
If you find that the ExtraUtilities portals for the Deep Dark and the Last Millennium are not working, that can be fixed by installing '''PlayerAPI''' alongside Galacticraft.
 +
 
 +
ExtraUtilities also needs PlayerAPI for the Etheric Sword + Soul Fragment health restoration (when a Soul Fragment is right-clicked) to work properly.
  
====OreSpawn====
+
====Multiverse====
This is a mod which, with all its sub-mods (eg. Girlfriends), adds a huge number of new mobs to the game.  To avoid mob entity ID conflicts with Galacticraft, please be sure to be using Galacticraft version 3.0.6.245 or later.
+
Use Galacticraft 3 version 426 or later with Multiverse. In prior versions, to ensure the Galacticraft dimensions are loaded at server start so that Multiverse knows how to send players to the dimensions, you had to go into the Galacticraft/core.conf file and add the dimensions -28, -29, -30, one on each line, inside the "I:"Static Loaded Dimensions"" braces. [[Tutorials/Space_Station_for_Server_Admins#Making_dimensions_available_to_other_mods_using_core.conf|Further reading]]
  
(In earlier Galacticraft versions you can change entity ID settings in Galacticraft's <code>core.conf</code> and <code>mars.conf</code>.  Normally it's only the mob entity IDs which will need to be changed - so the four kinds of Evolved Mobs, and Slimeling and Sludgeling.  Change them to higher numbers (between 175 and 255) until you find ones which work.)
+
The above may also help to fix errors of this type: <code>Could not pass event PlayerTeleportEvent to Multiverse-Core</code>
  
 
====Erebus====
 
====Erebus====
 
There is a biome ID overlap between Erebus and Galacticraft, both mods are trying to use biome IDs 102-105.  This can cause weird issues with GC biomes sometimes generating in the Overworld, or occasionally crashes in Erebus ([https://github.com/micdoodle8/Galacticraft/issues/1342 see here]).  To fix this, in Erebus config, change the biome IDs 102, 103, 104, 105.  You can probably use 106, 107, 108, 110.
 
There is a biome ID overlap between Erebus and Galacticraft, both mods are trying to use biome IDs 102-105.  This can cause weird issues with GC biomes sometimes generating in the Overworld, or occasionally crashes in Erebus ([https://github.com/micdoodle8/Galacticraft/issues/1342 see here]).  To fix this, in Erebus config, change the biome IDs 102, 103, 104, 105.  You can probably use 106, 107, 108, 110.
  
===Custom NPCs===
+
Alternatively, in recent Galacticraft versions you can change the Galacticraft biome base ID in configs. You would need to regenerate all your Galacticraft dimensions after changing this for it to take full effect (otherwise the space dimensions will be labelled as being Erebus biomes still).
(Small issue) There is a position clash with Custom NPCs 'Quests' buttons in the player inventory, but you can reach the Quests dialog by clicking on 'Factions' first, then 'Quests'. [https://github.com/micdoodle8/Galacticraft/issues/831 Link]
 
  
===Optifine===
+
====Custom NPCs====
(Fixable issue) Optifine Standard and Ultra may make your Galacticraft oxygen helmet and tanks invisible (Optifine Lite does not have this problem)From Galacticraft version 3.0.8.260, players have been able to fix it by installing SmartRender (from SmartMoving mod) - you do not need to install all of SmartMoving mod.
+
(Small issue) There is a position clash with Custom NPCs 'Quests' buttons in the player inventory, but you can reach the Quests dialog by clicking on 'Factions' first, then 'Quests'. [https://github.com/micdoodle8/Galacticraft/issues/831 Link]  These issues are fixed in more recent versions of Custom NPCs(With [[Galacticraft 4]] make sure your Custom NPCs version is from May 2017 or later.)
  
(Fixable issue) The outdated version '''Optifine_1.7.10_HD_U_A4''' used together with '''Forge versions after 1232''' was reported to make some of the Galacticraft blocks invisible, it had the same problem with some blocks from other mods like Applied Energistics and Tinker's ConstructThis can be fixed by updating Optifine, to version '''Optifine_1.7.10_HD_U_B5''' or later.
+
====Dynamic Lights====
 +
Make sure to use Galacticraft version 426 or higher with Dynamic Lights(There was a problem in GC versions 411 through to 425.)
  
(Small issue) There are a few very minor rendering issues with Optifine, for example in the mini rocket graphic seen in the HUD on the left when your rocket is in flight, normally the player's face should be seen inside the rocket but the face is missing if Optifine is installed. These are not currently fixable, but they are very minor problems.
+
====Dynamic Surroundings====
 +
''Fancy Cloud Handling'' will break Galacticraft in all space dimensions - the look of the dimension will be off, maybe also the gravity will be wrong.  You can disable Fancy Cloud Handling in the config of Dynamic Surroundings (dsurround.cfg).
  
 +
Dynamic Surroundings, since version 1.10.2-3.4.5.3, supports Galacticraft dimensions. For Galacticraft 1.7.10 and 1.8.9, use the cfg files available [https://forum.micdoodle8.com/index.php?threads/dynamic-surroundings-config-files-for-galacticraft.6639/ here].
  
 
==Non-fixable issues==
 
==Non-fixable issues==
Line 194: Line 247:
 
Karyonix GLSL Shaders Mod is currently unsupported; the sky will not look good on Galacticraft planets or space environments.  Best would be if that mod can auto-disable itself in Galacticraft dimensions.
 
Karyonix GLSL Shaders Mod is currently unsupported; the sky will not look good on Galacticraft planets or space environments.  Best would be if that mod can auto-disable itself in Galacticraft dimensions.
  
==Minor or unconfirmed issues==
+
==Minor issues==
 +
===Torched===
 +
(Small issue) The Rocket Propelled Torch (RPT) Launcher will not work correctly in Galacticraft's airless dimensions.  The RPT Launcher will place lit torches, not unlit torches - and these lit torches will stay lit even without air.  The RPT Launcher cannot be re-filled with torches while the player stays in an airless dimension.
 +
 
 
===Twilight Forest===
 
===Twilight Forest===
 
(Small issue) A rare issue with the Twilight Forest Scepter item has been reported, causing blocks to be drawn darker than normal in Space Station dimensions. [https://github.com/micdoodle8/Galacticraft/issues/1218 Link]
 
(Small issue) A rare issue with the Twilight Forest Scepter item has been reported, causing blocks to be drawn darker than normal in Space Station dimensions. [https://github.com/micdoodle8/Galacticraft/issues/1218 Link]
 +
 +
===DragonAPI (recent versions)===
 +
(Small issue) If this mod is present and Galacticraft is also installed, a player in Minecraft's third person view will be drawn solid like normal, even if the player is underwater (or in some other kind of liquid).  [https://github.com/micdoodle8/Galacticraft/issues/2379 Screenshots]
 +
 +
==Issues and bugs in other mods (and how to fix them!)==
 +
 +
All of the issues described in the following section are caused by ''other'' mods.  The latest versions of Galacticraft include workarounds to make it less likely that these type of problems will arise.  With older versions of Galacticraft there may also be steps you can take to fix these issues yourself, see below.
 +
 +
===The world xxxxxxxx (world) may have leaked: seen 25 times===
 +
This type of information message is sometimes seen in server logs.  If the named world xxxxxxxx is a Galacticraft dimension - for example, the Moon - this does '''not''' mean there is an issue in Galacticraft.  The log message is telling you ''where'' the issue is - which dimension it is in -- but not which mod caused the issue.  Don't blame Galacticraft!  Galacticraft provides the dimensions, but doesn't cause the issue.  Obviously, if you have 50 mods installed and you place blocks from all of those mods in your Moon base, then it could be any of those mods causing the issue.
 +
 +
A 'world leak' is not a serious problem at all.  It is a ''small'' memory leak, meaning that if you run a server for several hours, your Java base memory use, the minimum memory used by the game, will very slowly increase over that time - it will increase a little bit any time a player goes to the world which is 'leaking' and then leaves it again.  The ''reason'' for a world leak is bad programming style by a mod author, very hard to track down, and most programmers do it every once in a while.
 +
 +
Players who are not mod developers or the admins of large public servers really do not need to worry about this.
 +
 +
==='Already decorating!' crashes on the Moon (or other Galacticraft worlds)===
 +
These do not occur in Galacticraft 3 itself since around version 300 or later.  If you see this, the cause is almost certainly another mod.  Look through the crash report's stacktrace carefully and try to see which mods' code is mentioned lower down in the trace.
 +
 +
In outdated versions of Galacticraft prior to 297, the CofHCore 'Flat Bedrock' feature (which can be enabled in CofH configs) could cause this 'Already decorating!' crash, usually fixable by going into the CoFHWorld.cfg file and setting the number of layers of bedrock to 1.  (In recent versions of CoFHCore the config file is <code>CoFH/Core/Common.cfg</code>.)  ''Note: if playing on a server, this is a server-only fix.''
 +
 +
<font size=2>(For info: CoFH replaces all blocks down there with bedrock before the chunk is fully generated.  This causes problems if CoFHCore over-writes a block which has a TileEntity.  That's a bug in CoFHCore - mods should '''not''' change blocks with TileEntities before the chunk and its neighbours are fully generated, because over-writing a block with a TileEntity causes a block update on the neighbours which can mean the neighbouring chunk in turn has to be generated, potentially producing an infinite worldgen loop.  Galacticraft has included a special patch which works around this issue by delaying TileEntity creation if CoFHCore is active.)</font>
 +
 +
===Crash report with GCEntityClientPlayerMP===
 +
People sometimes think that a crash report containing a line like this: 'micdoodle8.mods.galacticraft.core.entities.player.GCEntityClientPlayerMP' somewhere in the ''middle'' is a Galacticraft bug.  It isn't!  OK, in 99% of cases it isn't.  The crash is just passing through Galacticraft, the same way that it passes through all those bits of vanilla Minecraft code that you also see in crash reports.  [[Common_Problems#Crash_involving_GCEntityClientPlayerMP|Further reading]].
 +
 +
These types of crash reports can also be seen with GCEntityPlayerMP, GCPlayerBaseSP, and occasionally other GC entities.  Quite often the crashes seem to be connected with other mods which did not register new potion effects (e.g. dizziness, radiation poisoning) correctly.  Stuff like that.  Not space stuff.
 +
 +
===DragonAPI===
 +
If you're reading this section of this page, it's probably because you are still using DragonAPI 1.7.10 version 2 which is not the latest version.  '''The issue here has been fixed in DragonAPI 1.7.10 version 3 and later, and players should update to that.'''
 +
 +
More info: in recent Galacticraft versions DragonAPI v2 will be detected during startup and you will be referred to this page.  In earlier Galacticraft versions (prior to 3.0.6.234), the game would crash when you take a rocket, with this in the crash report:
 +
<pre>java.lang.NoSuchMethodError: micdoodle8.mods.galacticraft.api.prefab.world.gen.WorldProviderSpace.getCelestialBody</pre>
 +
 +
The issue was because of DragonAPI v2 force-loading a piece of outdated Galacticraft code in advance of Galacticraft itself.  As mentioned above, this has long since been fixed in DragonAPI v3, so if you're using v3 you should be fine.  But if for some reason you have to use DragonAPI v2 (because of a modpack which has not updated), then you can fix the issue yourself by a manual edit of the DragonAPI.jar.
 +
 +
Steps:
 +
*  Find the DragonAPI 1.7.10 V2.jar file in your <code>.minecraft/mods</code> folder
 +
*  Open the .jar using any program which can create a Zip file (for example, [http://www.7-zip.org/download.html 7Zip] is free and open source)
 +
*  Delete the folder <code>micdoodle8</code>
 +
{{Listend}}
 +
 +
''Note: if playing on a server, it will need to be fixed on both client '''and''' server.''
 +
 +
==For clients running OpenJDK==
 +
Several Linux distributions include OpenJDK for running Java, instead of the Java Runtime (JRE) from Sun / Oracle.
 +
 +
OpenJDK has a bug in its JPEG library.  Galacticraft makes a very minor use of the standard JPEG library to save some map images to disk on the client - folder assets/GalacticraftMaps - so that you can look at them outside the game (similar to the images seen in a [[Display Screen]]).
 +
 +
At one time (prior to Galacticraft version 3.0.12.357) this OpenJDK bug could cause [[https://github.com/micdoodle8/Galacticraft/issues/1321 startup issues on Linux servers]]) but Galacticraft now works around this, disabling the JPEG library use if there are problems with it, and showing a message in logs linking to here.
 +
 +
In [[Galacticraft 4]] and recent versions of Galacticraft 3, servers do not make use of the JPEG library at all.  Player clients only use it for saving images to disk as explained above, it does not affect gameplay if it is not present.
  
  

Latest revision as of 16:00, 23 February 2019

Galacticraft 4: Compatibility notes

Galacticraft 4 is currently compatible with most other mods. For extra notes about Sponge compatibility on servers, see Sponge.

If you come across compatibility issues, please (1) check the latest Galacticraft version as we make compatibility improvements all the time; (2) if there's still a problem in the latest, let us know on Github. Also try installing PlayerAPI mod, that can fix some compatibility issues. (The compatibility notes for Galacticraft 3, below, may also be relevant.)


Player inventory tabs

Custom NPCs In Minecraft 1.10.2 and 1.11.2, please make sure to use the latest (25 May 2017 or later) version of this mod with Galacticraft, older versions had inventory tab overlapping issues.

More Player Models In Minecraft 1.10.2 and 1.11.2, please make sure to use the latest (25 May 2017 or later) version of this mod with Galacticraft, older versions had inventory tab overlapping issues.

TechGuns uses its own inventory tabs which overlap with ours - if this is affecting you, please ask the TechGuns developer to update and use our API for compatibility.


Fixed compatibility issues

Avaritia Infinity Armor and other mods with custom hi-poly armor - please update to Galacticraft 4 build 152 or later, to have the armor drawn correctly on planets

Finder Compass To prevent client disconnects, please update your Galacticraft 4 to build 4.0.1.143 or newer.

JourneyMap If you are using JourneyMap waypoint teleports to travel between different planets, please update your Galacticraft 4 to build 4.0.1.143 or newer.

Forge - mods missing screen If you get a crash with this type of error when you start the game: java.lang.NoClassDefFoundError: cah (Minecraft 1.10.2 might show bxl instead of cah there) it might be Forge trying to give you that brown screen naming the required mods "missing", but crashing instead of showing the screen. To solve this issue, try updating Galacticraft and MicdoodleCore to the latest version.


Known compatibility issues

All Shaders mods - please switch off shaders when you leave the Overworld and travel to other planets - shaders mods cannot understand the dark or differently colored sky on the Moon and other planets.

Advanced Rocketry is a space-themed mod which has made some overlapping content with Galacticraft. If Advanced Rocketry and Galacticraft are installed together, Advanced Rocketry may take over some of the space dimensions, for example you may have some features of Advanced Rocketry's oxygen system or gravity on the Moon instead of Galacticraft's features on the Moon. For example, players have complained they can't breath on the Moon when they are wearing Oxygen Mask, Oxygen Gear and full Oxygen Tanks - if you're wearing those then it's Advanced Rocketry which is stopping you breathing, not us. We are hoping the Advanced Rocketry guys will provide a config or other solution to avoid this conflict (like they did in the 1.7.10 version of their mod)

WAILA: some versions of WAILA have a bug where the color of grass, leaves, sand and some other blocks changes to grey when the player is mounted in a vehicle, including a Galacticraft rocket. If using WAWLA with WAILA, please make sure to use the latest Galacticraft version.

Cubic Chunks mod causes multiple weird issues with Galacticraft if you build outside the 0-255 height range - for example it can interfere with rocket launch and landing.

ViveCraft is compatible with Galacticraft, but it needs you to set a config setting: "Disable Vehicle Third-Person and Zoom"=true

Minor issues reported with PlayerRevive and Valkyrie Warfare mods.

Custom NPCS has been known to cause issues when loading a modpack with Galactacraft 4

Galacticraft 3: Compatibility with other mods

All information below is for Galacticraft 3, all recent versions - that's to say 1.7-3.0.12.500 and above.

This topic will cover any known incompatibilities and what you can do about them. This topic is constantly updated when new issues come to light.

First off, you really should update to the latest Galacticraft version - it will have the latest compatibility fixes. The latest is the version at the top of the list on the Downloads page. The latest version includes the latest compatibility fixes - so it should normally be the most stable version.

For Galacticraft 2 compatibility information, see forum thread

Minecraft and Forge versions

See Installation Guide for details of the Minecraft, Forge and Java version requirements.

General compatibility notes

We intend for Galacticraft to be compatible with all popular mods. If you are having mod compatibility issues, please (1) update to latest Galacticraft (2) read this page to look for any specific issues and how to fix them. For severe issues - crashes or other obvious incompatibility - please report them to us on the Github issues list, if not already covered on this page.

If using Galacticraft with other mods or in modpacks, it is also strongly recommended to read Config#World_Generation.


Certain powerful blocks not working in another mod - solution: use Player API

A few mods detect and block actions by 'fake players'. 'Fake players' are robots, golems, and other things or machines which can mine or harvest like the player - anything which can simulate a right-click on blocks. For some mods, some things - usually the most powerful features, for example portals and altars - are only usable by real players, not by fake players, so the mod tries to detect and block fake players. Fake player detection can get confused by Galacticraft because the regular player is replaced by a Galacticraft player with extra inventory slots, oxygen levels, etc - if that happens, the other mod might block action by real players as well, when Galacticraft is installed.

If you are having problems of this kind with any other mod - basically something the player normally can do in the mod works fine if Galacticraft is not installed, but stops working and just seems to do nothing with Galacticraft installed - then first check you are using latest versions of both mods. Some mods - examples: Extra Utilities, Blood Magic - have added extra code for full Galacticraft compatibility, which we appreciate. (But even in the latest version of Extra Utilities, the portals to the Deep Dark and the Last Millennium do not work with Galacticraft unless Player API is installed: see next paragraph.)

If updating to latest versions did not solve the problem, then often issues of this kind will fix themselves if you have the Player API mod installed. To install Player API just place PlayerAPI-1.7.10-1.4.jar in your /mods folder. You don't need to do anything else: Player API simply works in the background, helping inter-mod compatibility.

Note: if playing on a server, PlayerAPI will need to be installed on both client and server.

Any other mods with energy and pipe connections

As of version 3.0.6.240 and all later versions, Galacticraft 3 has full power compatibility with:

  • Mekanism
  • IndustrialCraft 2 (and GregTech)
  • BuildCraft
  • RailCraft
  • Thermal Expansion​
  • EnderIO
  • any other mod using RF power

That should give compatibility with most / all mods. For GregTech, you might need to update to recent (end 2017 / early 2018) versions. Any power compatibility issues, please let the developers know via the Github issues list. Note that Galacticraft configs allow players and server owners to switch off compatibility with some other power mods, if it is unwanted. So check your configs before reporting issues.

For information on power conversion ratios between mods, and how you can control whether conversion has losses or is loss-free, see Energy.

Fluid pipes from all mods should work with Galacticraft liquids. Galacticraft machines which handle liquids will accept fluid pipe connections from other mods - but note that (in Galacticraft 3) Galacticraft's oxygen and hydrogen systems will not accept gas pipes from other mods except Mekanism - in Galacticraft 4 the machines work with all pipes. Galacticraft machines which use liquids (for example Fuel Loader) will accept Galacticraft's own canisters, also buckets of the right type of liquid from other mods - perhaps also other types of fluid container, try it and see.

If you have wire or fluid pipe connection issues with any of these mods (and it's not already listed in the Known Issues, link above) please do let us know.

Code in other mods which looks for 'air' blocks

A few mods are coded to look only for vanilla air blocks when they are looking for space for something (for example, looking if there is enough room to build a multiblock structure). That is outdated coding. It will cause those mods to fail in some places with Galacticraft - for example in a sealed space base.

The Bukkit teleportation plugin, Essentials, has the same problem - it won't let you teleport into a sealed space. We recommend players who want to use Essentials teleport commands to access their base use an Air Lock, or you can maybe ask the Essentials team to fix this by using a Block.isAir() test.

If you have the Factorization mod installed, it has a nice feature called [AirInspector] which checks the code of all mods and tells you - in the logs - if a mod has this air block problem. It's then a question of showing those logs to the other mod authors and asking them to fix it. The other mods should update their code to use Block.isAir() or World.isAirBlock() for the air checks.

Sealing blocks from other mods

For sealers to work correctly, you might have to set the glass blocks from other mods - and any other special blocks which must be sealed on all 6 sides - in Galacticraft core config. Read Sealable Block IDs for full instructions.

Glass is a special block because you cannot place a torch on it. So think about anything else which you can't place a torch on...

You do not need to set regular solid blocks as sealable (e.g. ore blocks or machine blocks), Galacticraft already knows those are sealable. Galacticraft also understands about blocks which are solid on one side only, for example Facades in Forge Microblocks.

You cannot set leaves, or any block made out of cloth, gravel or sponge materials, as sealable - air goes through these blocks. This includes vanilla wool blocks and mod blocks made out of wool or cotton etc.

Note: if playing on a server, Sealable IDs is a server-only setting.

Ores from other mods not generating on planets

This is normal, Galacticraft 3 blocks other mods from generating ores on the Moon and other planets.

There is a config override which can enable the oregen from other mods, but it has problems:

  • other mods will then generate all their ores, treating Moon Rock and Mars Stone as if they were plain stone which can make things look untidy underground
  • other mods will also try to generate their other features and structures on the Moon, for example Natura clouds and flowers, IC2 rubber trees, Tinker's Construct slime islands, and many others; these are usually unwanted
  • there can be 'Already Decorating!' crashes which are caused by rare bugs in the other mods' code (maybe they weren't expecting to be generating on the Moon?)

So we generally advise you not to enable that config setting. Instead, Galacticraft 3 offers a feature where Galacticraft will add other mods ores at the same time when it is generating Galacticraft's own ores on the Moon and Mars. You have to specify in Galacticraft's config the block IDs of the ores to generate, and how rare it is etc. Full instructions on this are here.

(Alternatively, since version 3.0.6.239 you can use CoFHCore custom oregen for similar control over this process, though that's a little more complex: link here.)

Note: if playing on a server, this is a server-only setting.

Mods which use Global IDs for their entities

Galacticraft does not use Global Entity IDs (and has not done since December 2014).

Some mods do still use Global IDs, which causes entity ID conflicts if the ID numbers clash. VoidMonster is one. OreSpawn was another (that's a huge mod with sub-mods (eg. Girlfriends) which add many new mobs to the game.)

If using any of these other mods, please update your Galacticraft to version 3.0.12.426 or later, that will fix any possible incompatibility between Galacticraft and those other mods' entities (though the other mods may still clash with each other).

(Earlier Galacticraft versions may also be OK, though from versions 377 to 423 there could be entity registration problems in the other mods if the other mod chose entity IDs in the range 120-129 and loaded after Galacticraft. And if for some reason you are still using a version of Galacticraft prior to 245 you can change entity ID settings in Galacticraft's core.conf and mars.conf to try to solve conflicts. Normally it's only the creature mob entity IDs which will need to be changed - so Evolved Zombies, Evolved Creepers, Evolved Spiders, Evolved Skeletons, the two bosses, Alien Villagers, and Slimeling and Sludgeling. Change them to higher numbers (between 175 and 255) until you find ones which work. Entity ID settings in config files have no function in versions of Galacticraft 3 higher than 245, and can safely be edited out.)

Notes on some specific mods in Minecraft 1.7.10 (including fixable issues)

Optifine

As of Galacticraft 3 version 426, there is full compatibility with Optifine Standard and Ultra - for example Optifine_1.7.10_HD_U_C1

Earlier Galacticraft versions had an issue where Optifine made the oxygen helmet and tanks invisible. (Optifine Lite did not have this problem.) It was previously recommended to install SmartRender from SmartMoving mod with PlayerAPI and RenderPlayerAPI, to overcome this Optifine problem. Installing those extra .jars is not necessary to use Optifine with Galacticraft version 426 or later.

(Fixable issue) Do not use the outdated version Optifine_1.7.10_HD_U_A4. It could make some of Galacticraft's blocks invisible, it had the same problem with other mods like Applied Energistics and Tinker's Construct. This was fixable by updating Optifine to version Optifine_1.7.10_HD_U_B5 or later.

Mekanism

Galacticraft generally pairs very well with Mekanism. Note that Mekanism was (as of March 2015) updated from v.7 to v.8. In Minecraft 1.7.10 versions:

  • Galacticraft 3.0.11.306 (and later) has dual support for Mekanism v.8 and Mekanism v.7.
  • Galacticraft 3.0.9 (and earlier versions) had support for Mekanism v.7 only. Mekanism v.8 should not be used with these older Galacticraft versions - Mekanism v.8 gas systems (for example, Pressurised Tubes) will crash if used with Galacticraft 3.0.9 or earlier.

Tinker's Construct

Full compatibility. Remember to set Clear Glass as a Sealable Block ID in Galacticraft core config, if you want to build space bases out of Clear Glass.

We have made it so Tinker's Construct stone torches work like regular torches in space - they will extinguish if there is no air, and re-light if oxygen is provided.

Galacticraft's metals from extraterrestrial sources (Meteoric Iron, Desh, and Titanium) cannot be smelted in a Tinker's Construct furnace nor made into any Tinker's Construct tools, and we have no current plans to add this feature - the space metals are not similar to any of the existing types of metal.

IC2 (IndustrialCraft2)

Full compatibility. IC2 batteries (of suitable tiers) can be charged in Galacticraft Energy Storage Module and Energy Storage Cluster and can power Galacticraft machines, and the other way around. Galacticraft power systems (Aluminium Wires, Energy Beams or Energy Storage Modules) can be used to power all IC2 machines, except for the Electric Kinetic Generator and the Electric Heat Generator.

There was an energy dupe (free energy creation) between IC2 and Galacticraft prior to Galacticraft version 410. Please update to version 411 or later if you are affected by this - servers should update.

Sealed versions of some IC2 cables can be made in Galacticraft - look up which ones in NEI.

Buildcraft

Full compatibility. For detailed Buildcraft compatibility notes see Buildcraft.

Sealed versions of some Buildcraft pipes can be made in Galacticraft - look up which ones in NEI. These are stable as of Galacticraft version 426, and also work with BuildcraftCompat.

Smart Moving

Galacticraft 3 is fully compatible with Smart Moving (requires Smart Render and Player API) as of GC3 version 3.0.12.426 (tested with SmartMoving-1.7.10-15.6, SmartRender-1.7.10-2.1 and PlayerAPI-1.7.10-1.4.) Galacticraft has been mostly compatible with Smart Moving since GC 3.0.3.201 but some issues remained, recently fixed in version 426.

For full compatibility with Galacticraft - to see the player oxygen tanks etc - you must install Render Player API with Smart Moving. (Tested with RenderPlayerAPI-1.7.10-1.4.)

Animated Player

Like other mods that change or affect the player model and its animations, Animated Player can break some Galacticraft animations (e.g. holding rocket, parachute descending etc). The problem can be fixed by installing Render Player API and Player API.

(Tested Animated Player 1.5.0 and Animation API 1.2.2: these are compatible with Galacticraft if you have Player API 1.4 and Render Player API 1.2 or later installed.)

RenderDecorator and VoxelPlayer

It's the same story for RenderDecorator and VoxelPlayer. Install Player API and Render Player API and things should be OK.

RenderPlayerAPIEnhancer

Galacticraft is compatible with RenderPlayerAPIEnhancer since GC version 426. Earlier GC versions could cause rare client-side crashes if a mob (for example Zombie Pigman, Zombie or Skeleton) spawned wearing special types of modded armor from another mod (for example Glowstone Armor from Mekanism).

EnviroMine

If EnviroMine's "food rot" feature is enabled, please be sure to be using Galacticraft version 3.0.6.249 or later. (With earlier GC versions combined with EnviroMine, there were crashes when rockets were placed on launch pads - it didn't look anything connected with EnviroMine, but it was.)

Sync

Galacticraft is fully compatible with Sync mod, since GC version 426. Prior Galacticraft versions could lose part of Galacticraft's functionality when changing planets after a player was cloned.

Ex Nihilo

Torches can be used to heat Ex Nihilo crucibles even in space environments, if there is oxygen so that the torch is burning. (This is as of Galacticraft version 411 and later.)

Mariculture

The recipe clash between GC canisters and Mariculture vats can be fixed by a setting in Galacticraft core config which allows an alternative recipe for canisters.

Mariculture disables other mods' smelting recipes for aluminum ore, so you won't be able to smelt Galacticraft Aluminum Ore at all, if Mariculture is installed.

If combining Mariculture with GregTech5, it's advisable to set Mariculture config:

Biome Top Block Replacements > Enable = false

(otherwise it can cause issues when Galacticraft is generating other planets). More details on this from Mariculture developer joshiejack.

GregTech

In 2016 some GregTech builds the power systems were not compatible with IC2 or any other mod, including Galacticraft. We understand from GregTech developer that there is compatibility in 2017 versions, please try updating to latest.

Galacticraft's feature allowing other mods oregen on planets will not work to generate GregTech ores on Galacticraft planets. It's because GregTech uses a non-standard, extra-complicated way of identifying ore blocks in the world. Fortunately there is a third-party plugin for GregTech, GalactiGreg by BloodAsp, which can fix that for you. People also give some tips there on Galacticraft sealer config settings when playing with GregTech.

Extra Utilities

If you find that the ExtraUtilities portals for the Deep Dark and the Last Millennium are not working, that can be fixed by installing PlayerAPI alongside Galacticraft.

ExtraUtilities also needs PlayerAPI for the Etheric Sword + Soul Fragment health restoration (when a Soul Fragment is right-clicked) to work properly.

Multiverse

Use Galacticraft 3 version 426 or later with Multiverse. In prior versions, to ensure the Galacticraft dimensions are loaded at server start so that Multiverse knows how to send players to the dimensions, you had to go into the Galacticraft/core.conf file and add the dimensions -28, -29, -30, one on each line, inside the "I:"Static Loaded Dimensions"" braces. Further reading

The above may also help to fix errors of this type: Could not pass event PlayerTeleportEvent to Multiverse-Core

Erebus

There is a biome ID overlap between Erebus and Galacticraft, both mods are trying to use biome IDs 102-105. This can cause weird issues with GC biomes sometimes generating in the Overworld, or occasionally crashes in Erebus (see here). To fix this, in Erebus config, change the biome IDs 102, 103, 104, 105. You can probably use 106, 107, 108, 110.

Alternatively, in recent Galacticraft versions you can change the Galacticraft biome base ID in configs. You would need to regenerate all your Galacticraft dimensions after changing this for it to take full effect (otherwise the space dimensions will be labelled as being Erebus biomes still).

Custom NPCs

(Small issue) There is a position clash with Custom NPCs 'Quests' buttons in the player inventory, but you can reach the Quests dialog by clicking on 'Factions' first, then 'Quests'. Link These issues are fixed in more recent versions of Custom NPCs. (With Galacticraft 4 make sure your Custom NPCs version is from May 2017 or later.)

Dynamic Lights

Make sure to use Galacticraft version 426 or higher with Dynamic Lights. (There was a problem in GC versions 411 through to 425.)

Dynamic Surroundings

Fancy Cloud Handling will break Galacticraft in all space dimensions - the look of the dimension will be off, maybe also the gravity will be wrong. You can disable Fancy Cloud Handling in the config of Dynamic Surroundings (dsurround.cfg).

Dynamic Surroundings, since version 1.10.2-3.4.5.3, supports Galacticraft dimensions. For Galacticraft 1.7.10 and 1.8.9, use the cfg files available here.

Non-fixable issues

These will need to be fixed by the authors of the other mods.

More Player Models

We cannot offer compatibility with this mod, as it uses an approach which is not really compatible with other mods. You may have improved results if you install Player API and Render Player API, try it and see.

More Player Models has been reported to be crashing with Galacticraft here

Too Much Time

This mod's dimension handling will cause crashes whenever you travel to a Galacticraft dimension, so basically Galacticraft is unplayable if you have Too Much Time installed.

Shaders Mod

Karyonix GLSL Shaders Mod is currently unsupported; the sky will not look good on Galacticraft planets or space environments. Best would be if that mod can auto-disable itself in Galacticraft dimensions.

Minor issues

Torched

(Small issue) The Rocket Propelled Torch (RPT) Launcher will not work correctly in Galacticraft's airless dimensions. The RPT Launcher will place lit torches, not unlit torches - and these lit torches will stay lit even without air. The RPT Launcher cannot be re-filled with torches while the player stays in an airless dimension.

Twilight Forest

(Small issue) A rare issue with the Twilight Forest Scepter item has been reported, causing blocks to be drawn darker than normal in Space Station dimensions. Link

DragonAPI (recent versions)

(Small issue) If this mod is present and Galacticraft is also installed, a player in Minecraft's third person view will be drawn solid like normal, even if the player is underwater (or in some other kind of liquid). Screenshots

Issues and bugs in other mods (and how to fix them!)

All of the issues described in the following section are caused by other mods. The latest versions of Galacticraft include workarounds to make it less likely that these type of problems will arise. With older versions of Galacticraft there may also be steps you can take to fix these issues yourself, see below.

The world xxxxxxxx (world) may have leaked: seen 25 times

This type of information message is sometimes seen in server logs. If the named world xxxxxxxx is a Galacticraft dimension - for example, the Moon - this does not mean there is an issue in Galacticraft. The log message is telling you where the issue is - which dimension it is in -- but not which mod caused the issue. Don't blame Galacticraft! Galacticraft provides the dimensions, but doesn't cause the issue. Obviously, if you have 50 mods installed and you place blocks from all of those mods in your Moon base, then it could be any of those mods causing the issue.

A 'world leak' is not a serious problem at all. It is a small memory leak, meaning that if you run a server for several hours, your Java base memory use, the minimum memory used by the game, will very slowly increase over that time - it will increase a little bit any time a player goes to the world which is 'leaking' and then leaves it again. The reason for a world leak is bad programming style by a mod author, very hard to track down, and most programmers do it every once in a while.

Players who are not mod developers or the admins of large public servers really do not need to worry about this.

'Already decorating!' crashes on the Moon (or other Galacticraft worlds)

These do not occur in Galacticraft 3 itself since around version 300 or later. If you see this, the cause is almost certainly another mod. Look through the crash report's stacktrace carefully and try to see which mods' code is mentioned lower down in the trace.

In outdated versions of Galacticraft prior to 297, the CofHCore 'Flat Bedrock' feature (which can be enabled in CofH configs) could cause this 'Already decorating!' crash, usually fixable by going into the CoFHWorld.cfg file and setting the number of layers of bedrock to 1. (In recent versions of CoFHCore the config file is CoFH/Core/Common.cfg.) Note: if playing on a server, this is a server-only fix.

(For info: CoFH replaces all blocks down there with bedrock before the chunk is fully generated. This causes problems if CoFHCore over-writes a block which has a TileEntity. That's a bug in CoFHCore - mods should not change blocks with TileEntities before the chunk and its neighbours are fully generated, because over-writing a block with a TileEntity causes a block update on the neighbours which can mean the neighbouring chunk in turn has to be generated, potentially producing an infinite worldgen loop. Galacticraft has included a special patch which works around this issue by delaying TileEntity creation if CoFHCore is active.)

Crash report with GCEntityClientPlayerMP

People sometimes think that a crash report containing a line like this: 'micdoodle8.mods.galacticraft.core.entities.player.GCEntityClientPlayerMP' somewhere in the middle is a Galacticraft bug. It isn't! OK, in 99% of cases it isn't. The crash is just passing through Galacticraft, the same way that it passes through all those bits of vanilla Minecraft code that you also see in crash reports. Further reading.

These types of crash reports can also be seen with GCEntityPlayerMP, GCPlayerBaseSP, and occasionally other GC entities. Quite often the crashes seem to be connected with other mods which did not register new potion effects (e.g. dizziness, radiation poisoning) correctly. Stuff like that. Not space stuff.

DragonAPI

If you're reading this section of this page, it's probably because you are still using DragonAPI 1.7.10 version 2 which is not the latest version. The issue here has been fixed in DragonAPI 1.7.10 version 3 and later, and players should update to that.

More info: in recent Galacticraft versions DragonAPI v2 will be detected during startup and you will be referred to this page. In earlier Galacticraft versions (prior to 3.0.6.234), the game would crash when you take a rocket, with this in the crash report:

java.lang.NoSuchMethodError: micdoodle8.mods.galacticraft.api.prefab.world.gen.WorldProviderSpace.getCelestialBody

The issue was because of DragonAPI v2 force-loading a piece of outdated Galacticraft code in advance of Galacticraft itself. As mentioned above, this has long since been fixed in DragonAPI v3, so if you're using v3 you should be fine. But if for some reason you have to use DragonAPI v2 (because of a modpack which has not updated), then you can fix the issue yourself by a manual edit of the DragonAPI.jar.

Steps:

  • Find the DragonAPI 1.7.10 V2.jar file in your .minecraft/mods folder
  • Open the .jar using any program which can create a Zip file (for example, 7Zip is free and open source)
  • Delete the folder micdoodle8

Note: if playing on a server, it will need to be fixed on both client and server.

For clients running OpenJDK

Several Linux distributions include OpenJDK for running Java, instead of the Java Runtime (JRE) from Sun / Oracle.

OpenJDK has a bug in its JPEG library. Galacticraft makes a very minor use of the standard JPEG library to save some map images to disk on the client - folder assets/GalacticraftMaps - so that you can look at them outside the game (similar to the images seen in a Display Screen).

At one time (prior to Galacticraft version 3.0.12.357) this OpenJDK bug could cause [startup issues on Linux servers]) but Galacticraft now works around this, disabling the JPEG library use if there are problems with it, and showing a message in logs linking to here.

In Galacticraft 4 and recent versions of Galacticraft 3, servers do not make use of the JPEG library at all. Player clients only use it for saving images to disk as explained above, it does not affect gameplay if it is not present.


Impt.png
Unless stated otherwise, all information contained on this wiki should be considered outdated and might not reflect in-game experiences