Installing and Migrating: Difference between revisions

From GT New Horizons
Content added Content deleted
VisualWikitext
(remove notice about dev builds needing to be upgraded from stable on a fresh mmc instance)
(add prism to java 8)
 
(119 intermediate revisions by 13 users not shown)
Line 1: Line 1:
{{ombox|type=speedy|text=<div style="text-align: center;">'''Read This Or Else!'''</div><div>This modpack updates regularly. Use the latest build marked ''stable''. Anything flagged BETA, RC (release candidate) or [[Nightly Build]] is a [[Dev Release Stability|work in progress]] that may have game-breaking bugs.}}
[[Category:Guides]]
This page discusses how to install the modpack using Technic or MultiMC, and how to migrate the modpack from one installation type to another in SP. See [[Server Setup]] for how to setup a server for MP.


{{Box-round|title=Lost? | Any of these computer terms drawing a blank? Not sure what the difference is between a JDK, JRE or Java SE?
= Installing =
* Check out the [[Modded Minecraft Basics#Lexicon|Lexicon]]}}
=== Technic ===
==Installing==
There are various possible setups with various launchers and Java versions. The most recommended setup is using Prism Launcher and Java 21.


Some baselines for all launchers:
# Download, install and start the Technic launcher
* GTNH requires a valid Minecraft account & Microsoft Login.
# Go to the Modpacks tab and enter "GT New Horizons" in the search box. Make sure the pack named "GT New Horizons" is selected in the results list.
* 5-7 GB of memory (RAM) is recommended for Single Player (SP).
# Optionally, click the Modpack settings link in the upper-right to select a specific version and/or the installation path. By default, the latest recommended release will be installed, but some servers may use other versions.
** Ensure there's still enough free RAM available for the operating system.
** Assign the total memory allocation for both minimum and maximum in the launcher.
** Allocating more than 8GB with Java8 will likely cause serious stuttering due to poor default garbage collection optimization.
* It's strongly encouraged to install the latest stable release -- currently 2.6.1.
* For multiplayer servers (MP), your GTNH client modpack needs to be of the same version as the server.

===MultiMC or Prism Launcher with Java 17-21===
At the moment, newer Java versions can only be used with MultiMC or Prism Launcher.
#Install [https://multimc.org/#Download MultiMC] or [https://prismlauncher.org/ Prism Launcher]. If you are on Windows 10 or 11, make sure you are not installing it in a OneDrive folder!
## Register your Minecraft account with the launcher. It must run in online mode at least once to authenticate.
# Java 21 can be downloaded for example [https://adoptium.net/temurin/ from Adoptium]. Go to "Other platforms and versions", pick the JRE that matches your computer's OS and architecture. Unpack and install it. If you don't get an installer in your download, check that you haven't grabbed a JDK by mistake.
## Typical Windows file path: <code>C:/Program Files/Eclipse Adoptium/jre-21.0.3.9-hotspot/bin/javaw.exe</code>
## Typical MacOS file path: <code>/Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home/bin/java</code>
#Download a MMC/Prism Java17-21 version of the pack from [http://downloads.gtnewhorizons.com/Multi_mc_downloads/ downloads]. Do not unzip. Drag it into the MultiMC/Prism window to create the instance.
# Under Settings > Java, make sure you are using a newly downloaded version of Java; Java 21 64-bit (or any 64bit version from 17.0.6 to 21). If not, you can use auto-detect or put in the path manually. If you don't want to change the global launcher setting, individual instances can also be assigned a specific Java version, arguments and memory allocation. Right-click the instance icon, choose Edit > Settings > Java.
# If you are using MultiMC you also need to add the additional Java arguments from [https://github.com/GTNewHorizons/lwjgl3ify/blob/1.5.7/README.MD#client here for 2.5.1 or older] or [https://github.com/GTNewHorizons/lwjgl3ify#client here for 2.6.0 or newer]. You only want the Java args from that page, nothing else. This step is not needed in Prism.

===MultiMC or Prism Launcher with Java 8===
#Install [https://multimc.org/#Download MultiMC] or [https://prismlauncher.org/ Prism Launcher]. If you are on Windows 10 or 11, make sure you are not installing it in a OneDrive folder!
#Download a MMC version of the pack from http://downloads.gtnewhorizons.com/Multi_mc_downloads/ and drag it into the MultiMC/Prism window to create the instance, or use the "Add Instance" button in the main window.
#Under settings - Java, make sure you are using a version of 64-bit Java 8.

===Technic===
# Install the [https://www.technicpack.net/download Technic] launcher,
# In the launcher, go to the Modpacks tab and enter "GT New Horizons" in the search box. Make sure the pack named "GT New Horizons" is selected in the results list.
# Optionally, click the Modpack settings link in the upper-right to select a specific version and the installation path. By default, the latest stable release will be installed, but some servers may need a different version.
# Click the Install button on the lower right to install the pack.
# Click the Install button on the lower right to install the pack.
# Before launching the game, you may need to adjust your Java settings. Go to the Launcher settings at the top right corner, and the Java tab of that dialog. At least 4 GB is recommended. Make sure you are using an up to date, 64-bit Java 8 (!) version.
# Go to the Launcher settings at the top-right corner, and the Java tab of that dialog. Make sure you are using an up to date, 64-bit Java 8.

# Click Play to start the game.
===Curseforge Launcher===
The Curseforge launcher is not recommended because:
*it usually is out-of-date,
*it constantly messes up recipes,
*its new license requirements on mods make things even worse.

Please do not use a Curseforge launcher for GTNH.

===Java Arguments for Java 8===
GTNH runs best with configured Java arguments for targeted garbage collection and memory usage. Optimal arguments will vary depending on hardware, launcher and build version. ''The best performance gains are by going to Java 17-21, not by tweaking Java 8.''


* [https://www.reddit.com/r/feedthebeast/comments/5jhuk9/modded_mc_and_memory_usage_a_history_with_a/ A History of Modded Minecraft Memory Usage]
=== MultiMC ===
* [https://github.com/brucethemoose/Minecraft-Performance-Flags-Benchmarks Modded Minecraft Performace Benchmarks]
GTNH can easily be installed on MultiMC by adding a new instance and importing the ZIP archive available from http://downloads.gtnewhorizons.com/Multi_mc_downloads/.
* [[Low End PCs]]
----For '''old dev builds only''' (like versions prior to '''2.0.8.3'''), you will need to prepare a vanilla instance and install Forge.
* First download MultiMC. It will be a simple zip file, so you will want to unpack it in your HD someplace - with new versions of Windows, your Documents folder may be backed up via OneDrive, so you might want to/not want to install there.
* Next, go to Add Instance and choose 1.7.10 in the Vanilla tab. Give the instance a meaningful name.
* Select your new instance and click Edit Instance. There click Install Forge in the Version tab. The required Forge version is 10.13.4.1614 (which is the latest and should be the top entry in the list).
* Now you need to get the modpack files. These are easiest to get from http://downloads.gtnewhorizons.com/ClientPacks. Make sure to download the correct version.
* In the zip archive you will find a <code>minecraft</code> folder, that contains all the important files. You will need to copy its contents to the <code>.minecraft</code> folder of your MMC instance. You can jump to the appropriate folder from within MMC by selecting the instance and clicking the <kbd>Minecraft Folder</kbd> button on the right.
* If you feel fancy, you can also grab the modpack logo <code>42x42Icon.png</code> from the zip file. Then go to MMC, right click your instance, choose Change icon and use the Add Icon button.
* If you are playing locally, backup the <code>journeymap</code>, <code>tcnode</code> tracker, and <code>save</code> directories.
* If you are playing remotely, you still need to backup the <code>journeymap</code> and <code>tcnode</code> tracker directories.


These optimizations are tailored for the Java 8 version of GT:NH. If playing on the Java 17-21 version of the modpack, no additional Java arguments for performance should be needed.
=== Curseforge Launcher ===
Not recommended at this time due to their new license requirements on mods. And the fact that it constantly messes up recipes and is generally out-of-date. Please choose a different option.


===Troubleshooting===
= Upgrading =
* If you are experiencing issues with fullscreen mode with Java 17-21, set a resolution in your launcher and check other settings in the config/lwjgl3ify.cfg config file.
=== Technic ===
* If you get a Windows Firewall window that pops up it is ok to click "Allow Access" for your launcher.
Recommended releases are pushed to Technic at a slower rate, once they have completed testing. Sometimes releases can be pushed to Technic for testing, to see those look in the Technic configuration window.


=== MultiMC ===
==Updating==
===The direct process===
For the client:
#Backup your GTNH instance to port settings and configs later. It is done by cloning the instance in the launcher.
##In ATLauncher, select Edit Instance > Clone Instance in the drop-down. Select the Open Folder button for a new instance.
##In MultiMC, select Copy Instance in the drop-down.
##In Prism, right-click on the instance icon, choose Copy
#Rename the new instance with the GT:NH version being upgraded to.
#Delete the folders <code>config</code> and <code>mods</code> from <code>Instances/instance_name/.minecraft/</code>. Also delete the folders <code>scripts</code> and <code>resources</code> if you have them and they contain anything. On newer versions they don't exist anymore or are empty.
#Replace the deleted <code>config</code> and <code>mods</code> folders with the ones from the downloaded archive. They are contained in a .minecraft folder after unpacking. If you are on Mac or Linux, you may have to show hidden files for your OS.
#If you are using Java 17-21, you also need to replace the folders <code>libraries</code> and <code>patches</code> and the file <code>mmc-pack.json</code> in <code>Instances/instance_name/</code>. Furthermore, if you are using Java 17-21 with MultiMC you might also need to update the required Java Arguments.


===The alternative approach===
# Backup your GTNH instance. In MultiMC, Right Click on the instance and select Copy Instance. With the backup, you retain access to settings and configs that are later needed on the new version, also to screenshots and keybinds.
Your alternative is to follow the instruction under installing above to set up a new instance. Then follow the migrating section below to copy your existing world to the new instance.
# Delete the <code>config</code>, <code>mods</code>, <code>resources</code> and <code>scripts</code> folders from <code>instances/%instance name%/.minecraft/</code>.
# Replace the deleted folders with the ones from the downloaded archive.
# Port over any customized config settings. Use your backup as a reference.
# The questbook should be updated automatically. If it was not updated, you can either use the default load block, go to cheat mode and do <code>/bq_admin default load</code> to load quest book changes, or do <code>bq_admin default load</code> on a server.


==Migrating to a Different Launcher==
For the server:
Follow the installation instructions for the new launcher, then set up a new instance. Ensure the launcher can run GTNH without issues. Then migrate the files listed below to import your old world. It is highly recommended to keep your old launcher and files around for a while as a backup.
# Download a new server version of GTNH with <code>wget</code>.
# Backup your server folder.
# Delete the <code>config</code>, <code>mods</code>, <code>resources</code> and <code>scripts</code> folders from your server folder.
# Replace the deleted folders with the ones from the downloaded archive.
# Port over any customized config settings. Use your backup as a reference.


===Files to Copy when Migrating or Backing Up===
= Migrating to a different installer =
#<code>/saves/</code>folder.
This guide will go over migrating your installation to a new launcher.
#<code>/journeymap/</code> folder.
#<code>/visualprospecting/</code> folder. Ore vein data for [[JourneyMap]].
#<code>/TCNodeTracker/</code>folder. [[Thaumcraft]] node data for JourneyMap.
#<code>localconfig.cfg</code> file. This keeps track of your local config changes.
#<code>options.txt</code>.
#<code>/serverutilities/</code> folder, if [[ServerUtilities]] is installed. This contains its configs and rank settings.
#<code>/schematics/</code> folder. If you use [[Schematica]], this is where your saved schematics are.
#<code>BotaniaVars.dat</code> - this [[NBT]] file holds your Lexica Botania bookmarks and other global stuff Botania tracks.
#<code>/resourcepacks/</code> or <code>/screenshots/</code> if you want to keep what you have there.
#Any custom mods you want to keep and data related to them. For example the <code>/local/</code> folder, if you use FTBUtilities.
#Your backups in the <code>/backups/</code> folder (not needed if you keep the old instance for a bit).


==Additional Resources==
=== Files to backup ===
* For compatible mods, see [[Additional Mods]],
* For texture packs, see [[Resource Packs]],
* For backups, see [[Backups and Recovery]] (already included for singleplayer),
* For server installation and updates, see [[Server Setup]].
* For nightly testing builds, see [[Nightly builds]].


{{Template:Navbar GTNH}}
# If playing in single-player, backup your <code>saves</code>folder.
[[Category:Guides]][[Category:Troubleshooting]]
# The <code>journeymap</code> folder - if you use a different map/waypoint tool find its data.
#The <code>visualprospecting</code> folder.
# The <code>TCNodeTracker</code>folder
# Any custom resources/resourcepacks you are using.
# <code>options.txt</code> (also <code>optionsof.txt</code> if you use optifine).
# Your <code>screenshots</code> folder, if you want to keep them
# Any custom (client-side or not) mods such as InGameInfoXML and its configuration file.
# Your backups in the <code>backups</code> folder (feel free to only grab 1 or 2 if you aren't deleting it)
# Any custom changes to the config files or script files
# Consider keeping the logs folder if you crash a lot

Latest revision as of 09:26, 1 July 2024


edit 

Lost?

Any of these computer terms drawing a blank? Not sure what the difference is between a JDK, JRE or Java SE?

Installing

There are various possible setups with various launchers and Java versions. The most recommended setup is using Prism Launcher and Java 21.

Some baselines for all launchers:

  • GTNH requires a valid Minecraft account & Microsoft Login.
  • 5-7 GB of memory (RAM) is recommended for Single Player (SP).
    • Ensure there's still enough free RAM available for the operating system.
    • Assign the total memory allocation for both minimum and maximum in the launcher.
    • Allocating more than 8GB with Java8 will likely cause serious stuttering due to poor default garbage collection optimization.
  • It's strongly encouraged to install the latest stable release -- currently 2.6.1.
  • For multiplayer servers (MP), your GTNH client modpack needs to be of the same version as the server.

MultiMC or Prism Launcher with Java 17-21

At the moment, newer Java versions can only be used with MultiMC or Prism Launcher.

  1. Install MultiMC or Prism Launcher. If you are on Windows 10 or 11, make sure you are not installing it in a OneDrive folder!
    1. Register your Minecraft account with the launcher. It must run in online mode at least once to authenticate.
  2. Java 21 can be downloaded for example from Adoptium. Go to "Other platforms and versions", pick the JRE that matches your computer's OS and architecture. Unpack and install it. If you don't get an installer in your download, check that you haven't grabbed a JDK by mistake.
    1. Typical Windows file path: C:/Program Files/Eclipse Adoptium/jre-21.0.3.9-hotspot/bin/javaw.exe
    2. Typical MacOS file path: /Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home/bin/java
  3. Download a MMC/Prism Java17-21 version of the pack from downloads. Do not unzip. Drag it into the MultiMC/Prism window to create the instance.
  4. Under Settings > Java, make sure you are using a newly downloaded version of Java; Java 21 64-bit (or any 64bit version from 17.0.6 to 21). If not, you can use auto-detect or put in the path manually. If you don't want to change the global launcher setting, individual instances can also be assigned a specific Java version, arguments and memory allocation. Right-click the instance icon, choose Edit > Settings > Java.
  5. If you are using MultiMC you also need to add the additional Java arguments from here for 2.5.1 or older or here for 2.6.0 or newer. You only want the Java args from that page, nothing else. This step is not needed in Prism.

MultiMC or Prism Launcher with Java 8

  1. Install MultiMC or Prism Launcher. If you are on Windows 10 or 11, make sure you are not installing it in a OneDrive folder!
  2. Download a MMC version of the pack from http://downloads.gtnewhorizons.com/Multi_mc_downloads/ and drag it into the MultiMC/Prism window to create the instance, or use the "Add Instance" button in the main window.
  3. Under settings - Java, make sure you are using a version of 64-bit Java 8.

Technic

  1. Install the Technic launcher,
  2. In the launcher, go to the Modpacks tab and enter "GT New Horizons" in the search box. Make sure the pack named "GT New Horizons" is selected in the results list.
  3. Optionally, click the Modpack settings link in the upper-right to select a specific version and the installation path. By default, the latest stable release will be installed, but some servers may need a different version.
  4. Click the Install button on the lower right to install the pack.
  5. Go to the Launcher settings at the top-right corner, and the Java tab of that dialog. Make sure you are using an up to date, 64-bit Java 8.

Curseforge Launcher

The Curseforge launcher is not recommended because:

  • it usually is out-of-date,
  • it constantly messes up recipes,
  • its new license requirements on mods make things even worse.

Please do not use a Curseforge launcher for GTNH.

Java Arguments for Java 8

GTNH runs best with configured Java arguments for targeted garbage collection and memory usage. Optimal arguments will vary depending on hardware, launcher and build version. The best performance gains are by going to Java 17-21, not by tweaking Java 8.

These optimizations are tailored for the Java 8 version of GT:NH. If playing on the Java 17-21 version of the modpack, no additional Java arguments for performance should be needed.

Troubleshooting

  • If you are experiencing issues with fullscreen mode with Java 17-21, set a resolution in your launcher and check other settings in the config/lwjgl3ify.cfg config file.
  • If you get a Windows Firewall window that pops up it is ok to click "Allow Access" for your launcher.

Updating

The direct process

  1. Backup your GTNH instance to port settings and configs later. It is done by cloning the instance in the launcher.
    1. In ATLauncher, select Edit Instance > Clone Instance in the drop-down. Select the Open Folder button for a new instance.
    2. In MultiMC, select Copy Instance in the drop-down.
    3. In Prism, right-click on the instance icon, choose Copy
  2. Rename the new instance with the GT:NH version being upgraded to.
  3. Delete the folders config and mods from Instances/instance_name/.minecraft/. Also delete the folders scripts and resources if you have them and they contain anything. On newer versions they don't exist anymore or are empty.
  4. Replace the deleted config and mods folders with the ones from the downloaded archive. They are contained in a .minecraft folder after unpacking. If you are on Mac or Linux, you may have to show hidden files for your OS.
  5. If you are using Java 17-21, you also need to replace the folders libraries and patches and the file mmc-pack.json in Instances/instance_name/. Furthermore, if you are using Java 17-21 with MultiMC you might also need to update the required Java Arguments.

The alternative approach

Your alternative is to follow the instruction under installing above to set up a new instance. Then follow the migrating section below to copy your existing world to the new instance.

Migrating to a Different Launcher

Follow the installation instructions for the new launcher, then set up a new instance. Ensure the launcher can run GTNH without issues. Then migrate the files listed below to import your old world. It is highly recommended to keep your old launcher and files around for a while as a backup.

Files to Copy when Migrating or Backing Up

  1. /saves/folder.
  2. /journeymap/ folder.
  3. /visualprospecting/ folder. Ore vein data for JourneyMap.
  4. /TCNodeTracker/folder. Thaumcraft node data for JourneyMap.
  5. localconfig.cfg file. This keeps track of your local config changes.
  6. options.txt.
  7. /serverutilities/ folder, if ServerUtilities is installed. This contains its configs and rank settings.
  8. /schematics/ folder. If you use Schematica, this is where your saved schematics are.
  9. BotaniaVars.dat - this NBT file holds your Lexica Botania bookmarks and other global stuff Botania tracks.
  10. /resourcepacks/ or /screenshots/ if you want to keep what you have there.
  11. Any custom mods you want to keep and data related to them. For example the /local/ folder, if you use FTBUtilities.
  12. Your backups in the /backups/ folder (not needed if you keep the old instance for a bit).

Additional Resources

Retrieved from "https://wiki.gtnewhorizons.com/wiki/Installing_and_Migrating?oldid=10932"