@hypeserv/mcmp-installer
v1.1.3
Published
hypeServ Minecraft modpack installer. Pulls a modpack from a URL, extracts it, installs the loader, and prepares the server for boot.
Downloads
420
Maintainers
Readme

This is being used at HypeServ.
A TypeScript/Node.js installer that pulls a Minecraft modpack from a URL or provider, unpacks it, installs the right loader (Forge / NeoForge / Fabric), and leaves the server ready to start.
Works with serverpacks from Curseforge, Modrinth, FTB, Technic, direct URL, and the serverpack-creator output format (manifest.json / variables.txt).
Quick start (npx)
No install required — run the latest published version directly:
npx -y @hypeserv/mcmp-installer --provider modrinth --modpack-id <slug>Direct zip URL:
npx -y @hypeserv/mcmp-installer --wget-mode --modpack-id https://example.com/pack.zipPin a specific version (recommended in Dockerfiles):
npx -y @hypeserv/[email protected] --provider curse --modpack-id 456789Global install
npm install -g @hypeserv/mcmp-installer
mcmp-installer --provider modrinth --modpack-id <slug>Usage
mcmp-installer --provider <provider> --modpack-id <id> [flags]
# or for a direct serverpack zip URL
mcmp-installer --wget-mode --modpack-id https://example.com/pack.zipFlags
| flag | description |
|---|---|
| --provider | curse | technic | ftb | modrinth | direct. Required unless --wget-mode. |
| --modpack-id | Project ID / slug / URL. In --wget-mode this is a direct zip URL. |
| --modpack-version | Specific version/build to install. Latest if omitted. Not used for direct. |
| --wget-mode | Skip provider parsing — treat --modpack-id as a direct zip URL (HEAD redirect resolved). |
| --wings | Flatten install into the working dir instead of a modpack subfolder. Use with panel daemons (e.g. Pterodactyl Wings). |
| --working-path <dir> | Directory to install into. Defaults to CWD. |
| --folder-name <name> | Explicit output folder name (ignored in --wings). |
| --clean-scripts | Remove .sh / .bat startup scripts after install. |
| --update | Remove /mods, /.fabric, /libraries, /coremods before installing. |
| --manifest-api-key <key> | API key for the hypeServ manifest mod download API (Curse manifest packs). |
What it handles
- Standard Curseforge serverpacks (with/without bundled loader)
- Modrinth
.mrpack(mods + overrides + dependencies) - FTB binary installers (run directly)
- serverpack-creator output (manifest.json or variables.txt)
- Nested folder zips (auto-flattens one level)
- Forge / NeoForge / Fabric installer download + run via Java
- Copies
unix_args.txt/win_args.txt+ loader server jars to modpack root so start scripts always find them
Requirements
- Node.js 18+ (and npm)
- Java 11+ (for Forge / NeoForge / Fabric server installers)
License
Source-available. See LICENSE for terms — read/run permitted, redistribution and derivative works require written permission.
© onesrv — HypeServ
