Skip to content

Installation

Info

Meowtils is a one-time installation, after following these steps it will always inject into your game at startup.

Any future updates will be handled by the Auto-Updater, which means you won't have to manually replace any files or install it again.

The Auto-Updater can still be disabled if you want to update manually.

Forge

1: Install Forge

If you already have Forge installed you can skip this step.

Warning

You can use third-party launchers for Forge, such as Prism Launcher or Feather Client, however these will have different installation steps.

Certain launchers may not be supported.

  1. Download Forge Installer.

  2. Execute the installer by clicking/opening it.

  3. In the window, select Install client, then click OK.

  4. After installation is complete, open your Minecraft Launcher and select Forge in your versions dropdown menu (where you select which Minecraft version to use). This menu is found when making/editing installations.
    Full name: release 1.8.9-forge1.8.9-11.15.1.2318-1.8.9

  5. Launch your game once to create the necessary files, or manually navigate to your instance folder (by default, .minecraft), then create a folder called mods.

Note

If you are unable to run the .jar, you will need to install Java.

2: Add Meowtils

  1. Download Meowtils.

  2. Add the Meowtils jar to your mods folder.

3: Launch Minecraft

Now launch Minecraft, Meowtils should be loaded.

It is recommended that you check out Basic Usage in order to learn how to use Meowtils.

Lunar Client

Info

If you have issues after uninstalling go to the section further down on this page.

1: Install Lunar Client

  1. Download Lunar Client.

  2. Follow their installation steps.

2: Download Meowtils

Meowtils.

3: Follow Meowtils installation steps

  1. Execute the Meowtils jar by clicking/opening it.

  2. Click Install in the Install on Lunar Client section.

    Meowtils Installer

  3. Wait for installation to complete, there should now be a JVM Argument copied to your clipboard.

    Meowtils Installer completed

Note

If you are unable to run the .jar, you will need to install Java.

4: Add Meowtils to Lunar

  1. Open settings in Lunar Launcher (bottom left corner).

  2. Enable advanced mode, next to the search bar;

    Lunar advanced mode

  3. Navigate to the Game Settings section, scroll down until you find the JVM Arguments box.

  4. Paste the JVM Arguments that were copied from previous step into this box.

  5. If visible, click the save icon;

    Lunar save icon

5: Confirm it is installed correctly

There should be a folder called Meowtils-Lunar created in the same directory as the jar you used for installation. This contains all necessary files.

You should also have your JVM Arguments in settings;

Lunar JVM arguments

6: Launch Minecraft

Now launch Minecraft, Meowtils should be loaded.

It is recommended that you check out Basic Usage in order to learn how to use Meowtils.

Note

If installation didn't work for you, follow the manual installation guide below.

Lunar Client Manual

Warning

These steps require you to edit multiple files that you may not be familiar with, and if anything is done incorrectly it will fail. It is recommended that you use the Meowtils Installer shown above which automates all of this for you, if possible.

This is just a fall-back if the installer fails.

1: Download files

  1. Meowtils Jar.

  2. Manual-Install Folder.

2: Extract and rename

  1. Extract the downloaded Manual-Install archive.

  2. Rename the jar to Meowtils.jar, this is just for convenience. Then put this jar in the extracted `Manual-Install folder.

3: Open agent-mods.json

Edit the file path so it points towards the Meowtils jar.

Example

{
  "mods": [
    {
      "jar": "C:\\Users\\tatp\\Desktop\\Meowtils-Lunar\\Meowtils.jar",
      "mixin": "mixins.meowtils.json",
      "property": "meowtils.agent.injected"
    }
  ]
}

Info

The path will look different depending on operating system, but on Windows it uses \, in this case you need to insert an extra \ as an escape character. This is shown in the example above.

4: Construct the JVM Argument

The JVM Argument points to the agent jar, and the agent json.

Agent jar: -javaagent:C:\Users\tatp\Desktop\Meowtils-Lunar\lunar-agent.jar

Agent json: =C:\Users\tatp\Desktop\Meowtils-Lunar\agent-mods.json

Insert the correct path to each file, and then combine them.

Example

Combined Arguments
-javaagent:C:\Users\tatp\Desktop\Meowtils-Lunar\lunar-agent.jar=C:\Users\tatp\Desktop\Meowtils-Lunar\agent-mods.json

5: Add Meowtils to Lunar

  1. Open settings in Lunar Launcher (bottom left corner).

  2. Enable advanced mode, next to the search bar;

    Lunar advanced mode

  3. Navigate to the Game Settings section, scroll down until you find the JVM Arguments box.

  4. Paste the JVM Arguments that you constructed from previous step.

  5. If visible, click the save icon;

    Lunar save icon

6: Launch Minecraft

Now launch Minecraft, Meowtils should be loaded.

It is recommended that you check out Basic Usage in order to learn how to use Meowtils.

Uninstallation

Forge Uninstall

Simply remove the Meowtils jar from your mods folder.

Lunar Client Uninstall

  1. Remove files

    Delete the folder where the relevant files are located, which is where the Meowtils jar is located.

  2. Clear JVM Arguments

    Go into the Lunar Launcher and clear out the JVM Arguments, which is where you put them during installation.

Failure

If you are crashing after this, you need to delete the bake cache.

Steps:

  1. Navigate to .lunarclient, usually located in your user directory.

  2. Go to offline → multiver → cache.

  3. Delete bake.zip, it will be located in one of the folders that are located in cache.