Dashboard (/dash)

Steps to view leveling stats, configure system profiles, and manage data.

How to check Leveling Stats

1. Type /dash in any text channel and press Enter.
2. The bot sends an interactive message panel. Click the **Stats & Levels** button.
3. The embed changes to display your current level, accumulated XP, progress percentage, and server rank position.

How to browse Settings Panels

Inside the /dash panel, click the tabs located below the main text area. You can switch between **System Profiles (Plurality)**, **Leveling Metrics**, and **Data Management** dynamically.

Plurality Module

Create system members, adjust trigger tags, upload avatars, and configure auto-proxying.

What it does

It allows plural systems and roleplayers to register multiple member identities (each with a unique name and avatar). When you write a message wrapped inside designated triggers (like [hello]), NEBOT deletes your post and sends it representing the member instead.

How to Add a Member

1. Run the /dash command.
2. Click the **Plurality** tab button in the menu layout.
3. Click the green **Add Member** button.
4. A Discord text input modal will open. Fill out the following fields:
   • **Member Name**: The display name for your member profile.
   • **Proxy Prefix**: The opening tag character (e.g. [ or m:).
   • **Proxy Suffix**: The closing tag character (e.g. ]). Leave blank if using a prefix trigger only.
   • **Avatar URL**: Public URL linking to your display image.
5. Click **Submit**.

How to Change a Proxy Tag

1. Run the /dash command and open the **Plurality** tab.
2. Select the target member profile from the dropdown menu list.
3. Click the **Edit Member** button.
4. In the modal window, change the **Proxy Prefix** and **Proxy Suffix** fields to your new desired characters. For example, to change from [text] to {text}, set prefix to { and suffix to }.
5. Click **Save**.

How to Upload/Set an Avatar

1. Upload your display image to a public hosting site (e.g. Imgur) or copy a link directly from an existing Discord message asset (must end in `.png`, `.jpg`, or `.webp`).
2. Run the /dash command and open the **Plurality** tab.
3. Select your member profile and click **Edit Member** (or click **Add Member** for a new profile).
4. Paste the direct image link into the **Avatar URL** text box.
5. Click **Submit** or **Save**.

How to Enable Auto-Proxy

1. Run the /dash command and select the **Plurality** tab.
2. Select the target member profile.
3. Locate the **Auto-Proxy** option.
4. Click the button toggle to change its state:
   • **Enabled**: Any normal message you type without triggers will automatically proxy as this member.
   • **Disabled**: Messages only proxy when wrapped inside the member's prefix/suffix tags.

Music & Interactive Games

Stream audio tracks and play turn-based minigames.

Music Module

Stream voice room audio. All control operations use buttons under the active track card:

1. Type /play query:<song name or web url> in a text channel while sitting inside a voice room.
2. The bot joins and prints an active song card with control buttons:
   • **Pause/Resume**: Stop or start the active playback.
   • **Skip**: Vote to advance to the next song queue slot.
   • **Stop**: Clear the track queue, halt music, and disconnect the bot.

Interactive Games

• Minesweeper Module: Run /minesweeper mines:<count>. Tap grid buttons to reveal cell numbers or set markers. Avoid cells containing hidden mines.
• Battle Game Module: Run /battle user:<target>. Take turns choosing actions (Attack, Block, Heal, Charge) using buttons to deplete the enemy HP pool.

Self Roles Module

Toggle assignable server roles using interactive menus.

How to assign yourself roles

1. Navigate to the designated role channel.
2. Select a role category from the dropdown menu (e.g. Pronouns or Notification lists).
3. Click the button corresponding to the role you want to add.
4. To remove the role, click the same button again. The interface updates instantly.

Privacy & Data Control

Encryption standards and complete database purge details.

Data We Collect

NEBOT logs only basic metrics needed to track leveling XP progress, warning tallies, and plural member tags. All database files are fully encrypted at rest using ZFS dataset encryption on our TrueNAS host environment.

How to Delete Your Data

1. Type /delete-my-data in any chat box and press Enter.
2. A confirmation prompt will appear. Click the red **Confirm Deletion** button.
3. The bot purges your leveling ranks, custom Plurality members, tag profiles, and infraction points permanently.

Bot Setup & Inviting

Steps to invite NEBOT and configure Discord permissions.

Inviting the Bot

1. Click the **Invite the Bot** button at the top-right of this page.
2. Select your target server from the dropdown selector and click Authorize.

Required Scopes & Setup

Grant the following checks during invite verification: Manage Roles (for auto-roles and verification gates), Manage Channels (for dynamic room names), and Moderate Members (for timed warning timeouts).

Admin & Mod Dashboards

Manage configurations, enable modules, and manage warning queues.

Admin Dashboard (/admin)

This is the central configuration dashboard for server administrators. Use it to toggle modules, bind verification roles, and adjust parameters:

