Getting Started
Requirements: Bot needs View Channels, Send Messages, Embed Links. Optional: Manage Messages, Manage Webhooks, Manage Roles.
Install
- Invite the bot and select your server.
- Grant the required permissions.
- Run /setlogs and pick your staff log channel.
Verify
- Run /status or /ping.
- Have a friend join; a JoinSpy log embed should appear.
Commands
| Command | Description | Permission |
|---|---|---|
| /audit | Recent joins / moderation audit. | Manage Server |
| /ban | Ban a member with optional reason. | Ban Members |
| /globalrep | Show a user's global reputation (-100 to 100). | Moderate Members |
| /help | Help menu. | Everyone |
| /kick | Kick a member. | Kick Members |
| /leaderboard | Server leaderboard (invites/engagement). | Everyone |
| /lookup | Profile: inviter (if available), reputation, watchlist. | Moderate Members |
| /metrics | Global counters. | Owner/Admin |
| /ping | Latency/status check. | Everyone |
| /postupdate | Post changelog/update. Owner | Owner/Admin |
| /setlogs | Select the logs channel. | Manage Server |
| /stats | 7‑day join analytics and trends. | Everyone |
| /status | System status embed. | Everyone |
| /timeout | Apply Discord timeout. | Moderate Members |
| /watchlist add/remove | Manage local watchlist. | Manage Server |
Reputation System
- ❌ -100 to -75: High Risk
- ⚠️ -74 to -50: Suspicious
- 🟡 -49 to 0: Neutral
- 🟢 1 to 50: Trusted
- ✅ 51 to 75: Highly Trusted
- 🌟 76 to 100: Veteran
Watchlist
- /watchlist add @user reason
- /watchlist remove @user
- /watchlist list
Global watchlist access may require approval.
Logging & Alerts
- Configure with /setlogs.
- Join logs include inviter (if available), account age, reputation, and watchlist hits.
Privacy & Data
- Stored: user IDs, join metadata, reputation values.
- Not stored: message content.
- Global sharing is opt‑in.
Troubleshooting
- Bot not responding → check permissions & role position; try /status.
- No logs → re-run /setlogs and ensure the bot can Embed Links.
Changelog
Release notes are posted via /postupdate in the support server.