Install Nekogenix

Before you start

• A Microsoft account with access to Minecraft Java Edition.
• A Nekogenix release compatible with your profile’s Minecraft version. Other mods in that profile must also support its Minecraft version and NeoForge.

Before adding mods to an existing world, close the game and copy its folder from saves to a separate backup location.

Official Minecraft Launcher

1. In Minecraft Launcher, open Minecraft: Java Edition → Installations and select the profile you want to use. If you do not have one yet, create it with New installation for a Minecraft version supported by the mod.
2. Check that a compatible NeoForge version is installed. If needed, close the launcher, download the matching installer from NeoForge, open it with Java and select Install client → Proceed. The NeoForge guide covers Java requirements; launch the matching vanilla Minecraft version once if the installer requests it.
3. Open the profile’s three-dot menu → Edit. In Version, select the compatible NeoForge entry if it is not already selected. Enable the Modded filter in Installations if the profile is hidden.
4. Check Game directory in the profile settings: this is where its mods and worlds are stored. Keep the directory used by your existing profile. If the field is empty, the profile uses the default .minecraft directory.
5. Save the settings and use the folder button beside this profile in Installations to open its game directory. Open mods, or create that folder if it is missing.
6. Copy the downloaded Nekogenix JAR and any required dependency JARs into mods. Leave the mod files directly in that folder, without extracting them.
7. Select this profile in the launcher and start the game.

Prism Launcher

1. Select the instance you want to use in Prism Launcher. If you do not have one yet, use Add Instance and choose a compatible Minecraft version and NeoForge.
2. Right-click the instance → Edit → Version. Check its Minecraft and NeoForge versions against the Nekogenix release requirements. If NeoForge is missing, install it from this tab.
3. In the same editor, open Mods. Drag the downloaded Nekogenix JAR into the list and add any required dependency JARs in the same way.
4. Check that the added mods appear in the list and their checkboxes are enabled.
5. Close the editor and launch this instance.

Modrinth App

1. Open the instance you want to use in Modrinth App. If you do not have one yet, use Create instance → Custom setup and choose a compatible Minecraft version and NeoForge.
2. In the instance settings, check the Minecraft version, Loader and Loader version against the Nekogenix release requirements. Wait for any pending game or loader installation to finish.
3. From the instance’s action menu, choose Open folder. Open mods, creating the folder if necessary, and copy in the Nekogenix JAR plus any required dependency JARs.
4. Return to the instance’s Content tab. Check that the added mods are listed and enabled.
5. Click Play for this instance.

CurseForge App

1. In CurseForge App, open Minecraft → My Modpacks and select your profile. If you do not have one yet, click Create and choose a compatible Minecraft version and NeoForge.
2. Check the profile’s Minecraft and NeoForge versions against the Nekogenix release requirements. Wait for any pending installation to finish.
3. Click Add More Content. If the button is missing, open the profile’s three-dot menu → Profile Options, enable Allow content management for this profile and click Done.
4. Search for Nekogenix and click Install next to it. The catalogue shows files compatible with the profile’s Minecraft version and mod loader.
5. Wait for the installation to finish. Nekogenix will appear in the profile’s installed mods.
6. Click Play for this profile. If Minecraft Launcher opens, launch the profile prepared by CurseForge.

Play on a server

Install Nekogenix in your launcher using one of the methods above. Use the Minecraft version, NeoForge build and Nekogenix release required by the server.

The server owner also needs a NeoForge server with the matching Nekogenix JAR and required server dependencies in its mods folder. Stop the server before changing these files.