Product Panel

Key Features

• Interactive Panels → Use buttons or dropdown menus to deliver products

• Smart Placeholder Injection → Auto-replace placeholders with user data

• Image & ZIP Support → Process text inside images and zip archives safely

• Database Integration → Store unique user IDs for consistent downloads

• Tracking & Analytics → See who downloaded what, and when

• Role-Based Access → Restrict products to certain roles

• Cooldowns → Prevent spam downloads with custom cooldown timers

---

Configuration

Edit config.yml to define your panels, products, and permissions.

Example:

config.yml

ProductPanelRole: ["ROLE_ID_HERE"]  # Roles allowed to manage panels

panels:
  YourPanel:
    SelectMenu: true
    Title: "Your Product Panel"
    Description:
      - "**Choose a product to download:**"
      - "📦 **Standard Release** - $9.99"
      - "[Purchase Link](https://example.com)"
    Footer:
      Text: "Download your files today"
    Color: "#1769FF"

    products:
      - name: "Standard"
        emoji: "📦"
        description: "Standard Download"
        roleId: "REQUIRED_ROLE_ID"
        zipFilePath: "./products/YourPanel/Standard"
        buttonLabel: "Download Standard"
        buttonColor: "PRIMARY"

    cooldownDuration: 60  # seconds

Messages, logging embeds, and error handling are also customizable in config.yml.

---

Placeholder System

You can inject placeholders into text, code, zip contents, or even jars.

Placeholder	Description	Example
%%_DISCORD_ID_%%	User’s Discord ID	123456789012345678
%%_USERNAME_%%	User’s name	johndoe
%%_RESOURCE_%%	Product name	Standard
%%_TIMESTAMP_%%	Download time	2024-01-15T10:30:00Z
%%_UNIQUE_ID_X_%%	Random ID of X length	yDxY_Gr=9$Fw

• Each user always gets the same IDs for each length.

• IDs are saved in MongoDB, so they stay consistent across products.

• Supports IDs of 3–32 characters with letters, numbers, and symbols.

Put these placeholders anywhere in your files and they'll be replaced on download.

Make sure you replace X with a valid number (e.g., 4). Length must be more than 3.

---

Supported File Types

The Product Panel can process placeholders in a wide range of files.

Text Files (inline replacement)

Includes most programming, config, and text formats:

• Code: .js, .ts, .jsx, .tsx, .py, .php, .rb, .go, .rs, .java, .cpp, .c, .cs, .swift, .kt, .scala, .pl, .lua, .sh, .ps1, .bat, .jar

• Web: .html, .htm, .css, .scss, .sass, .less, .xml

• Config & Data: .json, .yaml, .yml, .toml, .ini, .cfg, .properties, .env

• Docs & Logs: .txt, .md, .log, .sql

• Dev Tools: .gitignore, .editorconfig, .eslintrc, .prettierrc, .babelrc, .tsconfig, .dockerfile, .makefile

(and many other common scripting, package, and project files)

Images (non-destructive)

• .png, .jpg, .jpeg, .gif, .bmp, .ico, .svg, .webp, .tiff, .tif

Placeholders are injected without breaking the image.

Archives (extract & repackage)

• .zip

Contents are unpacked, processed, and zipped back up automatically.

---

Commands

• /product create <panel> → Post a product panel in a channel

• /product list → See all configured panels

• /product stats <panel> → View download stats for a panel

• /product history [user] → Show a user’s download history

• /product trace [target|data] → Advanced lookup (by user, Discord ID, username, or placeholder data)

---

Best Practices

1

Use placeholders in configs, docs, and metadata to personalize downloads.

2

Test downloads to make sure placeholders replace correctly.

3

Watch file sizes (Discord’s limit is 8MB by default, up to 100MB with boosts).

---

Troubleshooting

• Placeholders not replaced → Check file type and syntax (%%_PLACEHOLDER_%%)

• Image corruption → Only insert placeholders at the end of images

• Permission errors → Verify ProductPanelRole and per-product roleId

• File too large → Compress or remove unnecessary files

---

Support

1

Double-check your config formatting.

2

Use /product trace to debug user data.

3

Review console logs for errors.