Documentation

Everything you need to know about ServionShield - from setup to advanced features

Home / Documentation

Introduction

Welcome to the ServionShield documentation! ServionShield is a comprehensive Discord moderation and security bot designed to protect your server from spam, raids, and malicious activities while providing powerful management tools.

Key Features

  • AI-Powered Anti-Spam: Advanced machine learning algorithms detect and prevent spam
  • Auto Moderation: Customizable filters and automated punishments
  • Role Management: Intelligent role assignment and verification systems
  • Analytics Dashboard: Comprehensive server insights and statistics
  • Welcome System: Customizable welcome messages and auto-roles

Installation

Adding ServionShield to your Discord server is quick and easy.

Step 1: Invite the Bot

Note: You need "Manage Server" permissions to add bots to your Discord server.

  1. Click the "Invite Bot" button on our website or use this direct link
  2. Select your Discord server from the dropdown
  3. Review and approve the requested permissions
  4. Complete the Discord authorization

Required Permissions

ServionShield requires the following permissions to function properly:

Administrator: Recommended for full functionality Manage Server: Server configuration access Manage Roles: Role assignment and management Manage Channels: Channel creation and modification Kick Members: Moderation actions Ban Members: Moderation actions Manage Messages: Message moderation Read Message History: Context for moderation decisions

Quick Setup

Once ServionShield is added to your server, follow these steps to get started:

Initial Configuration

/initialize

This command will guide you through the initial setup process, including:

  • Setting up moderation channels
  • Configuring basic auto-moderation rules
  • Setting the command prefix (default: /)
  • Enabling essential protection features

Verify Setup

/ status

Check that all features are properly configured and functioning.

Success! Your server is now protected by ServionShield. The bot will automatically start monitoring for threats and suspicious activity.

Permissions Guide

Understanding Discord permissions is crucial for proper bot functionality.

Role Hierarchy

Important: ServionShield's role must be positioned above any roles it needs to manage. The bot cannot moderate users with roles higher than its own.

Permission Required For Essential
Administrator Full functionality Recommended
Manage Server Configuration access Yes
Kick Members Kick command Yes
Ban Members Ban command Yes
Manage Messages Message moderation Yes
Manage Roles Role management Yes

Basic Configuration

Command Prefix

/

The bot dose use prefix commands only slash commands/

Moderation Channel

/modlog #channel

Set the channel where moderation logs will be posted.

Welcome Channel

/welcome #channel

Configure the channel for welcome messages.

Auto-Role

/autorole @role

Set a role to be automatically assigned to new members.

Auto Moderation

ServionShield's auto-moderation system provides comprehensive protection against various threats.

Spam Protection

/ automod spam enable / automod spam sensitivity [low|medium|high]

Word Filters

/ filter add [word] / filter remove [word] / filter list

Link Protection

/ automod links enable / automod whitelist add [domain]

Invite Protection

/ automod invites enable

Automatically delete Discord invite links from non-moderators.

Role Management

Reaction Roles

/ reactionrole setup #channel message_id emoji @role

Set up reaction roles for self-assignment.

Temporary Roles

/ temprole @user @role [duration]

Assign temporary roles that automatically expire.

Role Persistence

/ config rolepersist enable

Restore user roles when they rejoin the server.

Welcome System

Welcome Messages

/ welcome message "Welcome {user} to {server}!"

Customize welcome messages with placeholders:

  • {user} - User mention
  • {username} - Username
  • {server} - Server name
  • {membercount} - Member count

Welcome Images

/ welcome image enable / welcome image template [template_name]

API Integration

ServionShield provides a REST API for external integrations.

Authentication

Authorization: Bearer YOUR_API_KEY

Get your API key from the dashboard: / dashboard

Base URL

https://api.ServionShield.com/v1

Common Endpoints

Endpoint Method Description
/servers/{id}/config GET Get server configuration
/servers/{id}/logs GET Get moderation logs
/servers/{id}/ban POST Ban a user

Troubleshooting

Common Issues

Bot Not Responding

  • Check if the bot is online (green status)
  • Verify the command prefix: /
  • Ensure the bot has necessary permissions

Cannot Moderate Users

  • Check role hierarchy - bot's role must be above target user's highest role
  • Verify moderation permissions (kick, ban, manage messages)
  • Check if the user has administrator permissions

Auto-Moderation Not Working

  • Ensure auto-mod is enabled: / automod status
  • Check channel permissions for the bot
  • Verify the bot can delete messages in the channel

Getting Help

If you need additional assistance:

  • Join our support Discord server
  • Email us at support@ServionShield.com
  • Check our FAQ section