Warden Bot - User Guide

Inviting Warden to Your Server

1. Visit the Warden website
2. Click "Add to Discord"
3. Select your server from the dropdown
4. Authorize the requested permissions
5. Warden is now in your server!

Accessing the Dashboard

1. Go to the Warden website
2. Click "Login with Discord"
3. Authorize the application
4. Select your server from the list
5. Start configuring!

Note: You must have Administrator or Manage Server permission to access the dashboard.

Dashboard Overview

• Quick Stats: Total members, active today, XP earned, warnings
• Configuration Modules: Click any module to configure it
• Server Settings: Bot prefix, language, timezone, and more

How XP Works

• Members earn XP by chatting in your server
• XP is awarded once per message (with a cooldown to prevent spam)
• As members accumulate XP, they level up
• You can assign roles automatically when members reach certain levels

Configuration Options

Setting Up Level Roles

1. Go to XP & Leveling in the dashboard
2. Scroll to "Level Roles"
3. Click "Add Level Role"
4. Enter the level and select the role
5. Click Save

Viewing the Leaderboard

Use the /leaderboard command to see top members, or view it in the dashboard.

Configuration

1. Go to Welcome Messages in the dashboard
2. Enable welcome and/or goodbye messages
3. Select the channel where messages will be sent
4. Customize your message using variables

Available Variables

Example Messages

Auto-Role on Join

Automatically assign a role to new members:

1. Enable "Auto-Role" toggle
2. Select the role to assign
3. New members will receive this role upon joining

Configuration Options

Variables

Example Message

Verification Types

Setup

1. Go to Verification in the dashboard
2. Select your verification type
3. Set the verification channel (where the verify button appears)
4. Set the verified role (given after verification)
5. Customize messages and timeout settings

Account Age Protection

Block new Discord accounts to prevent alt abuse:

1. Enable "Require Account Age"
2. Set minimum age in days (e.g., 7 days)
3. Users with newer accounts will be blocked

Features

• Warnings: Track member infractions
• Mod Log: All mod actions logged to a channel
• Auto-Moderation: Coming soon!

Managing Warnings

Setting Up Mod Log

1. Go to Server Settings
2. Enter your mod log channel ID
3. All mod actions will be logged there

How It Works

Trackers automatically update channel names with live information like:

• Total member count
• Online member count
• Bot count
• Members playing a specific game

Creating a Tracker

1. Go to Channel Stats in the dashboard
2. Click "New Tracker"
3. Select the channel to track
4. Choose the stat type
5. Set the format template

Format Templates

Examples:

• Members: {count} → "Members: 1,234"
• Online: {count} → "Online: 456"
• Playing {game}: {count} → "Playing Minecraft: 23"

Features

• View all roles with their permissions
• Create new roles with color picker
• Bulk import roles via CSV
• Edit role colors and permissions

CSV Import Format

name,color,hoist,mentionable
Admin,#FF0000,true,false
Moderator,#00FF00,true,false
Member,#0000FF,false,true

Channel Templates

Save your server's channel structure to recreate it later:

1. Go to Templates
2. Click "New Template" under Channel Templates
3. Name your template
4. Paste your channel configuration as JSON
5. Click Create

Role Templates

Save your role hierarchy:

1. Go to Templates
2. Click "New Template" under Role Templates
3. Name your template
4. Paste your role configuration as JSON
5. Click Create

Applying Templates

1. Find your template in the list
2. Click "Apply"
3. Confirm the action
4. The bot will create the channels/roles in your server

General Settings

Token Customization

Rename "Hero Tokens" to match your server's theme:

• Token Name: What to call your currency (e.g., "Gold Coins", "Stars")
• Token Emoji: The emoji shown with the currency

Mod Log Channel

Set a channel where all moderation actions are logged.

General Commands

XP Commands

Moderation Commands

Token Commands

LFG Commands

Why isn't the bot responding?

1. Make sure the bot has permission to see and send messages in that channel
2. Check if the bot is online (should show a green status)
3. Try using slash commands instead of prefix commands

Why am I not earning XP?

1. There's a cooldown between XP awards (default: 60 seconds)
2. The channel might be in the ignored list
3. Check if XP is enabled for the server

How do I check my level?

Use the /rank command to see your current level, XP, and progress to the next level.

Can I transfer XP between servers?

No, XP is specific to each server and cannot be transferred.

Why didn't I get my level role?

1. Make sure level roles are configured in the dashboard
2. Check that the bot has "Manage Roles" permission
3. Ensure the bot's role is higher than the role it's trying to assign

How do I reset someone's XP?

Admins can reset XP from the dashboard:

1. Go to XP & Leveling
2. Find the member in the leaderboard
3. Click "Edit" and set XP to 0

What's the difference between Free and Premium?

Premium includes:

• Unlimited level roles (Free: 3)
• Unlimited trackers (Free: 5)
• Unlimited templates (Free: 5)
• Custom XP multipliers
• Multi-step verification
• Custom embed colors
• Priority support