Tutorials/Upgrading to Mekanism v8: Difference between revisions

(minor note about nonconverting items in inventory)
m (Changed "Logistics Pipes" to "Logistical Transporters" to avoid confusion with the mod Logistics Pipes)
 
(6 intermediate revisions by one other user not shown)
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.1.0'''. As of this writing, Mekanism 8.1.0.215 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.
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 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]]
** In-world Logistical Transporters ''(only affects placed pipes, not pipes in chests or your inventory)''
** [[Pressurized Tube]]
** In-world Pressurized Tubes ''(only affects placed tubes, not tubes in chests or your inventory)''
** [[Universal_Cable|Universal Cable]]
** Some machines may lose their customized input/output confiuration
*'''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.
**Remove all in-world (placed) Logistical Transporters and Pressurized Tubes. Pipes and Tubes in your inventory will get converted to Basic-level items in the new tiered system. '''But any Pipes or Tubes that are in-world will get removed!''' To help you remember what gets connected where, use signs or replace the Pipes and Tubes with another block, like maybe two different colors of wool.
**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 and 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, disable the server's old Mekanism and config files by renaming them.
**Check for "SEVERE" or "conflict" errors in the Forge Log.
**Copy your new Mekanism .jar files and your new configuration from your client/local PC to your server.
**Start up your server.
**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
**Replace your Logistical Transporters and Pressurized Tubes.
**Replace all Electrolytic Separators<br/>
**Check the connections to Mekanism machines.
*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.
**Replace any fluids that you temporarily moved.<br/>
*'''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 [[flamethrower|Flame Thrower]] for yourself and burn something!


{{Mekanism}}
{{Mekanism}}


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

Latest revision as of 02:24, 28 May 2016

This article is a brief guide to upgrading an existing Mekanism 7 world from 7.1.2 to 8.1.0. As of this writing, Mekanism 8.1.0.215 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?

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 8 world is back online.

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

  • Items / Machines :
    • Free Runners
    • In-world Logistical Transporters (only affects placed pipes, not pipes in chests or your inventory)
    • In-world Pressurized Tubes (only affects placed tubes, not tubes in chests or your inventory)
    • 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.
    • Remove all in-world (placed) Logistical Transporters and Pressurized Tubes. Pipes and Tubes in your inventory will get converted to Basic-level items in the new tiered system. But any Pipes or Tubes that are in-world will get removed! To help you remember what gets connected where, use signs or replace the Pipes and Tubes with another block, like maybe two different colors of wool.
    • Take stock of your Free Runners and 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, disable the server's old Mekanism and config files by renaming them.
    • Copy your new Mekanism .jar files and your new configuration from your client/local PC to your server.
    • 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.
    • Replace your Logistical Transporters and Pressurized Tubes.
    • 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