Update & APIs

Plugin manifest

GET https://rootmc.net/plugins/manifest.json

JSON object keyed by plugin id. Each entry:

{
  "root-core": {
    "version": "1.8.0",
    "filename": "root-core-1.8.0.jar",
    "url": "https://rootmc.net/plugins/root-core-1.8.0.jar"
  }
}

• version — YEAR.MONTH.BUILD compared by Root-Core
• filename — jar name written under plugins/
• url — HTTPS download (CDN / Pages)

Human catalog UI: rootmc.net/plugins.

Root-Core updater

Configured in plugins/RootMC/root-core.yml. Manifest URL: updater.manifest-url (blank → site.plugins-manifest). See Cloudflare / edge URLs.

updater:
  enabled: true
  manifest-url: ""
  interval-hours: 1
  only-installed: true
  restart-after-update: true

site:
  plugins-manifest: "https://rootmc.net/plugins/manifest.json"

• Polls the manifest on an interval and on /rootcore update
• Downloads newer jars; keeps the currently loaded jar until restart (avoids zip-closed crashes)
• Prunes older same-plugin jars after the new file is on disk
• Can schedule Root-Restart / countdown when maintenance rules allow

Full walkthrough: Root-Core → Suite updater.

License bind & presence

Default base: https://api.rootmc.net via license.api-base (no silent remap to local-edge). Secrets land in cloud.yml.

Discord: Paper JDA uses cloud.yml discord.*; Worker posts use wrangler DISCORD_ROOTMC_* channel vars. See Root-Core → Discord.

Developer portal APIs

Authenticated operator flows (Discord login) for account keys and My Servers live under the developer portal. Overview concepts are in the portal UI and Web Files/rootmc-web/public/developer/README.md in the repo (not public HTML).

• Portal home
• My Keys
• My Servers
• Register / Login

Public data APIs (index)

Player- and site-facing JSON used by rootmc.net (and linked apps). Explore from the live site; base host https://api.rootmc.net unless noted.

This is an index for operators — not a full OpenAPI dump. Plugin install remains the primary path to run a RootMC-powered Paper host.