PCPartPicker Cog
The PCPartPicker cog automatically detects PCPartPicker list URLs posted in chat and provides interactive build previews with price tracking. It supports both regular (/list/) and saved (/user/.../saved/) list URLs across all PCPartPicker regional domains.
Features
Automatic URL Detection
- Detects PCPartPicker list URLs in any message automatically (no command needed)
- Supports all regional PCPartPicker domains (us, uk, de, au, ca, fr, and 15+ others)
- Shows the build’s total price in the list’s regional currency
- Displays a per-post preview count and a total across all times the same list has been shared
Interactive Buttons
When a list is detected, the bot responds with action buttons. If no list spam channel is set:
- Show List (For you) - Ephemeral paginated build preview (private)
- Show List (For everyone) - Public paginated build preview
- DM you the list - Sends the full build preview via DM
- Compare Prices - Cross-references components against DropReference (Beta)
List Spam Channel Mode
When a list spam channel is configured, the full preview is sent there automatically instead of using buttons, and a link to the spam channel is posted in the original message’s channel.
Preview Tracking
Every interaction is logged to the database per list ID:
- Per-post preview count (how many times this specific Discord post was previewed)
- Total list preview count (all posts of the same list, server-wide)
- Moderators can look up preview history per user or per list ID
DropReference Integration
The “Compare Prices” button fetches DropReference data for each component and shows potential savings versus the PCPartPicker prices.
Product URL Previews
When a message contains a PCPartPicker product URL (e.g. pcpartpicker.com/product/...), the bot suppresses the default Discord embed and posts a compact preview instead, including:
- Product name and price
- Manufacturer (when available)
- One contextually relevant spec for the part type — e.g. GPU length, CPU socket, RAM capacity, PSU wattage, motherboard socket/form factor, cooler height, or monitor resolution
- Product image as a thumbnail (if enabled)
This behaviour is controlled by the four Product Preview settings in /pcpp config.
Commands
User-Facing
There are no user-facing slash commands. Simply post a PCPartPicker URL in any channel and the bot will respond automatically.
Moderator / Admin Commands
| Command | Permissions | Description |
|---|---|---|
/pcpp history <query> | Manage Messages | View preview history by user ID or list ID |
/pcpp config | Administrator | Open the interactive PCPP configuration panel |
/pcpp help | Everyone | View PCPP feature overview |
Admin-Only Commands
| Command | Description |
|---|---|
/pcpp enabled <true/false> | Enable or disable PCPP preview system |
/pcpp listspamchannel [channel] | Set (or clear) the channel where list previews are sent |
Bot Owner-Only Commands (Proxy Management)
| Command | Description |
|---|---|
/pcpp proxyadd <host:port> | Add a proxy server to the rotation |
/pcpp proxyremove <host:port> | Remove a proxy server |
/pcpp proxyauth <username> <password> | Set proxy authentication credentials |
/pcpp proxyenabled <true/false> | Enable or disable proxy usage (tests all proxies first) |
/pcpp proxylist | List all configured proxy servers and their status |
Configuration
| Setting | Default | Description |
|---|---|---|
| Enabled | true | Toggle the PCPP system on or off |
| Log Channel | (none) | Channel where PCPP activity is logged |
| Show Roles | (none) | Roles allowed to use the “Show List (For everyone)” public button |
| List Spam Channel | (none) | Channel where full list previews are sent automatically (see below) |
| Product Preview | true | Enable or disable product URL previews entirely |
| Product Preview — Show Image | true | Show the product image as a thumbnail in the preview embed; when disabled, a plain “View Image” link is shown instead |
| Product Preview — Reply | true | Send the product preview as a reply to the original message; when disabled, it is sent as a standalone message in the same channel |
| Product Preview — Show Author | false | Show the display name and profile picture of the user who posted the product URL in the embed author field |
The List Spam Channel setting can also be set via /pcpp listspamchannel.
Supported Regions
PCPartPicker lists from any regional subdomain are supported. The currency shown matches the list’s region (e.g. de.pcpartpicker.com shows EUR, uk.pcpartpicker.com shows GBP).
Supported regions include: Australia (AUD), Austria (EUR), Belgium (EUR), Canada (CAD), Czechia (CZK), Denmark (DKK), Finland (EUR), France (EUR), Germany (EUR), Hungary (HUF), Ireland (EUR), Italy (EUR), Netherlands (EUR), New Zealand (NZD), Norway (NOK), Portugal (EUR), Romania (RON), Saudi Arabia (SAR), Sweden (SEK), United Kingdom (GBP), and the default US (USD).
Best Practices
- Set a list spam channel in busy servers to keep build previews from cluttering the channel the list was posted in
- Configure Show Roles to restrict who can trigger public previews, preventing spam in active channels
- Use
/pcpp historyto identify users who repeatedly share the same lists (could indicate spam)