Setup & Configuration Guide

Complete guide to setting up and configuring Nexi Bot for your Discord server.

Quick Start: Use /setup for an automated configuration wizard, or follow this detailed guide for manual setup.

Initial Bot Setup

1. Adding Nexi Bot to Your Server

  1. Get Invite Link: Use /utility invite or visit our website
  2. Select Server: Choose your Discord server from dropdown
  3. Permissions: Ensure "Administrator" is selected for full functionality
  4. Authorize: Click "Authorize" and complete verification
  5. Verify Addition: Check that Nexi Bot appears in your member list

2. Quick Setup Process

Run Setup Wizard:

/setup

This configures:

  • Basic welcome and farewell messages
  • Essential moderation settings
  • Logging channels for server activity
  • Permission verification and fixes

3. Main Configuration Access

Open Configuration Panel:

/config

The interactive panel allows you to:

  • Toggle features on/off
  • Set up channels for different functions
  • Configure premium integrations
  • Manage API keys (Premium)
  • Export/import configurations (Premium)

Core Feature Setup

Welcome & Farewell System

  1. Enable Feature: /config → Features → "Welcome System"
  2. Set Channel: Select channel for welcome messages
  3. Customize Messages: Edit welcome and farewell text
  4. Add Images: Upload custom welcome images (Premium)
  5. Test System: Have someone join/leave to verify

Moderation System

  1. Permission Check: Ensure bot role is above member roles
  2. Enable Logging: Set up moderation log channel
  3. Configure Auto-Mod: Set up automatic rule enforcement
  4. Set Mute Role: Create or assign role for muted members
  5. Test Commands: Try /moderation warn on test user

Music System Setup

  1. Voice Permissions: Grant "Connect" and "Speak" in voice channels
  2. Music Channel: Optionally restrict music commands to specific channel
  3. Volume Limits: Set default and maximum volume levels
  4. Queue Settings: Configure maximum queue length
  5. Test Playback: Join voice channel and try /music play

Server Statistics

  1. Enable Feature: Turn on in /config → Features
  2. Configure Counters: Set up member count, online count displays
  3. Position Channels: Arrange stat channels at top of server
  4. Update Frequency: Choose how often stats refresh
  5. Custom Stats: Add custom counters (Premium)

Advanced Configuration

Premium Integrations

Google Calendar Setup:

  1. Create Google Cloud Project: Visit Google Cloud Console
  2. Enable Calendar API: Activate Google Calendar API
  3. Create Credentials: Generate service account key
  4. Add to Bot: Paste credentials in /config → API Keys
  5. Test Integration: Create test event to verify connection

Roblox Integration:

  1. Get Roblox API Key: From Roblox Cloud Console
  2. Configure Groups: Set up group management permissions
  3. Add Credentials: Enter API details in bot configuration
  4. Test Verification: Use /roblox to verify account linking
  5. Set Up Roles: Map Roblox ranks to Discord roles

ERLC Integration:

  1. Obtain ERLC API Access: Contact ERLC administrators
  2. Configure Server Details: Set up server connection info
  3. Test Commands: Verify /erlc commands work correctly
  4. Set Permissions: Configure who can use ERLC features
  5. Monitor Activity: Set up logging for ERLC actions

Analytics Configuration (Premium)

  1. Enable Analytics: Turn on in premium features
  2. Data Collection: Choose what metrics to track
  3. Report Frequency: Set up automated report generation
  4. Export Settings: Configure data export formats
  5. Privacy Settings: Set data retention and sharing preferences

Channel and Role Configuration

Essential Channels

  • Welcome Channel: Member join/leave messages
  • Moderation Logs: Automated moderation actions
  • General Logs: Server activity tracking
  • Bot Commands: Dedicated channel for bot usage
  • Appeals Channel: Ban appeal submissions (Premium)

Important Roles

  • Muted Role: For temporary member restrictions
  • Auto Roles: Automatically assigned to new members
  • Level Roles: Rewards for active members
  • Premium Roles: Special access for premium features
  • Staff Roles: Moderation and administration access

Permission Configuration

Recommended Bot Permissions:

  • Administrator (simplest, full functionality)
  • OR specific permissions:
    • Manage Server, Manage Roles, Manage Channels
    • Moderate Members, Manage Messages
    • Read/Send Messages, Embed Links, Attach Files
    • Connect/Speak (for music), Use Voice Activity

Backup and Data Management

Configuration Backup (Premium)

  1. Export Config: Use /config → "Export Configuration"
  2. Save File: Download and store backup file securely
  3. Document Changes: Keep notes on customizations
  4. Test Restore: Verify backup can be imported correctly
  5. Schedule Backups: Set up regular backup reminders

Server Migration

  1. Export Configuration: Create backup from original server
  2. Invite Bot: Add Nexi Bot to new server with full permissions
  3. Import Settings: Upload configuration backup
  4. Verify Setup: Check all features transferred correctly
  5. Update Integrations: Reconfigure external API connections
Setup Complete! Your bot should now be fully configured. Use /config anytime to adjust settings or add new features.