How to use Aristois with Fabric Modpacks

This page is specifically about installing Aristois with Fabric modpacks. For Forge modpacks, please read here.

Fabric is supported from 1.14 to 1.19.2. By default, Aristois runs as a Fabric mod on top of EMC. Aristois also slightly modifies the fabric loader that it runs on. Because of this, it's not recommended to run Aristois directly with Fabric loader (but using it's own installation).

When running a Fabric modpack, instead of adding Aristois to the modpack, you should add the mods to Aristois. This will prevent any issues with Aristois, and also allow the mods to work as normal. The official launcher or MultiMC are recommended for this, because third-party launchers are usually more complex in regards of Fabric loader (or completely prevent Aristois from working).

Installing to the Vanilla Launcher


Short Instructions

1. Download the modpack/mods that you wish to play with.
2. Download and run the Aristois installer. Select your version and leave the default options.
3. Run Aristois once, then close it.
4. Place the mods in .minecraft\libraries\me\deftware\EMC-F-v2\latest-(mc version) and then run the Aristois profile.


Since Aristois runs Fabric by default, it's much simpler and will cause less issues to place all of your mods inside of the Aristois instance.

First, download the modpack or mods that you wish to play with. If you already have them installed on a different launcher, you can simply locate the mods folder in the launcher directory.

Then, grab the Aristois installer from the download page. Run the installer using Java. If you'd like, you can use the manual ZIP files to install Aristois instead of the .jar installer.



After the installer is open, select the version that matches your modpack. On the next page, leave the default options (Vanilla Launcher and default directory path). Then finish installing.



After Aristois is installed, open the launcher and run the Aristois profile one time (to generate libraries), then close the game. It's important that the game and launcher are both closed before the next step.

Open the %appdata% folder and locate your .minecraft folder. Place your fabric mods in .minecraft\libraries\me\deftware\EMC-F-v2\latest-(mc version). This is the fabric mod directory for Aristois.



After placing your mods in the Aristois mods folder, simply start the Aristois profile, and your modpack will be ran with Aristois.



Installing to MultiMC


Short Instructions

1. Create a new instance. Do not install Fabric to it.
2. Run the Aristois installer. Select "MultiMC".
3. Change the directory to your MultiMC root folder. For example: C:\Users\X\Desktop\MultiMC\
4. Add your mods to \MultiMC\libraries\me\deftware\EMC-f-v2\latest-(mc version)\ and then launch the instance.


Before installing Aristois to MultiMC, create an instance for Aristois to be installed to. Name it something easily recognisable.

It's important that you do not install Fabric to the instance itself, because this will overwrite Aristois and prevent it from loading (and most likely crash the game). Aristois will install Fabric on it's own, so it's not necessary.



After creating the instance, download and run the Aristois installer. Select your Minecraft version, and then select "MultiMC".

Change the directory to your MultiMC root (main) folder. For example, C:\Users\X\Desktop\MultiMC\. After continuing, you will see a list of instances to select from. Choose the instance that you created for Aristois and finish installing.



After installing, place your Fabric mods in \MultiMC\libraries\me\deftware\EMC-F-v2\latest-(mc version)\ and then run the instance.





Other Launchers


Detailed instructions required for this method!

1. Download and install the modpack on your selected launcher.
2. Download necessary files (see detailed).
3. Place the downloaded files in the appropriate folders.
4. Run your modpack via the launcher.


Before installing Aristois, you need to have the modpack already installed on your selected launcher.

To install Aristois to a different launcher with Fabric, the installer will not be used. Instead you must download the files manually and place them where they need to go. This example shows the installation process with CurseForge Launcher, but these instructions apply for any third-party launcher.



After your modpack is set up, you will need to download 2 files. The EMC jar and the Aristois jar. The EMC jar is the file placed in the mods, while the Aristois jar is the libraries that will be loaded by EMC. You must download these files using the following links. Please note that you must edit the Aristois build number and Minecraft version in the URLs.

  • EMC jar - https://gitlab.com/EMC-Framework/maven/raw/master/me/deftware/EMC-F-v2/latest-(MC VERSION)/EMC-F-v2-latest-(MC VERSION).jar
  • Aristois jar - https://maven.aristois.net/me/deftware/aristois/(BUILD #)/aristois-(BUILD #).jar - You can check the current Build # here.



After downloading these files, you'll need to place them in your modpack files. The EMC jar goes in the modpack's mods folder, this is where all of the other Fabric mods are. The Aristois jar can be more difficult to find where to place.

First, drag the EMC.jar into your modpack's mods folders. Example location: C:\Users\X\curseforge\minecraft\Instances\Better MC [FABRIC] 1.19.2\mods\.
What I would recommend doing next is to launch the modpack. This will create an empty folder at \libraries\EMC\(mc version)\ where the Aristois.jar should go. This folder should be located within the instance.



After adding both of these, Aristois is added to your modpack. To remove it, simply delete the EMC.jar from the mods folder. Please keep in mind that most Modpacks have conflictions with Aristois. Read below to see conflicting mods!



Troubleshooting

Crashing

Although less common on Fabric, some mods can conflict with Aristois. While most will work just fine, some will cause crashes or other issues in-game. We typically do not fix these types of conflicts. You can always remove the mod that is causing trouble, however if you play on Multiplayer servers this may prevent you from being able to join modded servers.

These are some mods that are known to cause issues with Aristois (Fabric). This is not a definite list, as there will always be more conflictions:

  • BYG (Oh the biomes you'll go)
  • Origins
  • CustomSplashScreen
  • SmoothBoot
  • Dashloader
  • Lithium (1.19.x)
  • Haema

If you have any of these mods, try removing them and see if you still crash. If you do, please join our Guilded for further support. If you'd like, you can also try to find the conflict by removing a chunk of mods at a time until it loads correctly. Gladly report any new conflicts to us so we can add it to the list.

Fabric Error

It's also possible to get a Fabric crash. Typically the Fabric window will explain what the issue is. Most of the time, it's caused by a missing dependency, an outdated mod, or an outdated Fabric loader. We try to keep the Fabric loader updated as much as possible, so usually an outdated loader is caused by old libraries. To fix, simply delete me and net from the libraries folder.

Freezing

If you notice that your game has frozen while loading, it's possible that the game does not have enough RAM allocated. Depending on the size of the modpack, you may need to allocate several more gigs of space to the game. The default value is 2G.

Stop the game and then go to the installations tab in the launcher. Edit the Aristois instance. Press "More options" to view the JVM settings. Before increasing the amount, make sure you know how much RAM your PC has. Never allocate more than half your RAM to the game.



To change the amount, replace 2G with a new number, such as 4G. Increase the amount by 1G or 2G if your system can allow it. You should not over-allocate either, more RAM does not equal better. Save and try launching again.

If it still freezes, check for mod conflicts. Remove all mods. If it works, try the mods individually to figure out which mod is causing the issue.

If it still is loading slowly, try following this Forum post. It will reinstall the libraries and fix most loading issues. Please note that this will remove your mods, so make a backup first.

If you still have troubles, please let us know so we can help you.