API.md

RusherHack Plugin/Theme API

A free, static JSON API generated from the canonical JSON in this repo:
plugins-and-themes.json
It is deployed via GitHub Pages at:

https://rusherdevelopment.github.io/rusherhack-plugins/api/v1/

Note
Endpoints are static. They update only when the repo is updated.

---

Endpoints

Core

• index.json
  Full dataset (plugins + themes).

• plugins.json
  Plugins only.

• themes.json
  Themes only.

---

Metadata

• stats.json
  Aggregate counts by type, Minecraft version, and creator.

• versions.json
  List of all supported Minecraft versions.

• creators.json
  List of all creators with plugin/theme counts.

• meta.json
  Metadata about generation time + counts.

• manifest.json
  SHA256 & size for all API files.

• search-index.json
  Compact search index.

---

Activity (New & Recently Updated)

These files rely on the YAML fields added_at and updated_at:

• new.json
  Recently added items (sorted by newest added_at).

• recent.json
  Recently updated items (sorted by newest updated_at or added_at).

---

Per‑Item

• /items/{owner}/{repo}.json
  Example:
  items/kybe236/rusher-silent-close.json

---

Buckets (Filtered Views)

• /by-version/{mc_version}.json
  Example:
  by-version/1.21.4.json

• /by-creator/{creator}.json
  Example:
  by-creator/tillay.json

---

Usage Examples

Fetch plugins via curl

curl -s https://rusherdevelopment.github.io/rusherhack-plugins/api/v1/plugins.json | jq length

Find all kybe’s plugins

curl -s https://rusherdevelopment.github.io/rusherhack-plugins/api/v1/by-creator/kybe236.json | jq '.[].name'

Get stats

curl -s https://rusherdevelopment.github.io/rusherhack-plugins/api/v1/stats.json | jq .

---

Showcase

• RusherSearch
  Instant search UI consuming the API.

---

Important:
This is an early v1. API shapes may slightly evolve.