Swear-Jar-Discord-Bot/README.md

Swear Jar

Swear Jar is a Discord application that records how often selected words appear in chat messages.
It is designed as a light‑weight statistics tool, not a moderation bot.
All commands use the Interactions (slash command) API through discord.py.

---

📄 Features

• Tracks per‑user and per‑guild counters for configured words.
• Updates totals automatically when a message contains one or more tracked words.
• /swearjar — show personal and total counts.
• /sweartop — leaderboard of top users per server or global.
• /swearwords — view the most frequently detected words.
• /privacy — view, delete, or re‑enable data tracking.
• Periodic status update that displays the global total of detected words.

---

⚙️ Technical Overview

• Language: Python 3.11+
• Library: discord.py 2.4+
• Database: SQLite (swearjar.db)
• Gateway Intents:
  • message_content: enabled
  • guilds: enabled
  • members: disabled
  • presences: disabled