Nexumi documentation

Overview

Nexumi combines moderation, community, utility, and integration features in a single bot, administered through a dashboard at https://dashboard.nexumi.de. It uses only Discord slash commands, context menus, buttons, select menus, and modals — there are no message prefix commands.

Key concepts you will see throughout this documentation:

• Modules — self-contained feature areas (Moderation, Tickets, Leveling, …) that are toggled per server.
• Commands — slash commands, most of which require specific Discord permissions.
• Dashboard — the web UI where server admins configure modules with live previews and validation.
• Cases & audit — a central case system records moderation actions; dashboard changes are audit-logged.
• Jobs — scheduled tasks (temp-bans, giveaways, reminders, feeds, birthdays) survive restarts because they run on a persistent queue.

Quick start

1. Invite the bot

Use the invite link and pick the server you manage. You need the Manage Server permission on that server to add the bot and to open the dashboard for it.

2. Check role position

Move the Nexumi role above the roles it should manage. Discord only lets a bot act on members and roles that sit below its own highest role — this affects moderation, autoroles, level rewards, and self roles.

3. Open the dashboard

Go to https://dashboard.nexumi.de, sign in with Discord, and select your server. Enable the modules you want and configure them. Changes show a sticky save bar; nothing is stored until you press Save.

4. Try it in Discord

Type /help in your server to get an auto-generated command overview grouped by module, or /info for version, uptime, and shard details.

Permissions & access

Nexumi enforces permissions in two layers before any action runs:

• Discord permissions — each command requires the matching native permission (e.g. /ban needs Ban Members, /purge needs Manage Messages).
• Dashboard access rules — you can additionally grant roles access to specific dashboard modules (for example, mods may only see Moderation and Tickets).

Destructive actions (ban, purge, backup restore, leaving the server) always require a confirmation and are written to the audit/case system. Administrative command replies are ephemeral by default, so only the person who ran them sees the result.

Command controls

On the Commands dashboard page you can, per command:

• Enable or disable it entirely.
• Allow or block it in specific channels or for specific roles.
• Set a cooldown. Disabled commands and cooldown hits reply ephemerally.
• Apply global channel whitelists/blacklists across all commands.

Web dashboard

The dashboard at https://dashboard.nexumi.de is where most configuration happens. Sign in with Discord OAuth2; you will only see servers where you have Manage Server (plus any servers granted through role-based access rules).

• Overview — activity charts (members, messages, voice), recent mod actions, and module status.
• Modules — enable/disable each module; disabled modules stop responding in Discord.
• Live previews — welcome cards, embeds, and message components render with your real server and user data.
• Command palette — press Ctrl/Cmd + K to jump to any page, command, or setting.
• Audit log — every dashboard change records who changed what and when.

Forms use inline validation and a sticky save bar (“You have unsaved changes”). Success is confirmed with a toast.

Core commands

Always available, in every server:

Moderation

A full moderation toolkit backed by a central case system. Every ban, kick, timeout, and warning creates a case with an ID you can look up, edit, or delete. Temp-bans automatically expire and unban via the job queue.

Auto-moderation

Rule-based automatic filtering. Each rule has its own action (delete, warn, timeout, kick, or ban), thresholds, and exceptions (roles and channels). Configure everything on the AutoMod dashboard page; use /automod status to list active rules in Discord.

Available filters

• Spam — too many messages in a time window.
• Mass mentions — excessive user/role mentions.
• Caps — high percentage of capital letters.
• Invite links — Discord invite links.
• External links — with whitelist/blacklist domains.
• Word filter — word lists and regex patterns (ships with a DE/EN default profanity list).
• Duplicate messages, emoji spam, and Zalgo text.
• Phishing/scam links — matched against continuously updated blocklists.

Beyond message filters, Nexumi includes anti-raid (join-rate detection with a lockdown/verification mode) and anti-nuke protection (action limits and automatic permission removal against mass bans or channel deletions).

Logging

Route server events to log channels. You can assign multiple event types to a single channel using a matrix editor on the Logging dashboard page, and maintain ignore lists for channels, roles, and bots.

