πŸ›‘οΈ
Nuvon
v.0.5
Official Documentation

Welcome to Nuvon

A powerful, cross-server moderation bot built for Discord communities. Configure, sync, and protect β€” all in one place.

0Commands
0Core Systems
0Events
∞Servers
βš™οΈSetup
1.1

Inviting the Bot

Adding Nuvon to your Discord server takes less than a minute. Follow the steps below to get started.

πŸ”—
Invite Link
Use the official invite link from our website or the /invite command. Make sure you are a server administrator before proceeding.

Required Permissions

Nuvon requires the following permissions to function correctly. Granting them during the invite process is strongly recommended:

πŸ”¨Ban Members
πŸ‘’Kick Members
πŸ—‘οΈManage Messages
⏱️Moderate Members
⚠️

Without these permissions, some or all moderation commands will fail silently or return an error. Always verify the bot role's permissions after inviting.

Steps to Invite

  1. Click the official Nuvon invite link.
  2. Select the target server from the dropdown.
  3. Review and confirm the requested permissions.
  4. Complete the authorization process.
  5. Run /ping in your server to verify the bot is online.
1.2

Language Customization

Nuvon supports multiple languages, allowing each server to interact with the bot in their preferred language.

Language settings are applied per-server, meaning you can run multiple servers with Nuvon in entirely different languages simultaneously. The bot's responses, error messages, and embeds will all reflect the selected language.

🌐
Setting a Language
Use the Web Dashboard or the bot's configuration commands to select your preferred language. Changes take effect immediately β€” no restart required.

Supported Languages

πŸ‡ΊπŸ‡Έ EnglishπŸ‡©πŸ‡ͺ German+ More
1.3

Bot Configuration

Nuvon offers a rich set of configuration options to tailor its behavior to your server's unique needs.

Every setting is stored per-guild, ensuring total isolation between your different servers. Configuration can be done via the web dashboard or directly through commands in Discord.

Per-channel log destinations
Automated moderation thresholds
Role-based command access control
Custom punishment escalation rules
Anti-ping sensitivity controls
1.3.1

Web Dashboard

The Nuvon Web Dashboard provides a visual, intuitive interface for configuring every aspect of the bot without ever touching a command.

Log in using your Discord account via OAuth2. Once authenticated, you'll see all servers where Nuvon is present and you have administrative access.

βœ… What You Can Do

  • β€ΊConfigure moderation sync groups
  • β€ΊView audit logs and moderation history
  • β€ΊAdjust language and locale settings
  • β€ΊEnable or disable specific modules

πŸ” Access Requirements

  • β€ΊServer Administrator role or equivalent
  • β€ΊNuvon must be present in the server
  • β€ΊActive Discord account (OAuth2)
  • β€ΊBrowser with JavaScript enabled
1.3.2

Auto Systems

Nuvon's automated systems proactively protect your server by detecting and responding to threats without manual intervention.

πŸ€–

Spam Detection

Nuvon monitors message frequency and content patterns in real time. When a user exceeds configured thresholds, the bot automatically issues a timeout, deletes the offending messages, and logs the action.
βš–οΈ

Moderation Automation

Define escalation rules so repeated minor infractions automatically result in stronger punishments β€” from warnings to kicks to bans β€” reducing moderator fatigue and ensuring consistent enforcement.
πŸ””

Real-time Alerts

Whenever an automated action is triggered, Nuvon posts a detailed embed to your designated log channel, keeping your mod team informed at all times.
1.3.3

Individual Settings

Fine-tune Nuvon's behavior at a granular level for each server independently.

Individual settings allow server admins to define exactly how Nuvon behaves in their community. These settings are isolated β€” a change in one server never affects another.

SettingDescriptionDefault
log_channelChannel for all moderation log embedsNone
mod_roleRole required to use moderation commandsAdmin only
anti_pingEnable or disable the Anti Ping SystemEnabled
auto_modEnable or disable automated moderationDisabled
languageBot response languageEnglish
πŸ’¬Commands
2.1

Command List

All Nuvon commands are slash commands (/). Below is a full reference, organized by category.

