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

  1. Enter a modpack name or keyword in the search bar
  2. Results load after debounce delay
  3. Searches only the currently selected provider
  4. 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 returns false. 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:

  1. The modpack is marked requires_launcher: true
  2. You cannot install directly from the panel
  3. Install using the respective launcher on your PC
  4. Upload the server files to your Minecraft server via SFTP/file manager
  5. Track the modpack manually or use the panel's modpack tracking

Direct Install Providers

For Modrinth and CurseForge:

Modrinth Direct Install

  1. Downloads .mrpack file → renamed to .zip
  2. Extracts contents
  3. Parses modrinth.index.json for dependencies
  4. Resolves loader: Fabric (fabricmc.net), Quilt (quiltmc.org)
  5. Forge/NeoForge logged as unsupported for direct install
  6. Copies overrides/ to server root
  7. Generates run.sh + run.bat

CurseForge Direct Install

  1. Downloads modpack archive
  2. Parses manifest.json for file list
  3. Downloads each mod individually from CurseForge
  4. Applies overrides from archive

Troubleshooting

No search results

  1. Check internet connection
  2. Verify provider API is online
  3. Clear Cache button
  4. For CurseForge: API key set?
  5. Try different provider tab
  6. 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() returns false
  • All modpacks loaded at once, browse the full list
  • Client-side pagination available