Installing and Migrating: Difference between revisions

From GT New Horizons
Content added Content deleted
VisualWikitext
m (→‎Technic: removed double 'the')
(add prism to java 8)
 
(104 intermediate revisions by 12 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 shows how to install, update, or migrate a GTNH client installation.


{{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?
For instructions about how to install or update servers, please see [[Server Setup]].
* Check out the [[Modded Minecraft Basics#Lexicon|Lexicon]]}}
==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:
= Installing =
* GTNH requires a valid Minecraft account & Microsoft Login.
=== Technic ===
* 5-7 GB of memory (RAM) is recommended for Single Player (SP).
# Install the Technic launcher,
** 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.
# 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.
# 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.
# Go to the Launcher settings at the top-right corner, and the Java tab of that dialog. At least 4 GB of memory is recommended for GTNH. 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.


=== MultiMC ===
===Curseforge Launcher===
==== Recent builds ====
# Intall MultiMC,
# Add a new instance in MultiMC. Select the From Zip option on the left.
# Import the ZIP archive of GTNH from http://downloads.gtnewhorizons.com/Multi_mc_downloads/

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


Please do not use a Curseforge launcher for GTNH.
Please do not use a Curseforge launcher for GTNH.


===Java Arguments for Java 8===
= Upgrading =
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.''
=== Technic ===

The releases are pushed to Technic at a slower rate, once they have completed testing. Sometimes a release can be pushed to Technic for testing. To see them, please refer to the Technic configuration window.
* [https://www.reddit.com/r/feedthebeast/comments/5jhuk9/modded_mc_and_memory_usage_a_history_with_a/ A History of Modded Minecraft Memory Usage]
* [https://github.com/brucethemoose/Minecraft-Performance-Flags-Benchmarks Modded Minecraft Performace Benchmarks]
* [[Low End PCs]]

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===
#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.


=== ATLauncher ===
===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.
# Backup your GTNH instance. In ATLauncher, click on the Edit Instance drop-down and select Clone Instance. Click the Open Folder button for the new instance.
# Delete the <code>config</code>, <code>mods</code>, <code>scripts</code> and <code>resources</code> (if it exist) folders from <code>Java/instances/instance_name/</code>.
# Replace the deleted 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.
# 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==
=== MultiMC ===
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.
# 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.
# Delete the <code>config</code>, <code>mods</code>, <code>scripts</code> and <code>resources</code> (if it exist) folders from <code>instances/instance_name/.minecraft/</code>.
# Replace the deleted 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.
# 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.


===Files to Copy when Migrating or Backing Up===
= Migrating to a different installer =
#<code>/saves/</code>folder.
This part describes how to migrate the 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"