Moderation
/ban

Permanently bans a user from the server. Removes them from the member list and prevents rejoining until manually unbanned.

PermanentDM Notified
/kick

Removes a user from the server immediately. They retain the ability to rejoin via an invite link.

Non-permanent
/purge

Bulk-deletes a specified number of messages from a channel. Useful for cleaning up spam or rule violations.

Bulk ActionLogged
/softban

Bans and immediately unbans a user, effectively deleting their recent messages without permanently removing their access.

TempMessage Purge
/timeout

Temporarily restricts a user from sending messages or joining voice channels for a specified duration.

Time-limitedReversible
/timeout-remove

Removes an active timeout from a user early, restoring their ability to interact before the duration expires.

Reversal
/unban

Lifts a permanent ban, restoring a user's ability to rejoin the server via an invite link.

Restores Access
/multiban

Bans multiple users simultaneously by providing a list of user IDs. Ideal for raid protection.

Bulk ActionAnti-Raid
Bot
/help

Displays all available commands along with descriptions, required permissions, and usage examples.

Public
/ping

Returns the bot's current latency to the Discord API, useful for diagnosing performance or connectivity issues.

PublicDiagnostic
Utility
/invite

Provides the official Nuvon invite link so you can easily add the bot to another server.

Public
/setnick

Changes the nickname of a specified user or the bot itself within the current server.

Manage Nicknames
/slowmode

Sets or clears slowmode on a channel, controlling the interval between messages a user can send.

Channel Control
πŸ›‘οΈCore Features
3.1

Moderation Sync

Nuvon's flagship feature β€” synchronize moderation actions across multiple servers in real time.

Moderation Sync allows server networks or community groups to share their moderation history. When a ban, kick, timeout, or unban is issued in one server, it can be automatically propagated to all other servers in the same sync group.

πŸ”„

Cross-Server Synchronization

Create sync groups in the dashboard and link your servers together. Nuvon handles the rest β€” no manual coordination required between moderators.

Synced Actions

πŸ”¨Bans
πŸ‘’Kicks
βœ…Unbans
⏱️Timeouts
πŸ’‘
Sync Groups
A sync group is a collection of servers that share moderation data. You can create multiple isolated groups β€” for example, one group for public servers and another for private staff servers.
3.2

Log System

Every moderation action taken by Nuvon is recorded and delivered as a rich embed to your server's designated log channel.

The Log System ensures full transparency and accountability. Whether an action was performed manually by a moderator or automatically by Nuvon's auto-mod, a detailed record is always created.

πŸ“‹ What Gets Logged

  • β€ΊAll ban, kick, and unban actions
  • β€ΊTimeouts (applied and removed)
  • β€ΊBulk message deletions via /purge
  • β€ΊAutomated anti-spam actions
  • β€ΊAnti-ping system triggers

πŸ“„ Log Entry Details

  • β€ΊTarget user (name + ID)
  • β€ΊResponsible moderator
  • β€ΊAction type and reason
  • β€ΊTimestamp and duration
  • β€ΊSource (manual vs automated)
πŸ“Œ

You must set a log channel using the dashboard or configuration commands before logs will be delivered. Without this, actions are still performed but not logged.

3.3

Anti Ping System

Protect your community members from mention spam and targeted harassment with Nuvon's intelligent Anti Ping System.

When a user mass-mentions other members or repeatedly pings specific individuals, Nuvon detects the pattern and takes action automatically. This system is especially effective against raid bots and harassment campaigns.

πŸ””

How It Works

  1. Nuvon monitors every message for mention patterns.
  2. If the number of mentions exceeds the configured threshold in a time window, the message is deleted.
  3. The offending user receives a timeout or is flagged for moderator review.
  4. A log entry is created and delivered to the log channel.

Configuration Options

ping_thresholdMaximum mentions allowed per message before action is taken
ping_actionAction to take: delete, timeout, or both
ping_whitelistRoles or users exempt from Anti Ping detection
ping_notifyWhether to notify the target users that they were protected
πŸ“‘Events
4.0