1. Type /admin in any text channel.
2. An menu overlay loads. Click **Module Settings** to toggle bot features (Verification, Auto-Roller, AutoMod, VC WR, Analytics, etc.) on or off.
3. Use tab switches to configure specific module properties.

Mod Dashboard (/mod)

Used by server staff to manage infractions and active queues:

1. Type /mod in chat.
2. Click **Infraction History** to search member warning logs.
3. Use the panel buttons to clear warning points, lift mutes, or quarantine accounts.

Verification Module

Create automated verification gates to restrict new accounts and screen server entrants.

How to Setup Verification

1. Type /admin and select the **Verification Module** settings tab.
2. Choose the **Verification Channel** from the text channel selector dropdown list.
3. Choose the **Verified Role** (this is the role granted to users when they verify, unlocking your server's standard channels).
4. Define a **Timeout Kick** value in seconds (e.g. 300). If a user joins and does not click verify within this duration, NEBOT kicks them. Set to 0 to disable timeouts.
5. Click **Save & Enable**. The bot will post the Verify button card in the designated channel.

Auto-Roller Module

Automatically assign default roles to joining members.

How to Setup Auto-Roles

1. Type /admin and select the **Auto-Roller Module** settings tab.
2. Select one or more server roles from the dropdown selector (e.g. @Member).
3. Click **Add Role** to save it to the auto-join list.
4. Click **Save Changes**. The roles will be applied to all new users immediately upon entry.

AutoMod Module

Set up anti-spam, username cleaning, and banned word filters.

How to Setup Filters

1. Type /admin and navigate to the **AutoMod Module** settings tab.
2. Configure filters:
   • **Spam Thresholds**: Enter the duplicate message rate limit (e.g. 5 messages in 3 seconds) to trigger automated mutes.
   • **Nickname Cleaner**: Toggle the cleaner switch to **ON** to force nickname formatting rules on join.
   • **Banned Words**: Enter keywords or trigger lists into the block list text box and click **Update List**.
3. Select the default logging channel from the dropdown list to receive deleted message alerts.
4. Click **Save & Activate**.

Warning Tracker Module

Log warnings, check infraction histories, and set up automatic escalation rules.

What it does

Tracks infractions assigned to server members. Administrators can define warning thresholds that automatically trigger timeouts, kicks, or bans.

How to Customize Warning Escalations

1. Type /admin and navigate to the **Warning Tracker** settings tab.
2. Select your **Escalation Mode**:
   • **Static**: Fixed punishment values per warning point.
   • **Progressive**: Mute durations increase exponentially with each warning.
3. Locate the **Escalation Thresholds** list. Click **Add Escalation**:
   • Enter the target warning point count (e.g. 3 warnings).
   • Select the automated action from the dropdown menu (e.g. **Mute/Timeout**).
   • Set the duration parameter (e.g. 60 minutes).
4. Add another escalation block for higher counts (e.g. 5 warnings = **Kick**).
5. Click **Save Settings**.

Infraction Commands

• /warning user:<target> reason:<text>: Log a warning point.
• /warning-view user:<target>: List infraction logs.
• /warning-delete user:<target> [count]: Delete warning points.

VC WR Module

Restricts voice text channel access to users actively sitting in the voice channel.

How to Setup Write-Restrictions

1. Type /admin and navigate to the **VC WR Module** settings tab.
2. Select the target voice channel from the dropdown list.
3. Toggle the write-restriction switch to **ON**.
4. Click **Save Changes**. The bot will block permissions for the room's associated text channel, permitting message transmission only from users active in the voice channel.

Server Analytics Module

Log server member growth and traffic trends.

How to View Reports

1. Type /analytics in chat to generate the latest report card.
2. The embed displays stats: daily join counts, leave rates, and channel message frequency lists.
3. To toggle logging on/off, open the /admin panel, select the **Analytics** tab, and toggle the log compiler switch.

Join Filtering Module

Evaluate joining account ages and filter suspicious usernames.

How to Setup Join Screening Rules

1. Type /admin and navigate to the **Join Filtering** settings tab.
2. Configure screening parameters:
   • **Minimum Account Age**: Enter a value in hours (e.g. 24). Accounts newer than this are flagged.
   • **Username Filter Keywords**: Add matching wildcard strings (e.g. *spambot*) or regular expressions (r:^bot[0-9]+).
3. Select the automated **Enforcement Action** from the options list:
   • **Kick**: Kick the account from the server.
   • **Ban**: Permanently ban the account.
   • **Quarantine**: Keep the member in the server but restrict access and ping moderators in log channels.
   • **Bypass**: Log the incident but allow entry.
4. Click **Save and Apply**.

Nebuff Funny Module

Converts chat height and length mentions to custom height units.

Unit Conversion

Its funny dont worry, Just, Its funny