Skip to main content

Manifest

The manifest.json file includes metadata about your addon, as well as pointing to the entry point of your addon's code.

caution

All props/parameters are optional unless they are marked with an asterisk ( * ).

Common

These keys are used by all addon types. There are additional keys for plugins and themes which are documented below.

KeyTypeDescription
id *stringThe unique identifier of your addon. This should be in reverse domain name notation and cannot be changed once your addon is published.
name *stringThe name of your addon.
description *stringA short description of your addon. Will be displayed in the store, as well as the addon settings page.
author *Author | Author[]The author(s) of your addon. Array cannot be empty.
version *stringThe version of your addon. We recommend the format x.y.z, though that is not required. This will be shown with a v prefix.
updaterUpdaterWhere Replugged will check for updates to your addon.
license *stringThe license of your addon. We recommend using SPDX identifiers, eg MIT or GPL-3.0.
imagestring | string[]A URL or array of URLs to preview images of your addon to be displayed in the store. Must be hosted on Discord's CDN (cdn.discordapp.com or media.discordapp.net) or Imgur.
sourcestringA URL to the source code of your addon. This will be displayed in the store and in the addon settings card.

Plugins

All keys in the common section, as well as the following:

KeyTypeDescription
type *'replugged-plugin'Must be replugged-plugin.
rendererstringThis is the path to the main entrypoint of your plugin (JavaScript). The plugin template will allow you to also use TypeScript and will handle compiling and updating the file location for you.
plaintextPatchesstringThe path to the plaintext patches file (JavaScript). Documentation for this will be coming soon.
reloadRequiredbooleanWhether Replugged should prompt the user to reload once your plugin on installation. Defaults to false unless you specified a plaintextPatches file.

Themes

All keys in the common section, as well as the following:

KeyTypeDescription
type *'replugged-theme'Must be replugged-theme.
mainstringThe path to the main entrypoint of your theme (CSS). The theme template will allow you to also use SCSS and will handle compiling and updating the file location for you.
splashstringThe path to Discord's splash screen entrypoint of your theme (CSS). The theme template will allow you to also use SCSS and will handle compiling and updating the file location for you.

Types

Author

KeyTypeDescription
name *stringThe display name of the author.
discordIDstringThe Discord ID of the author.
githubstringThe GitHub username of the author.

Updater

KeyTypeDescription
type *UpdaterTypeThe type of updater to use. See below for more info.
id *stringThe ID of the addon in the source. See below for more info.

UpdaterType

Must be one of the following:

  • store - The addon is hosted on the Replugged store. The id field should be the same as the addon's ID.
  • github - The addon is hosted on GitHub. The id field should be the repository's username/repo.