Tutorials/Upgrading to Mekanism v8: Difference between revisions

(minor note about nonconverting items in inventory)
(updated from 5>>6, to 7>>8)
Line 1: Line 1:
This article is a brief guide to '''upgrade from [[Mekanism]] 5.6 to 6.0'''.
This article is a brief guide to '''upgrading an existing [[Mekanism]] 7 world from 7.1.to 8.0.2'''. As of this writing, Mekanism 8.0.2.207 is the latest release, but this process should apply to the current "latest release" as well.


Mekanism 6.0 offers some great new stuff and amazing optimizations, making it a bigger, better mod for your server modpack! But with all those amazing changes come a few issues that make the conversion from 5.6 to 6.0 a little bit of a chore. '''But it isn't too bad!''' Follow these instructions and you will be Mekanism 6'n it in no time. This is not a comprehensive administrator's guide. It assumes that you are already familiar with typical modded-Minecraft tasks like fixing ID conflicts, backing up worlds, and keeping multiple Minecraft profiles. Upgrading to Mekanism 6 is not complicated, but there is a bit of a learning curve to modded Minecraft. If you're already feeling uncomfortable, you may ask for help on the Mekanism IRC. (#mekanism on esper.net)
NOTE: This is not a comprehensive administrator's guide. It assumes that you are already familiar with typical modded-Minecraft tasks like backing up worlds and keeping multiple Minecraft profiles. Upgrading to Mekanism 8 is not complicated, but there are a few steps you will want to take before updating your existing Mek 7 world. If you have any problems during this process, feel free to stop by the Mekanism IRC. (#mekanism on esper.net)
----
----
== Will all my data be saved? ==
== Will all my data be saved? ==
Most things will be saved, but because of some internal changes in Mekanism, '''you will lose items'''. There is currently no way around this. But don't panic! You will later replace these with some creative-mode magick after your new Mekanism 6 world is back online.
MMost things will be saved, but because of some internal changes in Mekanism, you will lose items. There is currently no way around this. But don't panic! You will later replace these with some creative-mode magick after your new Mekanism 8 world is back online.


Here is a quick list of the items that will '''NOT''' migrate to version 6:
Here is a quick list of the items that will '''NOT''' migrate to version 8:
*'''Transmitters:'''
*'''Items / Machines :'''
** [[Logistical Transporter]]
** [[Free Runners]]
** [[Mechanical Pipe]]
** Contents of the [[Dynamic Tank]] will be lost
** [[Pressurized Tube]]
** Some machines may lose their customized input/output confiuration
** [[Universal_Cable|Universal Cable]]
*'''Machines:'''
** [[Electrolytic Separator]]
*'''Ores:'''
*'''Ores:'''
** All clumps of: copper, gold, iron, lead, obsidian, osmium, silver, tin
**Dusts: Copper, Diamond, Lead, Silver, Steel, Sulfur, Tin
** All dirty dusts of: copper, gold, iron, lead, obsidian, osmium, silver, tin
**Dirty Dusts: Lead, Obsidian
** All dusts of Mekanism*: copper, diamond, gold, iron, lead, obsidian, osmium, silver, steel, tin
**Clump: Lead, Obsidian
** All ingots of Mekanism*: bronze, copper, glowstone, obsidian, osmium, steel, tin
**Shard: Lead, Obsidian
**Crystal: Lead, Obsidian
**Refined Dust: Obsidian


*NOTE: This only applies to the Mekanism version of these items. All other mods' versions of these items will remain. If you have questions about which version you're looking at, my advice is to either 1) use WAILA or 2) use NEI to match IDs with the mod's configuration file. If at all possible, use option 1.
*NOTE: This only applies to the Mekanism version of these items. All other mods' versions of these items will remain. If you have questions about which version you're looking at, my advice is to use WAILA.  
----
----
== Steps ==
== Steps ==
*'''(1) An ounce of caution:'''
*'''(1) An ounce of caution:'''
**Back up your world. Storage is cheap, your data is invaluable. Just do it, you will be glad you did.
**Back up your world. Just do it, you will be glad you did.
**Backup your Mekansim.cfg file. Make a copy and name it something like "Mekanism-PREVIOUS.cfg" or something obvious.
**Backup your Mekansim.cfg file. Make a copy and name it something like "Mekanism-PREVIOUS.cfg" or something obvious.


*'''(2) In-Game Preparation:'''
*'''(2) In-Game Preparation:'''
**Remove any Electrolytic Separators. Replace the block with something cheap and easy to spot, like magenta wool. If you live in a magenta wool base, use lime green. Also remove any Separators from storage and your inventory. They will be dangerous in the updated world.
**Since so many "mid-process" ores are affected, clear your ore processing systems. Stop the ore inputs and let your processing lines finish.
**Expose hidden pipes and cables. Use other blocks to mark the routes of extra twisty transmitters. Or don't mark anything, and use this as an opportunity to clean up that rat's nest in the basement.
**Move the contents of dynamic tanks. Tanks will be empty after the conversion. Portable tanks are OK to use, also you can use the Plenisher to make an in-game lake or make use of another mod's storage.
**Take stock of your inventory of "stuff you will lose" ''(consult the list above'').These items will NOT convert, no matter how you prepare. But don't panic! You will creative-mode them back to yourself after the migration. To be safe, you might want to just dispose of them now, rather than risk a corrupted world later.
**Take stock of your Free Runners the ores mentioned above. These items will NOT convert, no matter how you prepare. But don't panic! You will creative-mode them back to yourself after the migration. To be safe, you might want to just dispose of them now, rather than risk a corrupted world later.


