Mods and plugins
Installing Paper plugins, Forge modpacks, Valheim BepInEx mods and Workshop collections, and what breaks when a game updates.
Two different things
Plugin servers (Paper, Fabric, SourceMod) load code that hooks into the game. Mod servers (Forge, ARK, Valheim BepInEx) replace or extend game content, and the client must load the same set. If you install a mod on the server and not on the client, the client cannot join — that is not a configuration problem, it is the design.
Minecraft
Paper plugins
Drop the .jar into /mods (not /plugins) on our template — the directory naming follows the loader, and Paper reads from /mods here. Restart, then check the console for a plugin's first-run message.
Modpacks
Upload the .zip from CurseForge, or the .mrpack from Modrinth, through instance → Mods → Import. The installer unpacks into /mods and /config, writes a manifest, and refuses to start if it detects a client-only mod (OptiFine, shaders, minimaps) that would crash a dedicated server.
Java versions
The template pins Java per Minecraft version: 21 for 1.20.5 and newer, 17 for 1.18–1.20.4, 8 for older packs. Changing the jar without changing Java is the most common cause of an UnsupportedClassVersionError.
Valheim
Mods go into /BepInEx/plugins. The template installs the BepInEx loader, not individual mods. A mod set must match exactly on the client; the panel can generate a list of installed DLLs with their hashes so you can share it.
ARK and Rust
| Game | Where mods come from | Note |
|---|---|---|
| ARK | Steam Workshop IDs in the config | Game updates first, then mods |
| Rust | Oxide/uMod or Carbon | Pin the Oxide build per server |
| Project Zomboid | Workshop collection ID | Server writes the ID list for clients |
When a game updates
Automatic updates are off by default. That is deliberate: an update mode that restarts every instance the moment the developer pushes a patch will break modded servers at the worst possible hour. The panel shows an update as available and lets you pick the moment.
Every install keeps the previous mod directory as /mods.previous until the next successful start. If an update breaks the server, rename the directories and restart — no re-upload needed.