Events Overview

Nuvon listens to a wide range of Discord gateway events and logs them automatically to your configured log channel.

Events are real-time signals emitted by the Discord API whenever something happens in your server. Nuvon captures all of these and turns them into structured, readable log entries.

πŸ“‘

20 Tracked Events

Nuvon currently tracks 20 Discord gateway events across six categories: channels, guilds, members, messages, roles, and system events. Each event produces a detailed embed in your log channel.

πŸ’‘
Enabling Event Logs
Set a log channel via the Web Dashboard or /config log_channel #channel to start receiving event logs. You can also toggle individual event types on or off.

Event Categories

πŸ“ΊChannel3 events
🏰Guild5 events
πŸ‘€Member2 events
πŸ’¬Message2 events
🎭Role3 events
πŸ”§Other5 events
4.1

Channel Events

Track every structural change to channels within your server β€” creation, deletion, and modification.

CREATEchannelCreate
active

Fired whenever a new channel is created in the server β€” text channels, voice channels, categories, forum channels, and threads. The log entry includes the channel name, type, category it was placed in, and the user responsible.

Logged DataChannel name, type, category, creation timestamp, responsible user
DELETEchannelDelete
active

Fired whenever a channel is permanently deleted from the server. The log captures the channel's name, type, and ID before it disappears β€” useful for tracking accidental or unauthorized deletions.

Logged DataChannel name, ID, type, deletion timestamp, responsible user
UPDATEchannelUpdate
active

Fired whenever a channel's properties change β€” including name, topic, slowmode settings, NSFW status, permission overwrites, or category. The log shows a before/after comparison of the changed fields.

Logged DataChanged fields (before & after), channel name, responsible user, timestamp
4.2

Guild Events

Monitor server-level events including bans, server joins and leaves, and audit log entries.

MODguildAuditLogEntryCreate
active

Fired whenever a new entry is added to the server's audit log β€” covering all administrative actions performed by moderators and admins. This event gives Nuvon context for nearly every other action, allowing it to attribute changes to specific users.

Logged DataAction type, executor, target, reason, timestamp
BANguildBanAdd
active

Fired whenever a user is banned from the server β€” whether through a Nuvon command, another bot, or manually by a moderator. The log entry includes the banned user's details and the moderator responsible.

Logged DataBanned user (name + ID), moderator, reason, timestamp
UNBANguildBanRemove
active

Fired whenever a ban is lifted from a user. Nuvon logs who was unbanned and which moderator performed the action, providing a complete record of ban lifecycle events.

Logged DataUnbanned user (name + ID), moderator, timestamp
JOINguildCreate
active

Fired when Nuvon joins a new server or when the bot reconnects to an existing guild. This event is used internally to initialize server-specific configuration and register the guild in Nuvon's database.

Logged DataGuild name, ID, member count, owner, join timestamp
LEAVEguildDelete
active

Fired when Nuvon is removed from a server or when a server is deleted. This triggers a cleanup routine that archives the server's configuration data for a grace period before permanent deletion.

Logged DataGuild name, ID, leave timestamp, data retention notice
4.3

Member Events

Track member removals and profile changes within your server.

LEAVEguildMemberRemove
active

Fired whenever a member leaves or is removed from the server β€” including voluntary leaves, kicks, and bans. Nuvon cross-references the audit log to determine whether the removal was voluntary or action-based.

Logged DataMember name + ID, removal type (leave/kick/ban), timestamp, roles held at time of removal
UPDATEguildMemberUpdate
active

Fired whenever a member's server profile changes β€” including nickname updates, role assignments or removals, timeout application or removal, and communication disabled status.

Logged DataMember name + ID, changed fields (before & after), responsible moderator, timestamp
4.4

Message Events

Capture deleted and edited messages to maintain a full record of server communication.

DELETEmessageDelete
active

Fired whenever a message is deleted β€” whether by the author, a moderator, or Nuvon itself. If the message was cached, Nuvon logs the original content, the author, the channel, and who deleted it.

Logged DataMessage content (if cached), author, channel, deleting user, timestamp
⚠️

