# 📊 ServerAutoAnalytics

> **The fully automatic server statistics bot --- set it once, forget it
> forever.** No dashboard. No manual refresh. No bloat. Just clean,
> professional stats updated every 30 minutes.

------------------------------------------------------------------------
---

## ⚠️ Important

### Recommended setup

For the best experience, it is recommended to grant the bot the **Administrator** permission.

Alternatively, you can manually configure permissions and ensure the bot has **View Channel access to the channels you want to track**.

### Required permissions (statistics channel)

For **ServerAutoAnalytics** to display statistics in the configured channel, the bot must have the following permissions:

• View Channel  
• Send Messages  
• Embed Links  
• Read Message History  

### Activity tracking

To correctly track **messages and voice activity**, the bot must be able to **see the channels you want to include in the statistics**.

If the bot cannot see a channel, activity from that channel will **not be counted**.  
This will **not break the bot**, but statistics may be incomplete.

---
------------------------------------------------------------------------

## ✨ What does it do?

ServerAutoAnalytics silently watches your server **24/7** and displays a
beautiful, auto-updating statistics embed directly in the channel of
your choice.

Every **30 minutes**, the embed refreshes automatically with fresh data
across **7 categories** --- no commands needed, no maintenance required.

------------------------------------------------------------------------

## 📈 Statistics Categories

### 🌐 Global

Complete snapshot of your server at a glance --- total members, bots,
channels, roles, boost level and active boosters, server creation date.

### 👥 Community

Track your server's growth in real time. Members joined and left this
month, net balance, retention rate (30 days), historical member peak,
and your **top inviter** with their percentage of total valid invites.

### 💬 Activity

Find out where and when your server is most active. Most active text
channel, most used voice channel (in minutes), total messages and voice
minutes over 30 days, daily message average, peak hour of the day, and
most active day of the week.

### 🏆 Top 5 Active Members

The five most active members ranked by a combined score of messages sent
and time spent in voice --- with their message/voice ratio displayed for
each.

### 🔨 Moderation

Full sanction breakdown: bans, kicks and timeouts over the last 30 days,
overall sanction rate, and the most sanctioned member (name only, no
ping).

### 📈 Growth

Month-over-month growth comparison and your server's best historical
growth month --- so you always know if your community is trending up or
down.

### 🎭 Roles

Top 3 most assigned roles and the number of members with no role
assigned.

------------------------------------------------------------------------

## ⚙️ Fully Automatic

Once configured, **everything runs on its own:**

-   Stats embed refreshes every **30 minutes**
-   Data older than **90 days** is automatically archived and deleted
-   Before any deletion, a detailed **`.zip` archive** is sent to the
    server owner via DM with a full day-by-day breakdown
-   The owner can choose to **opt out** of archive DMs at any time with
    a single button click

------------------------------------------------------------------------

## 🛠️ Setup --- 3 commands, done forever

/setrole @YourRole → Who can configure the bot (server admin only)\
/config langue FR\|EN → Choose French or English\
/config salon #channel → Where to display the stats

That's it. The embed appears immediately and updates itself from that
point on.

------------------------------------------------------------------------

## 💬 Commands

  Command            Description                 Permission
  ------------------ --------------------------- ----------------------
  `/setrole @role`   Set the bot admin role      Server administrator
  `/config langue`   Switch language (FR / EN)   Configured role
  `/config salon`    Set the stats channel       Configured role
  `/help`            Full usage guide            Configured role

> All command responses are **ephemeral** --- only you can see them. No
> clutter in your channels.

------------------------------------------------------------------------

## 🌍 Bilingual --- FR & EN

Every message, every embed field, and every DM is fully translated.\
Switch languages at any time with `/config langue` --- the embed updates
automatically.

------------------------------------------------------------------------

## 🔒 Privacy & Data

-   All data is stored **locally**, one JSON file per server --- no
    external database, no third-party access
-   Data is automatically purged after **90 days**
-   Server owners receive a full archive before any deletion and can opt
    out of future archives
-   The bot never pings members, never posts unsolicited messages, and
    never reads message content beyond counting

------------------------------------------------------------------------

*ServerAutoAnalytics --- Built for server owners who want real insights
without the complexity.*


ServerAnalytics

Automatic Discord server analytics — clean stats, zero dashboard, auto-updated every 30 minutes

Voto per ServerAnalytics

Do you want to support us?