Documentation

Setup guides, configuration references, and tips for every bot in the 4PID collection.

Prerequisites

Before setting up any bot, make sure you have the following ready:

  • A Discord account and a server where you have administrator permissions
  • Basic familiarity with the command line / terminal
  • D4PID: Python 3.10+ and FFmpeg
  • M4PID & R4PID: Node.js 16+
  • A Discord Bot Token (for D4PID) or Discord User Token (for M4PID / R4PID)
  • A Groq API Key (for M4PID only)

Installation Overview

All three bots share the same general installation workflow:

  1. Download the ZIP file from the product page
  2. Extract the contents to a directory on your server or local machine
  3. Install dependencies (pip install -r requirements.txt or npm install)
  4. Configure environment variables or a config file
  5. Start the bot
/music

D4PID

Music streaming bot — Python, FFmpeg, YouTube search, queue system

/ai

M4PID

AI conversation bot — Node.js, Groq Llama 3, custom personality

/bump

R4PID

Bump automation bot — Node.js, live dashboard, Socket.IO
D

D4PID — Setup Guide

D4PID is a Python-based music bot that streams audio from YouTube into Discord voice channels.

Requirements: Python 3.10+ and FFmpeg must be installed on your system before proceeding. Place ffmpeg.exe in bin/ffmpeg/ or add it to your system PATH.
ZIP contents: The downloaded ZIP file includes a complete, accurate setup guide with all the details you need. No need to look elsewhere.

Step-by-Step

  1. Download and extract D4PID ZIP
  2. Open a terminal in the project directory and run:
    pip install -r requirements.txt
  3. Create a Discord Bot at the Discord Developer Portal:
    • Click New Application, name it
    • Go to the Bot tab, click Reset Token, then Copy
    Keep your token private. Anyone with it has full control of your bot.
  4. Under OAuth2 → URL Generator:
    • Scopes: check bot and applications.commands
    • Bot Permissions: check Administrator
    Copy the generated URL and open it in your browser to add the bot to your server.
  5. Create a .env file in the project directory:
    DISCORD_TOKEN=your_token_here
  6. Start the bot:
    py bot.py # or python bot.py
Note: D4PID uses slash commands only, so no Privileged Gateway Intents need to be enabled in the Developer Portal.

Commands

All commands use Discord's slash command system — no prefix needed:

/play <query> # Search YouTube and play or queue a song
/skip # Skip the current song
/pause # Pause playback
/resume # Resume playback
/stop # Stop, clear queue, and disconnect

Configuration

D4PID uses a .env file. The only required variable is DISCORD_TOKEN.

DISCORD_TOKEN=your_token_here # Required
# Optional variables may be added for
# default volume, voice channel, etc.

Notes

  • The bot stays connected between songs — new tracks can be queued without it leaving the channel.
  • Audio streams at 96kbps Opus for low-latency playback.
M

M4PID — Setup Guide

M4PID is a Node.js-based AI self-bot powered by Groq's Llama 3 model. It responds to mentions and replies with context-aware conversations.

Requirements: Node.js 16+, a Discord User Token, and a Groq API Key (free tier available at groq.com).
Note: M4PID uses a Discord user token (not a bot token). This is a self-bot — Discord's Terms of Service prohibit automating user accounts. Use on a secondary / alt account at your own risk.
ZIP contents: The downloaded ZIP file includes a complete, accurate setup guide with all the details you need. No need to look elsewhere.

Getting Your Discord User Token

  1. Open Discord in your browser (not the app)
  2. Press F12 and go to the Network tab
  3. Send any message in a channel, then filter the requests by messages
  4. Click a request, find Request Headers, and copy the Authorization value

Step-by-Step

  1. Download and extract M4PID ZIP
  2. Install dependencies:
    npm install
  3. Create a .env file:
    DISCORD_TOKEN=your_user_token_here
    GROQ_API_KEY=your_groq_api_key_here
  4. Configure the bot's personality in config.js
  5. Start the bot:
    npm start

Configuration

M4PID's behavior is controlled through config.js. Key options:

systemPrompt # Defines personality and behavior
model # Groq model (default: llama3-70b-8192)
maxTokens # Max response length
historyLimit # Messages remembered per channel
replyOnly # true = only respond to mentions/replies (recommended)

24/7 Hosting with PM2

M4PID includes a PM2 configuration for production. To keep it running 24/7:

npm install -g pm2 # Install PM2 globally
pm2 start # Start with auto-restart
pm2 stop # Stop the bot
pm2 restart # Restart the bot
pm2 logs # View live logs
pm2 monit # Monitor dashboard
pm2 save # Save process list
pm2 startup # Auto-start on system boot
R

R4PID — Setup Guide

R4PID is a Node.js-based bump self-bot with a browser dashboard for real-time monitoring and control. It monitors Discord channels for FIBO bot bump reminders and responds automatically with randomized delays.

Requirements: Node.js 16+ and a Discord User Token.
Note: R4PID uses a Discord user token (not a bot token). This is a self-bot — Discord's Terms of Service prohibit automating user accounts. Use on a secondary / alt account at your own risk.
ZIP contents: The downloaded ZIP file includes a complete, accurate setup guide with all the details you need. No need to look elsewhere.

Getting Your Discord User Token

  1. Open Discord in your browser (not the app)
  2. Press F12 and go to the Network tab
  3. Send any message in a channel, then filter the requests by messages
  4. Click a request, find Request Headers, and copy the Authorization value

Step-by-Step

  1. Download and extract R4PID ZIP
  2. Install dependencies:
    npm install
  3. Start the bot and dashboard:
    npm start
  4. Open the dashboard in your browser:
    http://localhost:3000
  5. Go to Configuration, enter your Discord User Token and one or more Bump Channel IDs, then click Save Changes
  6. Switch to the Dashboard tab and click Start Bot

R4PID will begin watching for FIBO reminders and bump automatically. All settings are stored in your browser's localStorage, so they persist between sessions.

Configuration

All settings are managed from the dashboard's Configuration panel:

  • Discord User Token — Your Discord account token for authentication
  • Bump Channel IDs — One or more channel IDs the bot should watch and bump in
  • Min Delay (seconds) — Minimum wait time before sending a bump
  • Max Delay (seconds) — Maximum wait time before sending a bump

Dashboard Features

The dashboard runs locally and updates in real-time via Socket.IO. You can monitor:

  • Live Status — Whether the bot is running or stopped
  • Bump Counter — Total bumps performed since starting
  • Activity Log — Timestamped events displayed in the dashboard
  • Start / Stop Controls — Control the bot from the dashboard

Project Structure

R4PID/
├── bot.js # Core bot logic and Discord client
├── server.js # Express server and Socket.IO setup
└── public/
    ├── index.html # Dashboard interface
    ├── css/
    │  └── styles.css
    └── js/
        └── app.js # Client-side dashboard logic

Stack

Runtime   Node.js
Server   Express
Discord   discord.js-selfbot-v13
Realtime   Socket.IO
Frontend   Vanilla JS

Ready to deploy?

You've read the guides — now pick a bot and get started.

Get Started D4PID Get Started M4PID Get Started R4PID