Plugins API

List Plugins

GET /api/plugins

Returns a paginated list of plugins. All parameters are optional.

Query Parameters

Parameter	Type	Description
`q`	string	Search query (matches name, tagline, description)
`category`	string	Filter by category
`platform`	string	Filter by platform (e.g., "paper", "folia")
`price`	string	"free" or "premium"
`sort`	string	Sort order: "popular", "newest", "rating"
`page`	number	Page number (default: 1)
`limit`	number	Results per page (default: 12)

Response Shape

interface Plugin {
  slug: string;
  name: string;
  tagline: string;
  description: string;
  icon: string | null;
  author: string;
  price: number | null;
  platforms: string[];
  category: string;
  downloads: number;
  views: number;
  rating: number;
  links: Record<string, string>;
  images: string[];
  versions: Array<{ version: string; date: string }>;
  tags: string[];
  createdAt: string;
  updatedAt: string;
}

Example Request

GET /api/plugins?category=economy&sort=popular&limit=5

Example Response

{
  "plugins": [
    {
      "slug": "blueth-contracts",
      "name": "Blueth Contracts",
      "tagline": "Quest board and season tasks",
      "author": "Blueth",
      "price": 10,
      "platforms": ["paper", "folia"],
      "category": "gameplay",
      "downloads": 1250,
      "rating": 4.8,
      ...
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 5
}