Skip to main content
Use Purpify’s modpack installer or mod installer when the content is available there. For a manual installation, upload compatible mod files to /mods.

​
Before you install mods

The server and players must use compatible combinations of:
  • Minecraft version
  • Mod loader
  • Mod or modpack version
  • Required dependencies
Create a backup before installing or updating mods.

​
Install a modpack

1

Open the modpack installer

Manage the Java server in the game panel, then open Purpify’s modpack installer.
2

Choose the modpack release

Select a release compatible with the Minecraft version and loader you want to use.
3

Install the modpack

Start the installation and wait until the panel reports that it finished.
4

Start and verify

Start the server, watch the console, and connect with the matching client-side modpack.

​
Install an individual mod

Use Purpify’s mod installer to find and install a compatible mod. Check whether the mod also needs to be installed on each player’s client.

​
Install a mod manually

1

Check compatibility

Confirm the mod supports the server’s Minecraft version and mod loader. Download every required dependency.
2

Stop the server

Stop the server before changing mod files.
3

Upload the mod

Upload the mod and its dependencies to the /mods folder.
4

Start and verify

Start the server and check the console for missing dependency, wrong loader, or version errors.

​
Diagnose a mod crash

Start with the server console, latest log, and crash report. The most useful error often appears before the final line that says the server stopped. You can give the relevant error log to an AI assistant such as ChatGPT and ask it to identify:
  • The mod named in the first relevant error
  • A missing dependency
  • A Minecraft or mod-loader version mismatch
  • Conflicting mods
  • The next safe test to perform
Remove passwords, access tokens, private server addresses, player information, and unrelated log history before sharing logs with an AI service. Treat the AI response as a diagnostic suggestion and verify it before deleting files or changing versions.
Example prompt:
If the error names Forge, NeoForge, Fabric, Quilt, a loader version, or an incompatible mod list, follow Troubleshoot Java mod-loader mismatches.