This project tracks any action done through its functionality to keep accountability on your staff

Audit Logs

Whether the current project contains any paid features, is paid only, or is 100% free to use.

This project is free to use and contains no paywalls for core functionality.

Has Paid Features


# 🛡️ Ryvex — Moderation You Can Audit, Trust, and Control

**Ryvex** is a **moderation-first Discord bot** built for servers that take  
**staff accountability, transparency, and long-term stability** seriously.

Ryvex is not another bloated “all-in-one” bot.  
It is a **structured moderation platform** designed to make every action  
**clear, traceable, and fair** — for both members *and* moderators.

If moderation matters in your server, Ryvex was built for you.

---

## 🎯 Who Ryvex Is For

Ryvex is designed for:

- Medium to large Discord servers
- Communities with **multiple moderators**
- Server owners who want **visibility and control**
- Teams that value **consistency over chaos**

If you want a casual, set-and-forget bot, Ryvex is probably not for you —  
and that’s intentional.

---

## 🧾 Case-Based Moderation — Transparency First

Every moderation action creates a **persistent case**:

- ⚠️ Warnings
- ⏳ Timeouts
- 👢 Kicks
- 🔨 Bans & unbans
- 🤖 AutoMod punishments
- 🔒 Channel & role enforcement

Each case records:
- Who acted
- Who was affected
- Why it happened
- When it happened
- Duration (when applicable)

Nothing is hidden. Nothing is overwritten.  
Perfect for **staff accountability, appeals, and audits**.

---

## 🤖 Smart AutoMod — Predictable, Not Random

Ryvex includes a **fully configurable AutoMod system** that protects your server from:

- 🚫 Spam
- 🔗 Unauthorized links
- 🤬 Offensive language (built-in + custom lists)

### What makes Ryvex AutoMod different?

- Unified warning counter across **all AutoMod triggers**
- **Escalating punishments that don’t reset**
- Quick presets: **Soft / Medium / Strict**
- Channel & role bypass support
- Optional **warn-only mode**

Members always know **where they stand**.  
Moderators always stay **in control**.

---

## 📊 Advanced Logging — Privacy Aware by Design

Ryvex uses a **dual logging system**:

- 📜 General server logs
- 🛡️ Moderation-only logs

Key features:
- Privacy-aware message logging
- Safe audit-log usage
- No duplicate or spammy logs
- Clear separation between events and moderation actions

Logging works **with Discord’s permission model**, never against it.

---

## 🧑‍⚖️ Staff Accountability & Monitoring

Ryvex includes **built-in staff oversight tools**:

- 📊 Staff activity dashboards
- 🧾 Moderator action summaries
- 🚨 Optional detection of unusual moderation patterns
- Full historical audit trail

Ryvex helps teams **self-regulate**, not police blindly.

---

## �️ Anti-Raid Protection

Protect your server from mass join attacks:

- Configurable join-rate thresholds
- Automatic detection and response
- Integrates with logging system

---

## �💤 AFK System — Stay Informed

- Set yourself AFK with `/afk [reason]`
- Automatically removed when you send a message
- Anyone who mentions you gets a notification with your AFK reason

---

## 🎭 Reaction Roles — Button-Based Self-Assignment

Create clean, button-based role panels — no emoji reactions needed.

- Custom embed title and description
- Add or remove roles per panel
- Members click a button to toggle roles

---

## 📊 Leveling / XP System — Engage Your Community

- Members earn XP per message (configurable range and cooldown)
- Level-up announcements with optional dedicated channel
- Automatic role rewards on level-up
- Server leaderboard with paginated display
- Full admin control: set, reset, ignore channels/roles

---


## 🎂 Birthday & Anniversary System (NEW in v1.10.2)

- User command: `/birthday set`, `/birthday me`, `/birthday today`
- Admin command: `/admin-birthday enable`, `/admin-birthday disable`, `/admin-birthday channel`, `/admin-birthday message`, `/admin-birthday config`
- Daily birthday announcements with random or custom messages
- Per-guild config: enable/disable, channel, message, reset
- Modern, branded embeds for all birthday features

---

## 🎨 Rich Interactive Dashboards

Every informational command uses **multi-page interactive embeds** with ◀ ▶ navigation:

- `/botinfo` — 3 pages: Overview, Live Stats, Links & Info
- `/userinfo` — 3 pages: Identity, Moderation Snapshot, Leveling
- `/staff` — 3 pages: Overview, Leaderboard, Recent Activity
- `/changelog` — Timeline overview + per-release pages with stats
- `/setup` — 17-page interactive guide
- `/settings` — 10-page interactive dashboard
- `/rules` — Paginated display (3 per page)
- `/history` commands — Enriched entries with reason, timestamp, and duration

No clutter. No walls of text. Clean, navigable information.

---

## ⏱️ Slowmode

- `/slowmode <seconds>` — set channel slowmode as a logged moderation action

---

## 🛡️ Built for Stability & Reliability

- All systems wrapped in crash protection with null-safe database calls
- Global error handlers prevent unexpected downtime
- Automatic memory management for long uptime
- AutoMod runs before XP — deleted messages never earn rewards
- Anti-raid kick targets all joiners, lock auto-restores after cooldown
- Slow commands use deferred replies — no silent timeouts
- No crashes, no silent failures
- **All embeds restyled for modern, branded look (v1.10.2)**
- **Fixed all ephemeral: true deprecation warnings (now uses MessageFlags.Ephemeral)**
- **Fixed JSON parse errors for empty/corrupt files**
- **Fixed double reply/deferReply issues in `/botinfo`**

---

## ⚙️ Guided Setup — No Guesswork

Ryvex includes a **guided `/setup` dashboard** that shows:

- What is configured
- What is missing
- What is recommended
- Exactly which commands to run next

Nothing is changed automatically.  
Setup is **safe, visual, and repeatable**.

---

## 🧠 Built for Stability & Scale

- Modern slash commands only
- MongoDB-backed persistence
- Graceful permission fallbacks
- No crashes, no silent failures
- Designed to scale with growing communities

---

## 🔑 Key Commands (Quick Start)

- `/setup` — guided configuration
- `/settings` — server configuration overview
- `/automod` — AutoMod control & status
- `/case` — moderation case management
- `/modlog` — moderation history
- `/staff` — staff accountability dashboard
- `/slowmode` — set channel slowmode
- `/antiraid` — anti-raid protection config
- `/afk` — set yourself AFK with notifications
- `/reactionrole` — create button-based role panels
- `/rank` — view your level and XP
- `/leaderboard` — server XP leaderboard
- `/xp` — admin XP/leveling configuration
- `/review` — leave a review on Top.gg

---

## 🧩 Why Choose Ryvex?

✅ Rich interactive dashboards with page navigation  
✅ Anti-raid protection  
✅ Transparent moderation  
✅ Predictable AutoMod behavior  
✅ Full audit trail  
✅ Privacy-aware logging  
✅ Built for real moderation teams  
✅ AFK system with smart notifications  
✅ Button-based Reaction Roles  
✅ Leveling/XP system with role rewards  
✅ Crash-proof — never goes down unexpectedly  
✅ 54 slash commands and growing  

Ryvex doesn’t just moderate — it **documents, explains, and protects**.

---

## 🚀 Ready to Take Control?

Add Ryvex to your server and build moderation you can  
**trust, audit, and scale**.

If you want clarity instead of chaos —  
**Ryvex is built for you.**

Ryvex

Ryvex™ — Moderation Built on Accountability

Voter pour Ryvex

Tu veux nous soutenir ?