Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Capinetta-RP/capinetta-discord-bot/llms.txt

Use this file to discover all available pages before exploring further.

The Capinetta RP Bot System is a production-ready, self-hosted Discord management platform built specifically for FiveM and GTA Roleplay communities. It ships two independent bots — a General Bot for moderation, tickets, and auditing, and a Whitelist Bot for application management — orchestrated by PM2 and backed by MariaDB via Prisma ORM.

Quick Start

Get both bots online in under 5 minutes with the step-by-step setup guide.

Configuration

Set up environment variables, bot tokens, and database connection strings.

Command Reference

Every slash command, its arguments, permissions, and behavior explained.

Deployment Guide

Deploy to Oracle Cloud (free tier), a VPS, or Docker in production.

What’s Included

Anti-Spam

Automatic role isolation, bulk-delete, and 7-day account age enforcement.

Moderation

Warnings with auto-timeout, kick, unmute with full role restore from DB.

Ticket System

Dynamic categories, claim/transfer/close flows, transcripts, and inactivity reminders.

Whitelist

Approve or reject applications with branded embed notifications.

Web Dashboard

Discord OAuth2-protected admin panel with Redis-cached KPIs and real-time metrics.

Audit Logging

Message edits, role changes, voice events, bans, and canvas welcome cards.

Getting Started

1

Create two Discord bots

Visit the Discord Developer Portal, create two applications (General and Whitelist), and copy their tokens.
2

Configure your environment

Copy .env.example to .env and fill in your bot tokens, MariaDB credentials, and OAuth2 details. See the Configuration guide for every variable.
3

Initialize the database and deploy commands

Run npm install, npx prisma db push, then npm run deploy to push slash commands to Discord.
4

Start with PM2

Run npm run prod to start both bots under PM2 process management. Then run /setup in your Discord server to complete configuration.
The system requires Node.js v18+, MariaDB/MySQL 8.0+, and two separate Discord bot tokens. Redis is optional but recommended for dashboard caching.

Build docs developers (and LLMs) love