Messages not in Nuvon's cache may not include original content β€” only metadata will be logged in that case.

EDITmessageUpdate
active

Fired whenever a message is edited by its author. Nuvon logs the original content alongside the updated content, allowing moderators to review changes. Bot-initiated edits and embed-only updates are filtered out.

Logged DataOriginal content, updated content, author, channel, edit timestamp, message link
4.5

Role Events

Monitor role lifecycle changes including creation, deletion, and permission or appearance updates.

CREATEroleCreate
active

Fired whenever a new role is created in the server. The log includes the role's name, color, initial permission set, and the administrator who created it.

Logged DataRole name, color, permissions, hoisted status, mentionable, creator, timestamp
DELETEroleDelete
active

Fired whenever a role is permanently deleted from the server. Nuvon logs the role's last known properties before removal, providing a record in case the deletion was accidental.

Logged DataRole name, ID, permissions, deletion timestamp, responsible user
UPDATEroleUpdate
active

Fired whenever a role's properties are modified β€” including name, color, permissions, hoist status, or mentionability. The log entry provides a clear diff of exactly what changed and who made the change.

Logged DataRole name, changed fields (before & after), responsible user, timestamp
4.6

Other Events

Additional Discord events covering bot readiness, emoji changes, interactions, and invite tracking.

SYSTEMclientReady
system

Fired once when Nuvon successfully connects to the Discord gateway and is fully operational. Used internally to initialize all modules and register slash commands. Not logged to channels.

UsageInternal β€” initializes all Nuvon modules and confirms bot is online
CREATEemojiCreate
active

Fired whenever a new emoji is added to the server. The log records the emoji's name, image, and the administrator who uploaded it.

Logged DataEmoji name, image preview, creator, timestamp
DELETEemojiDelete
active

Fired whenever an emoji is removed from the server. Nuvon logs the emoji's name and ID so the removal can be tracked and reviewed for unauthorized deletion.

Logged DataEmoji name, ID, responsible user, timestamp
SYSTEMinteractionCreate
system

Fired whenever a Discord interaction is received β€” slash commands, button clicks, select menus, and modal submissions. This is the core event handler for all of Nuvon's slash commands. Handled internally.

UsageInternal β€” routes all slash commands and component interactions to their handlers
CREATEinviteCreate
active

Fired whenever a new invite link is created for the server. The log records the invite code, the channel it leads to, its expiry settings, max uses, and the member who created it.

Logged DataInvite code, target channel, creator, max uses, expiry, creation timestamp
DELETEinviteDelete
active

Fired whenever an invite link is deleted or expires. The log captures the invite code and associated channel so that invite lifecycle can be fully tracked within the server's audit trail.

Logged DataInvite code, target channel, deletion or expiry timestamp
πŸ“ŠDashboard
5.1

Dashboard Overview

The Nuvon Web Dashboard is your central control panel β€” a single interface to manage every bot setting across all your servers.

πŸ–₯️

One Panel. Every Server.

No more memorizing commands or digging through configuration files. The dashboard gives you a visual, form-based experience for every setting Nuvon offers.

Dashboard Capabilities

πŸŽ›οΈ

Visual Configuration

Toggle modules, set thresholds, assign roles, and configure channels β€” all through a clean, intuitive UI with no commands required.

πŸ“ˆ

Scalability

Manage dozens of servers from a single authenticated session. The dashboard scales effortlessly whether you operate one server or fifty.

πŸ”’

Secure Access

Login is powered by Discord OAuth2. Only users with server administrator permissions can view or modify that server's settings.

πŸ”„

Live Sync

Changes made in the dashboard are applied instantly. There's no delay, no restart, and no confirmation step needed β€” it just works.

πŸ“‹

Audit History

Browse your server's full moderation history with filtering by action type, moderator, or date range.

🌍

Multi-Language

The dashboard itself is fully localized. Switch the interface language independently from the bot's response language.

πŸš€
Getting Started
Visit the Nuvon website, click Dashboard, and log in with your Discord account. Your servers will appear automatically. Click any server to begin configuring.