> ## Documentation Index
> Fetch the complete documentation index at: https://catalyst.leifiyo.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Modrinth content

> Search, install, update, and remove compatible Modrinth plugins and mods.

Catalyst integrates with the Modrinth API from the server detail page. The content browser chooses the right content type for the server platform.

| Server platform | Content folder | Modrinth type                          |
| --------------- | -------------- | -------------------------------------- |
| Paper           | `plugins/`     | Plugins                                |
| Purpur          | `plugins/`     | Plugins                                |
| Fabric          | `mods/`        | Mods                                   |
| Vanilla         | Not managed    | Not shown as a normal content workflow |

## Browse and install

<Steps>
  <Step title="Open Content">
    Open a server detail page and choose the content/library tab.
  </Step>

  <Step title="Search or sort">
    Search Modrinth and sort by relevance, downloads, updated date, or newest.
  </Step>

  <Step title="Inspect a project">
    Open project details for description, gallery, status, and available compatible versions.
  </Step>

  <Step title="Install">
    Catalyst chooses a compatible version, downloads required dependencies, verifies hashes when available, and writes the files to `plugins/` or `mods/`.
  </Step>
</Steps>

## Installed content

Catalyst tracks installed Modrinth projects in `.catalyst/modrinth.json` inside the server folder. The installed list can update or remove tracked projects.

<Info>
  Manual files placed in `plugins/` or `mods/` still work at the server level, but Catalyst only knows how to update or remove projects recorded in its Modrinth manifest.
</Info>

## Dependency handling

Catalyst resolves required Modrinth dependencies recursively. Optional dependencies are not forced. Downloads are written with safe filenames and kept inside the content directory.

<Warning>
  Restart the server after installing, updating, or removing most plugins and mods. Hot-loading depends on the server software and the plugin or mod itself.
</Warning>