Install Modpacks on Your Minecraft Java Edition Server

Installing modpacks transforms your Minecraft server with custom content, new mechanics, and enhanced gameplay experiences. For best results, we recommend installing modpacks on a fresh server to prevent compatibility conflicts with existing files.

To join modded servers, use the CurseForge App to install the corresponding modpack on your local Minecraft client.

Installing Modpacks Through GhostCap

1. Log into your GhostCap panel and select your Minecraft server
2. Navigate to Tools > Modpack Manager
3. Choose your desired modpack and version from the available options
4. Enable Format and click Install to begin the installation process
5. Start your server once the installation completes

Critical Warning: The modpack installer does not create automatic backups of your existing world. If you want to preserve your current world data, download a backup before proceeding with the installation.

Manual Modpack Installation

For modpacks not available through the manager, you can install them manually using CurseForge downloads. Most modpacks provide separate server downloads for this purpose.

1. Log into your GhostCap panel
2. Go to Configuration > Server Actions > Install Different Edition
3. Select the compatible Minecraft version and edition for your modpack, then click Format
4. Use SFTP to upload your Modpack.zip file to the server's home directory
5. In the Files section, click the three dots next to your zip file and select Decompress
6. Start your server after the decompression completes

Installation Notes

Uploading compressed zip files is faster than individual file transfers. Most modpacks only require the mods and configs folders to function properly. After successful installation, your server directory should contain the mc-wrapper.jar, libraries, mods, and configs folders.

Common Installation Issues

Server Crashes Immediately

• Verify the correct server jar file is set in Startup Parameters
• Try different Java versions in Startup Parameters (Automatic works for most cases)
• Ensure large files (over 1GB) were uploaded via SFTP successfully

Version Compatibility Problems

• Confirm the modpack's required mod loader and Minecraft version
• Install the correct game version if the modpack didn't include a server jar
• Remember that Forge and NeoForge are not cross-compatible despite similar names

World Generation Crashes

• Large modpacks demand significant server resources
• Monitor System > Audit Logs to check resource usage
• Consider upgrading your server if crashes occur during world generation

Connection Issues

• Restart your server after installation
• Install the modpack on your local Minecraft client
• Verify you're using the correct server IP address
• Contact support if connection problems persist

Mod Mismatch Errors

• Download any missing mods reported in error messages
• Remove problematic mods from both client and server, then reinstall
• Ensure client and server have identical mod versions

These troubleshooting steps resolve the majority of modpack installation issues. If you encounter persistent problems, reach out to support for additional assistance.