Plugin Browser

Eranio

Plugin Browser

Complete guide to the Plugin Browser, searching, browsing, filtering, plugin details, installation, dependency resolution, and provider-specific behavior.

On phones

On small screens the tabs and the action buttons move out of the header into one of two layouts:

• Bar at the bottom: "Browse", "Installed", the actions (Folder, Cache and Version when shown) and "Dropdown" to switch the layout. Up to five fields fit. If there are more, the last ones move into "More".
• Dropdown: a field below the title shows the current tab. Tapping it lists both tabs, the actions and the switch back to the bar.

The actions behave exactly like the buttons on a computer, including confirmation dialogs. The update count of "Installed" is shown as a small badge, and tapping it opens the list filtered to plugins with an update. The layout choice is saved in the browser and shared with Hytale Admin and the other plugin.

Browser Interface

The Installed tab shows an orange badge with the count of available updates. Clicking the tab auto-applies the has_updates filter.

Searching Plugins

How Search Works

1. Enter a plugin name or keyword in the search bar
2. Results load after debounce delay
3. Searches only the currently selected provider
4. Query sanitized: < > { } ' " removed
5. Results displayed as plugin cards

Search Retry

If search with MC version filter returns zero results, the plugin automatically retries without the version filter, so you'll see results for all MC versions rather than an empty page.

Provider-Specific Search

GeyserMC: Always shows exactly 6 projects. The search bar has no effect. These are the officially maintained Geyser ecosystem plugins.

Filters

Version Filter Visibility

• Shown for: SpigotMC, CurseForge, Modrinth
• Hidden for: PaperMC/Hangar, GeyserMC (version-agnostic providers)

The auto-detected version is displayed with a "🟢 Detected" prefix.

Common Versions Dropdown

Loaded live from Mojang's version list (fallback list from 26.3 to 1.7) with special labels:

• 26.3.x, "Latest" (always the newest version)
• 1.12.x, "Popular"
• 1.8.x, "Legacy"

Plugin Cards

Plugin Detail View

Click a plugin card to see:

• Full description, CurseForge: HTML enrichment. Modrinth: Markdown
• Author and platform link
• Total downloads
• "View on [Provider]" button

Version Selection

Versions cached 1 hour per plugin per provider.

Installing a Plugin

Step-by-Step Process

GeyserMC Special Download Flow

GeyserMC bypasses the normal download:

1. cURL downloads JAR to temp file (custom User-Agent)
2. Upload via DaemonFileRepository::putContent()
3. No pull() used, entirely different flow

Dependency Resolution

CurseForge

• relationType=3 = required dependency
• Recursive: Dependencies of dependencies resolved too
• Each dependency triggers a separate Filament notification
• Dependencies installed before the main plugin

Modrinth

• dependency_type === 'required' → auto-install
• Specific version_id → exact version
• No version_id → search latest compatible

SpigotMC

• No dependency API, dependencies must be installed manually

PaperMC/Hangar

• pluginDeps with required: true → auto-install
• Only Paper platform dependencies

GeyserMC

• No dependency API, Geyser is typically a dependency for Floodgate

Notification

"X additional library plugins will be installed that are required for this plugin"

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 a different provider tab
6. Auto-retry without version filter should trigger, if still empty, broaden search
7. Check storage/logs/laravel.log

"Plugin download failed"

• Expired URL: Clear cache, search again, retry
• CDN unreachable: Provider CDN temporarily down
• SpigotMC premium: HEAD check returned HTML → manual download required
• GeyserMC: Check download.geysermc.org accessible
• Disk full: No space on game server

"Installation failed"

• /plugins/ directory not writable → check permissions
• Disk space full
• Filename detection failed after 3 retries → Log: "Failed to detect filename after download"
• Database write error

"Plugin identification not found!"

• Empty pluginId when trying to install/manage
• Re-search the plugin for fresh metadata
• Clear cache and retry

Plugin name shows filename instead of name

• JAR metadata extraction failed (no plugin.yml in JAR or file too large)
• Only cosmetic, plugin functions correctly

CurseForge shows "Manual download required"

• Author restricted direct downloads
• downloadUrl empty in API response
• Download manually from CurseForge website and upload via SFTP

SpigotMC shows "Manual download required"

• HEAD request returned text/html instead of JAR
• Plugin is premium or download-restricted
• Purchase/download from SpigotMC and upload via SFTP