Logged events include: message edited/deleted (with content), bulk delete, member join/leave, ban/unban, role and nickname changes, channel create/delete/update, voice join/leave/move, invite created, emoji/sticker changes, thread events, and server-setting changes. Mod-action logs are linked to the case system.

Verification

Gate new members behind verification before they gain access. Modes: button verify or captcha verify (via a dedicated web page). You can require a minimum account age and choose the action on failure (kick, ban, or none). Optional alt-account detection uses a salted IP hash and invite clustering — no browser fingerprinting.

Supported captcha providers: Math, reCAPTCHA v2/v3, hCaptcha, and Cloudflare Turnstile (only providers configured by the operator appear in the dashboard).

Welcome & goodbye

Greet new members and announce departures with text, a rich embed, message components, or a generated image card. Assign autoroles on join (separately for humans and bots) and optionally send a welcome DM. Use the placeholder system (see Placeholders) to personalize messages.

Leveling & XP

Reward activity with text and voice XP. Configure rates, cooldowns, and multipliers per role or channel, exclude no-XP channels and roles, and grant role rewards at level milestones (stacking or replacing). Level-up messages can go to a channel, DM, or be turned off. Rank cards are customizable.

Economy

A per-server virtual currency with income commands, a shop, and games. Currency name and symbol are configurable, and shop items can grant roles. Configure the shop and income amounts on the Economy dashboard page.

Fun & games

Lightweight games and media commands. API-based commands (memes, animals) can be disabled by the operator.

Giveaways

Run button-entry giveaways with automatic winner drawing and DM notifications. Requirements can include a role, a minimum level, and a minimum time as a server member. Overdue giveaways are recovered on restart.

Ticket system

Support tickets via panels with buttons or dropdowns and per-category support roles and opening forms (modals). Tickets open as a private channel or thread. HTML transcripts are viewable in the dashboard and can be DMed. Tickets auto-close on inactivity, with an optional rating prompt after closing.

Self roles

Let members assign their own roles. Modes: buttons, dropdown, or classic reactions. Behaviors: normal, unique (only one), verify (add-only), or temporary. The visual builder lives in the dashboard.

Starboard

Highlight popular messages. Configure the emoji, threshold, target channel, whether self-stars count, and ignored channels. NSFW channels are excluded. Starboard entries stay in sync when the original is edited or deleted.

Suggestions

Collect community suggestions with voting buttons and an optional discussion thread. Separate channels for open, approved, and denied suggestions keep things organized, and the submitter is notified on a decision.

Birthdays

Celebrate members with automatic birthday announcements and an optional 24-hour birthday role. Timezone-aware so greetings fire at the right local time.

Utility

Everyday helper commands and an embed/components builder.

Tags & auto-responders

Custom commands and canned responses. Tags can be plain text or embeds, support placeholders and simple variables (user, server, arguments, random), and can be limited to certain roles or channels. Optional auto-responders reply to trigger words automatically.

Temp voice (join to create)

Members who join a hub channel get their own temporary voice channel, controlled with /voice or a button panel. Channels are deleted automatically when empty.

Server stats & invites

Auto-updating stats channels (member count, online, boosts) and invite tracking (who invited whom, with fake/leave detection). Activity statistics feed the dashboard.

Social feeds

Post notifications for Twitch lives, YouTube uploads, RSS feeds, and Reddit. Each feed has a target channel, optional role ping, and a message template.

Scheduler & announcements

Scheduled one-off and recurring (cron-like) messages, plus an announcement command with embeds and role pings.

Backups

Back up your server structure — channels, roles, permissions, and settings (not messages). Restore is limited to the server owner and requires a double confirmation.

Placeholders

Message fields (welcome, tags, birthdays, leveling, feeds, and more) support placeholders that are replaced at send time:

Premium

Nexumi has Free and Premium tiers. Premium raises limits for certain resources. Tier limits are configured by the bot operator and assigned manually (no payment integration yet). Default limits:

When a limit is reached, the command or dashboard action explains that the tier limit was hit.

Privacy & GDPR

Nexumi is built to be GDPR-friendly. Log retention is configurable, the snipe module is off by default, and users can request data deletion.

See the Privacy policy and Terms of service for full details.

Support

Need help or found a bug? We are happy to assist.