*'''(3) Mekanism update:'''
*'''(3) Mekanism update:'''
**Download the latest version of the [http://aidancbrady.com/mekanism/download/ Mekanism mods]. Do not download the MDK -- that is for mod developers.
**Download the latest version of the Mekanism mods. Do not download the MDK -- that is for mod developers.
**Place the new Mek mods in your mods folder
**Place the new Mek mods in your mods folder
**Disable the previous versions of the Mekansim mods by changing the .jar file to a .jarX file.
**Disable the previous versions of the Mekansim mods by changing the .jar file to a .jarX file.
**Start Minecraft so that a new config file is generated, then quit. DO NOT ENTER YOUR SERVER WORLD.
**Start Minecraft so that a new config file is generated, then quit. DO NOT ENTER YOUR SERVER WORLD.


*'''(4) Resolve Item ID conflicts:'''
*'''(4) Update the new Mekanism.cfg:'''
**Going line by line through the '''Block {''' and '''Item {''' sections of your OLD mekanism.cfg, make sure that all the blocks and items in the '''NEW''' Mek match what you had in the '''OLD''' Mekanism. If the IDs do not match, '''change the NEW to match the OLD'''.
**If you had made changes to your old Mekanism configuration (power usage, power standard, etc) now is the time to replace your customizations.
**Looking through the NEW mekanism.cfg, make sure that the IDs for the new items and blocks are not duplicated.<small>
**Even if you didn't make any changes, now is a good time to check out what's in there! Mekanism 8 is highly customizable.
***Here are the new blocks:
****BasicBlock2
****CardboardBox
***Here are the new items:
****ArmoredJetpack
****Balloon
****BrineBucket
****Crystal
****FreeRunners
****GasMask
****MultipartTransmitter
****Salt
****Sawdust
****ScubaTank
****Shard</small>


*'''(5) Client-side test world'''
*'''(5) Client-side test world'''
**Using your updated configuration, start up a new creative-mode test world LOCALLY. Don't start up your server world just yet.
**Using your updated configuration, start up a new creative-mode test world LOCALLY.
**After it loads, search through your Forge Log files for the keywords "SEVERE" and "conflict". Some "severe" errors are OK. Resolve any ID conflicts.
**Don't start up your server world just yet. Check for "SEVERE" or "ERROR" errors in the Forge Log. Some errors are OK but you should not see java errors or missing classes.
**If there were errors, fix and restart the world until everything loads clean.<br/>
**If there were errors, fix and restart the world until everything loads clean.
'''Missing cables?''' If everything seems to load OK but you have no Mek cables, check the "transmitter" item for a conflict.
**Once you have successfully loaded a new test world, confirm that the new content is in-game. If not, check which version of Mekanism you are using<br/>
Once you have successfully loaded a new test world, confirm that the new content is in-game. If not, check which version of Mekanism you are using.
'''A note about APIs.''' An API is what allows different mods to talk to each other and use each other's stuff. There were several changes in the Mekanism8 API. Other mods might still be looking for the "old style" Mekanism API, and when they don't find it, they will likely crash. This is not a Mekanism problem. The author of the mod needs to update to the new Mekanism API, then everything will start working again.


*''' (6) Server-side world'''
*''' (6) Server-side world'''
**Now that the client-side testing is done, start up your server.
**Now that the client-side testing is done, start up your server.
**Check for "SEVERE" or "conflict" errors in the Forge Log.
**Check for "SEVERE" or "ERROR" errors in the Forge Log.
**Repair & restart as necessary.
**Repair & restart as necessary.
**If everything checks out, then join the server!
**If everything checks out, then join the server!


*''' (7) Post-update'''
*''' (7) Post-update'''
**Using your list of items you knew you'd lose, replace your lost dusts, ingots, etc.
**Using your list of items you knew you'd lose, replace your lost ores and Free Runners, as needed.
**Replace all Universal Cables and other transmitters in the exposed channels
**Check the connections to Mekanism machines.
**Replace all Electrolytic Separators<br/>
**Replace any fluids that you temporarily moved.<br/>
*NOTE: If you see any magenta & black boxes, these are Electrolytic Separators that did not convert. DO NOT BREAK THEM! Doing so will crash your server. The easiest method to remove these blocks is to break it with a ComputerCraft turtle or other blockbreaker. A mapmaking program like MCEdit can also handle the chore. Otherwise, you will need to revert back to Mek 5, break the block, then re-load Mekanism 6.
*'''WARNING''': If you see any magenta & black boxes, these are items that did not convert. Dispose of these IMMEDIATELY in lava or some other method that takes them out of the world.


== Have fun! ==
== Have fun! ==
*Make yourself a new jetpack and some freerunners, then fly out to the desert and set up an awesome [[Salination Plant]].
*You've completed the update! Now go make a new [[Flame Thrower]] for yourself and burn something!


{{Mekanism}}
{{Mekanism}}


[[Category:Tutorials]]
[[Category:Tutorials]]

Revision as of 01:19, 31 March 2015

This article is a brief guide to upgrading an existing Mekanism 7 world from 7.1.2 to 8.0.2. As of this writing, Mekanism 8.0.2.207 is the latest release, but this process should apply to the current "latest release" as well.

NOTE: This is not a comprehensive administrator's guide. It assumes that you are already familiar with typical modded-Minecraft tasks like backing up worlds and keeping multiple Minecraft profiles. Upgrading to Mekanism 8 is not complicated, but there are a few steps you will want to take before updating your existing Mek 7 world. If you have any problems during this process, feel free to stop by the Mekanism IRC. (#mekanism on esper.net)


Will all my data be saved?

MMost things will be saved, but because of some internal changes in Mekanism, you will lose items. There is currently no way around this. But don't panic! You will later replace these with some creative-mode magick after your new Mekanism 8 world is back online.

Here is a quick list of the items that will NOT migrate to version 8:

  • Items / Machines :
    • Free Runners
    • Contents of the Dynamic Tank will be lost
    • Some machines may lose their customized input/output confiuration
  • Ores:
    • Dusts: Copper, Diamond, Lead, Silver, Steel, Sulfur, Tin
    • Dirty Dusts: Lead, Obsidian
    • Clump: Lead, Obsidian
    • Shard: Lead, Obsidian
    • Crystal: Lead, Obsidian
    • Refined Dust: Obsidian
  • NOTE: This only applies to the Mekanism version of these items. All other mods' versions of these items will remain. If you have questions about which version you're looking at, my advice is to use WAILA.

Steps

  • (1) An ounce of caution:
    • Back up your world. Just do it, you will be glad you did.
    • Backup your Mekansim.cfg file. Make a copy and name it something like "Mekanism-PREVIOUS.cfg" or something obvious.
  • (2) In-Game Preparation:
    • Since so many "mid-process" ores are affected, clear your ore processing systems. Stop the ore inputs and let your processing lines finish.
    • Move the contents of dynamic tanks. Tanks will be empty after the conversion. Portable tanks are OK to use, also you can use the Plenisher to make an in-game lake or make use of another mod's storage.
    • Take stock of your Free Runners the ores mentioned above. These items will NOT convert, no matter how you prepare. But don't panic! You will creative-mode them back to yourself after the migration. To be safe, you might want to just dispose of them now, rather than risk a corrupted world later.
  • (3) Mekanism update:
    • Download the latest version of the Mekanism mods. Do not download the MDK -- that is for mod developers.
    • Place the new Mek mods in your mods folder
    • Disable the previous versions of the Mekansim mods by changing the .jar file to a .jarX file.
    • Start Minecraft so that a new config file is generated, then quit. DO NOT ENTER YOUR SERVER WORLD.
  • (4) Update the new Mekanism.cfg:
    • If you had made changes to your old Mekanism configuration (power usage, power standard, etc) now is the time to replace your customizations.
    • Even if you didn't make any changes, now is a good time to check out what's in there! Mekanism 8 is highly customizable.
  • (5) Client-side test world
    • Using your updated configuration, start up a new creative-mode test world LOCALLY.
    • Don't start up your server world just yet. Check for "SEVERE" or "ERROR" errors in the Forge Log. Some errors are OK but you should not see java errors or missing classes.
    • If there were errors, fix and restart the world until everything loads clean.
    • Once you have successfully loaded a new test world, confirm that the new content is in-game. If not, check which version of Mekanism you are using

A note about APIs. An API is what allows different mods to talk to each other and use each other's stuff. There were several changes in the Mekanism8 API. Other mods might still be looking for the "old style" Mekanism API, and when they don't find it, they will likely crash. This is not a Mekanism problem. The author of the mod needs to update to the new Mekanism API, then everything will start working again.

  • (6) Server-side world
    • Now that the client-side testing is done, start up your server.
    • Check for "SEVERE" or "ERROR" errors in the Forge Log.
    • Repair & restart as necessary.
    • If everything checks out, then join the server!
  • (7) Post-update
    • Using your list of items you knew you'd lose, replace your lost ores and Free Runners, as needed.
    • Check the connections to Mekanism machines.
    • Replace any fluids that you temporarily moved.
  • WARNING: If you see any magenta & black boxes, these are items that did not convert. Dispose of these IMMEDIATELY in lava or some other method that takes them out of the world.

Have fun!

  • You've completed the update! Now go make a new Flame Thrower for yourself and burn something!
Cookies help us deliver our services. By using our services, you agree to our use of cookies.

Need wiki hosting?

Do you need a wiki for your Minecraft mod/gaming wiki? We'll host it for free! Contact us.

Other wikis

Indie-game wikis
Powered by Indie Wikis