Modpack Browser
Modpack Browser
Complete guide to browsing, searching, filtering modpacks, viewing details, and understanding provider-specific behavior.
Browser Interface
| Tab | Purpose |
|---|---|
| Browse | Search and discover modpacks across all providers |
| Installed | View currently installed modpack (see "Managing Modpacks" guide) |
Searching Modpacks
How Search Works
- Enter a modpack name or keyword in the search bar
- Results load after debounce delay
- Searches only the currently selected provider
- Search queries are sanitized:
< > { } ' "characters removed
Provider-Specific Search Behavior
| Provider | Empty Search | With Query | Sorting |
|---|---|---|---|
| Modrinth | Popular modpacks with facets | Full-text search | Relevance |
| CurseForge | Popularity (ID 2, desc) | Featured (ID 1, desc) | Dynamic |
| ATLauncher | GraphQL browse | GraphQL mutation search | Default |
| FTB | All public modpacks | Full-text search | Default |
| Technic | Search "Technic" (fallback) | Full-text search | Default |
| VoidsWrath | Full list (no search) | No search supported | Default |
VoidsWrath: The
supportsSearch()method returnsfalse. All data is loaded at once and paginated client-side. The search bar has no effect.
Modpack Cards
Each result card displays:
| Element | Description |
|---|---|
| Icon | Modpack logo from provider CDN |
| Name | Modpack title |
| Author | Creator username |
| Summary | Short description |
| Downloads | Total download count |
| Updated | Last version release date |
| Requires Launcher | ⚠️ badge for ATLauncher, FTB, Technic |
Modpack Detail View
Click a modpack card to see:
- Full description
- Author info
- Total downloads
- "View on [Provider]" button
- Version list with installation options
Version Information
Each version shows:
- Version name/number
- Release date
- Minecraft version compatibility
- Mod loader type (Forge, Fabric, NeoForge, etc.)
- Install button (or "Requires Launcher" warning)
"Requires Launcher" Providers
For ATLauncher, FeedTheBeast, and Technic modpacks:
- The modpack is marked
requires_launcher: true - You cannot install directly from the panel
- Install using the respective launcher on your PC
- Upload the server files to your Minecraft server via SFTP/file manager
- Track the modpack manually or use the panel's modpack tracking
Direct Install Providers
For Modrinth and CurseForge:
Modrinth Direct Install
- Downloads
.mrpackfile → renamed to.zip - Extracts contents
- Parses
modrinth.index.jsonfor dependencies - Resolves loader: Fabric (fabricmc.net), Quilt (quiltmc.org)
- Forge/NeoForge logged as unsupported for direct install
- Copies
overrides/to server root - Generates
run.sh+run.bat
CurseForge Direct Install
- Downloads modpack archive
- Parses
manifest.jsonfor file list - Downloads each mod individually from CurseForge
- Applies overrides from archive
Troubleshooting
No search results
- Check internet connection
- Verify provider API is online
- Clear Cache button
- For CurseForge: API key set?
- Try different provider tab
- Check
storage/logs/laravel.log
"Requires Launcher" for all modpacks
- You may be on the ATLauncher, FTB, or Technic tab
- Switch to Modrinth or CurseForge for direct installation
- VoidsWrath has direct install via
serverPackUrl
Modpack images/icons don't load
- CDN may be temporarily unavailable
- Network/firewall blocking image CDN domains
- Not a functional issue — modpacks still installable
Search doesn't work on VoidsWrath
- By design:
supportsSearch()returnsfalse - All modpacks loaded at once, browse the full list
- Client-side pagination available