Mods, plugins & modpacks

On this page

Where modpacks live in the panel#

Everything to do with what your server runs lives on the Software page, which you reach from Software in your server's sidebar. There is no separate mods page or modpack marketplace. The Software page is a guided wizard that walks you from your current setup through to a new one, and a modpack is just one of the things you can land on at the end of it.

The wizard moves through a fixed set of steps, shown as a progress bar across the top: an overview of your current software, then Select Category, Select Software, Configure, and finally Review Changes. You start by clicking Change Software on the overview.

Note: Applying any change here stops and reinstalls your server, which takes a few minutes and can modify or remove files. The panel says as much on the review screen, so take a backup of anything you want to keep first.

Modpacks vs single mods and plugins#

A modpack is a curated bundle of mods that ships with its own configuration, and the panel installs it for you as a whole. You pick one as part of changing your software, and the install rebuilds the server around it.

A single mod or plugin is different. The panel does not have a one-at-a-time installer for individual mods or plugins, so you add those yourself by uploading the file through the file manager, typically into the server's mods or plugins folder. Whichever route you take, your server type has to support the loader the content was built for. A Fabric mod needs a Fabric server, a plugin needs a server that runs plugins, and so on.

Note: Dependencies are not resolved for you when you add mods by hand. If a mod needs another mod to run, upload that one too, and check the project page for its required dependencies before you start the server.

Choosing a modpack#

On the Software page, click Change Software to open the wizard. The first two steps narrow down what you want to run. Select Category lists the categories of game and software available on your server, with a search box and a Show more button when there are many. Pick a category, then on Select Software choose the specific software (the panel calls each one an egg) you want, for example a Fabric or Forge modpack server.

When the software you picked is a modpack type, the modpack browser appears on the next step, Configure, under the Environment Variables heading. For ordinary software the same step just shows plain configuration fields instead.

Browsing for a pack#

The modpack browser pulls packs from either Modrinth or CurseForge, depending on the software you selected, and shows them as a grid of cards. Each card carries the pack's icon, title, author, a short summary, its download count, when it was last updated, and badges for the Minecraft versions and loaders it supports.

A search box at the top filters by name as you type. Below it are four controls: Minecraft version, Loader, Category, and Sort by. Each is a dropdown that defaults to Any (sort defaults to Most downloads, and also offers Relevance, Recently updated, and Newest). When more results exist than fit on screen, a Load more button at the bottom pulls in the next batch.

Opening a pack and picking a version#

Click a card to open the pack's detail view. This shows the title, a gallery of screenshots where the author provides them, a short summary, and a View on Modrinth or View on CurseForge link out to the source. Clickable Minecraft-version chips near the title let you filter the version list to a single game version. A Back to results button returns you to the grid.

Under Versions is the list you choose from. Pinned to the top is a synthetic Latest (auto) row, which always installs the most recent compatible version whenever the server is (re)installed, so the pack keeps itself current instead of pinning to a fixed build. Below it are the five most recent versions, each tagged with its Minecraft versions, loaders, and publish date. A search box and a Show more toggle reveal the rest. Click a row to select it.

Selecting a pack and a version does not install anything on its own. It just records your choice; the install happens when you finish the wizard.

Safety options and applying the change#

Still on Configure, below the picker is a Safety Options section with two switches. Create Backup takes a backup before the change is applied (it is disabled when backups are turned off or you have hit your backup limit). Wipe Files deletes every file on the server before the new software is installed, which is what gives you a clean modpack install rather than a pack layered on top of your old world.

Click Review Changes to reach the final step. It lays out a summary of what is changing, the startup command and Docker image, your variable values, the state of both safety switches, and a warning spelling out that the server will be stopped and reinstalled. Confirm with Apply Changes to start the install.

If you turned on Wipe Files without also turning on Create Backup, the panel shows an extra confirmation that all files will be permanently deleted, with a short countdown on the Yes, Wipe Files button before you can confirm.

Note: A wipe erases everything on the server and cannot be undone. Keep Create Backup on, or take a backup yourself, before you wipe.

Adding mods or a build the browser does not list#

If you want a specific build that the browser does not offer, or you are adding individual mods or plugins, upload the files yourself through the file manager, dropping them into the server's mods or plugins folder as appropriate. If the modpack browser is ever unavailable, the Configure step falls back to plain Project ID and Version ID fields you can fill in by hand.

After any install, watch the console to confirm the server starts cleanly. The currently installed pack is shown on the startup page, with its name, version, and a note that you change the installed software back here on the Software page.