Reference

Commands

The command reference is optimized for lookup. Use /pp, /pluginportal, or /ppm as the root command.

Commands

Find plugins

Browse marketplace data without changing files on disk.

/pp

Open the command menu.

/pp view <name> [platform] [--byId] [--exact]

Preview a marketplace plugin before installing it.

/pp list

Show plugins installed through PluginPortal.

/pp info

Show PluginPortal version and server details.

Commands

Manage installs

Install, update, and remove managed plugins.

/pp install-url <url>

Install directly from a download URL.

/pp update <name> [--byId] [--ignoreOutdated] [--channel <name>] [--version <version>]

Update one managed plugin. --channel changes its saved release channel; --version installs an exact command-selected version.

/pp blacklist [name] [--byId]

Toggle a plugin out of updateAll. With no plugin, show the blacklist.

/pp platform <name> <platform> [--byId]

Switch a managed plugin to another marketplace platform when available.

/pp uninstall <name> [--byId]

Remove a managed plugin. /pp delete is an alias.

Reference

Install arguments

/pp install uses positional arguments first: required <name>, then optional [platform], then optional [channel]. Flags may be added after those arguments.

name

Required plugin search term. Quote names with spaces. With --byId, this is the marketplace platform ID.

/pp install "WorldEdit"

platform

Optional marketplace enum. Use MODRINTH, HANGAR, SPIGOTMC, or POLYMART. Required with --byId.

/pp install LuckPerms MODRINTH

channel

Optional positional marketplace release channel. The selected channel is saved for future updates.

/pp install ViaVersion MODRINTH beta

--byId

Treat the name value as a marketplace/platform ID instead of a search term. For Modrinth, use the base62 project ID/project_id, not the slug.

/pp install <platform-id> MODRINTH --byId

--exact, -e

Keep name search, but require exact case-insensitive plugin-name matches. This does not use marketplace IDs or slugs.

/pp install "WorldEdit" --exact

--version

Install an exact compatible version. Exact command-selected versions are excluded from updateAll.

/pp install LuckPerms MODRINTH --version 5.4.134

Examples

Advanced examples

Choose a platform

Use this when the same plugin exists on more than one marketplace.

/pp install LuckPerms MODRINTH

Install a specific version

Use this for a rollback or support-requested build. Exact versions selected from commands are skipped by updateAll.

/pp install LuckPerms MODRINTH --version 5.4.134

Update to a specific version

Add --channel only when the same version label exists on more than one release channel.

/pp update LuckPerms --version 5.4.134 --channel release

Install by marketplace ID

Use the platform ID when name search is ambiguous or support gives you an exact ID. For Modrinth, this is the base62 project ID/project_id, not the slug in the project URL.

/pp install <platform-id> MODRINTH --byId

Exact name search

Use exact matching when the search term is short or matches too many plugin names. This is still name search, not ID lookup.

/pp view "WorldEdit" --exact

Update by ID

Useful when two installed plugins have similar names.

/pp update <platform-id> --byId

Skip outdated checks

Use only when you intentionally want to reinstall even though PluginPortal thinks the installed version is current.

/pp update <name> --ignoreOutdated

Install from URL

Use for a direct download URL that PluginPortal can fetch.

/pp install-url https://example.com/plugin.jar

Commands

Admin

PluginPortal maintenance and support commands.

/pp upgrade [--yes]

Check for and install PluginPortal updates.

/pluginportal config refresh

Reload PluginPortal config from disk.

/pp dump

Create a diagnostic dump for support.