Installing and Migrating: Difference between revisions
Content deleted Content added
m →MultiMC or Prism Launcher with Java 9-19: fullscreen mode with java9 |
use a more stable link for java args, they changed again in dev :( |
||
(82 intermediate revisions by 12 users not shown) | |||
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.}}
{{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?
* 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:
* 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.
#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/blob/2.0.0/README.MD#client here for 2.6.0 or 2.6.1] under Multimc setup. 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.
# 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===
Line 35 ⟶ 46:
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]
Line 42 ⟶ 53:
* [[Low End PCs]]
===
* 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.
===The alternative approach===
==Migrating to a
===Files to
#<code>/saves/</code>folder.
#<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==
* 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}}
[[Category:Guides]][[Category:Troubleshooting]]
|