Discord-Top-User

Production-ready Discord ecosystem by Deep Dey with modular cogs for leaderboard automation, music administration, game engines, utility workflows, telemetry, and web dashboard tooling.

Project Overview

Discord-Top-User is a full bot platform that combines:

• Leaderboard Engine: tracks message activity and computes top members.
• Music V2 Engine: track management + streaming playback + admin dashboard.
• Gamification Suite: interactive games, auto-games, quiz/TAD, and points.
• Utilities Admin: keyword/auto-reply + moderation-friendly content tools.
• Digital Proxy Status Engine: status profiles, alias detection, missed-pings vault.
• Telemetry Pipeline: centralized error/activity/game/security reporting.
• Web Discovery Dashboard: searchable public server listing + bot stats.

Key Features

1) Leaderboard

• Guild settings for cycle timing, top count, channels, and role rewards.
• Auto and manual resets with JSON/HTML backup exports.
• Role re-assignment for current cycle winners.

2) Music

• Music command group with join/start/now-playing/queue controls.
• Track management via Discord modals and secure web dashboard.
• FFmpeg-backed playback and persistent session behavior.

3) Games

• Fast interaction games (e.g., scramble/math/toss/RPS/TTT/quiz/guessing).
• Auto-game scheduler with role pinging and instant winner resolution.
• Points + profile rank updates with telemetry logging.
• /myprofile shows total points, join time, member status, global/server ranking, and Pomodoro snapshot.

4) Utilities

• Keyword auto-reply and managed content administration.
• Utility commands for productivity and common server workflows.
• Secure dashboard routes protected by password session auth.

5) Productivity (AFK + Pomodoro)

• Deep-work profile management with configurable work/break cycles.
• /pomodoro status returns live session state, remaining/focused time, and latest update timestamps.

6) Security & Reliability

• Password-gated sensitive actions.
• Telemetry-backed exception logging.
• API safety wrappers and resilient fallback behavior.

---

Quick Start (Local Setup)

Prerequisites

• Python 3.10+
• MongoDB connection URI
• FFmpeg installed on host
• Discord bot application + token

Install & Run

cd /path/to/Discord-Top-User
pip install -r requirements.txt
python main.py

---

Deployment Guide (Render with Docerfile)

This repository intentionally uses Docerfile (spelling preserved in project).

Render Web Service Steps

1. Push repository to GitHub.
2. In Render, create a New Web Service from this repository.
3. Configure service to build using Docker and point to Docerfile.
4. Set environment variables from the list below.
5. Deploy and monitor logs (Docker now starts both main.py and website.py together).

API runtime compatibility

• Render runtime uses PORT automatically for the Flask API server.
• api/index.py is kept as the serverless-compatible API entrypoint (from keep_alive import app).
• API endpoints, request shapes, and response formats remain unchanged.

Optional local Docker check

docker build -f Docerfile -t discord-top-user .
docker run --env-file .env discord-top-user

---

Environment Variables

Variable	Required	Description
DISCORD_TOKEN	Yes	Discord bot token
MONGO_URI	Yes	MongoDB connection URI
PASSWORD	Yes	Shared secure password for admin actions/modal gates
SPACE_PASSWORD	Yes (music upload workflows)	Credential used for CDN upload operations

Optional deployment environment tuning can be added by your host/provider.

---

Repository Structure

cogs/
  game_commands.py
  music_commands.py
  productivity_commands.py
  proxy.py
  setup_commands.py
  utility_commands.py
utils/
  audio_manager.py
  branding_view.py
  discord_resilience.py
main.py
keep_alive.py
database.py
telemetry.py
Docerfile
.github/

---

Community & Maintenance

• Contributing
• Code of Conduct
• Security Policy
• License
• Issue Templates

---

Branding

Built and maintained by Deep Dey.

• Portfolio: https://deepdey.vercel.app/
• Instagram: https://deepdey.vercel.app/insta
• Contact: https://deepdey.vercel.app/contact