# GLOBAL Discord Bot — Full Documentation

> The ultimate moderation, automation, and management hub for your Discord server.

GLOBAL is a fully customizable, multi-purpose Discord community bot. It is designed to protect, manage, and grow Discord communities of all sizes with comprehensive moderation, server protection, engagement tools, AI capabilities, and administrative utilities.

---

## Table of Contents

1. [Overview](#overview)
2. [Getting Started](#getting-started)
3. [Core Modules](#core-modules)
4. [Command Reference](#command-reference)
5. [APIs](#apis)
6. [Integration](#integration)
7. [Support & Community](#support--community)

---

## Overview

GLOBAL serves thousands of Discord servers with a comprehensive feature set:

- **1600+ total commands** across prefix, slash, and no-prefix types
- **800+ no-prefix commands** that auto-trigger on message patterns
- **400+ prefix commands** using configurable prefix (default: `.`)
- **400+ slash commands** with Discord's native auto-complete
- **Real-time status monitoring** with uptime, latency, and incident tracking
- **Web dashboard** for server-specific configuration
- **Ticket system** with web-based management interface

### Key Links

| Resource | URL |
|----------|-----|
| Website | https://theglobalbot.com |
| Commands | https://theglobalbot.com/commands |
| Status | https://theglobalbot.com/status |
| Statistics | https://theglobalbot.com/statistics |
| Support Server | https://discord.gg/e92wev56XC |
| Add to Server | https://discord.com/oauth2/authorize?client_id=1325908731799797781&scope=bot&permissions=8 |
| Terms of Service | https://theglobalbot.com/tos |
| Privacy Policy | https://theglobalbot.com/privacy |
| Tickets | https://theglobalbot.com/tickets |
| Dashboard | https://theglobalbot.com/dashboard |
| Feedback | https://theglobalbot.com/dashboard/feedback |

---

## Getting Started

### Adding GLOBAL to Your Server

1. Visit https://discord.com/oauth2/authorize?client_id=1325908731799797781&scope=bot&permissions=8
2. Select the server you want to add GLOBAL to
3. Grant the required permissions (Administrator recommended for full functionality)
4. GLOBAL will join your server and be ready to use immediately

### First Steps After Adding

1. **Set a prefix** (optional): Use `.prefix set <new_prefix>` to change the default `.` prefix
2. **Configure welcome messages**: Set up greetings for new members
3. **Enable AntiNuke**: Protect your server from malicious actions
4. **Set up logging**: Configure event logging channels
5. **Create ticket categories**: Set up your support ticket system

---

## Core Modules

### 🛡️ Moderation

Complete server moderation toolkit:

- **Ban/Unban** — Permanent or temporary bans with reason tracking
- **Kick** — Remove members with logged reasons
- **Mute/Unmute** — Timeout members with configurable duration
- **Warn** — Issue warnings with escalation tracking
- **Purge** — Bulk message deletion with filters (user, contains, bots, embeds, etc.)
- **Slowmode** — Channel slowmode management
- **Lockdown** — Lock/unlock channels or entire server
- **Softban** — Ban and immediately unban to purge messages
- **Massban** — Ban multiple users simultaneously
- **Role Management** — Add/remove roles, create/delete roles
- **Nick Management** — Change or reset nicknames

### 🔒 AntiNuke

Real-time server protection system that monitors and automatically reverts:

- Channel creation/deletion/modification
- Role creation/deletion/modification
- Mass bans and mass kicks
- Webhook creation and spam
- Bot additions by unauthorized users
- Server setting changes
- Emoji/sticker deletion
- Permission escalation attempts

Configuration options:
- Whitelisted users and roles
- Action thresholds and time windows
- Punishment actions (ban, kick, strip roles)
- Owner-only configuration

### 🎤 VoiceMaster

Dynamic temporary voice channel system:

- Auto-create voice channels when users join a trigger channel
- Channel owners can: rename, set user limit, lock/unlock, hide/show
- Permission management per-channel
- Auto-cleanup when empty
- Persistent channel settings
- Claim system for abandoned channels
- Ghost ping protection in voice text channels

### 📊 Leveling System

Full XP-based progression:

- Text and voice activity XP tracking
- Customizable XP rates and cooldowns
- Level-up messages (customizable embed or text)
- Role rewards at specific levels
- Server and global leaderboards
- Rank cards with customizable backgrounds
- XP multipliers for specific roles or channels
- Import/export from other bots (MEE6, Amari, etc.)
- No-XP channels and roles

### 🤖 AI Inference

Modern AI capabilities:

- **AI Chat** — Conversational AI with context awareness
- **Translation** — Multi-language translation
- **Image Analysis** — Describe and analyze uploaded images
- **Voice Transcription** — Transcribe voice messages to text
- **Text Generation** — Creative writing, summaries, and more

### 📝 Notes

Moderator notes system:

- Attach notes to any user
- View note history per user
- Edit and delete notes
- Integration with mod log
- Reply-based editing workflow
- Search notes by content or user

### 🔧 Utilities

Essential server management tools:

- **Server Backups** — Full backup and restore (channels, roles, permissions, settings, emojis)
- **Sticky Messages** — Messages that stay at the bottom of a channel
- **Welcome/Leave Messages** — Customizable member join/leave notifications
- **Counting** — Counting channel game with streak tracking
- **Embeds** — Create and edit rich embeds
- **Polls** — Create polls with reactions
- **Reminders** — Set personal or channel reminders
- **Server Info** — Detailed server statistics and information
- **User Info** — Member profiles with join date, roles, and activity
- **Avatar/Banner** — View user avatars and banners
- **AFK System** — Set AFK status with auto-replies
- **Snipe** — Recover deleted or edited messages
- **Starboard** — Pin popular messages automatically

### 💕 Social

Community engagement features:

- **Marriage System** — Marry other members, view couples
- **Ships** — Compatibility percentage between users
- **Action Commands** — Hug, pat, slap, kiss, cuddle, poke, bite, etc.
- **Confessions** — Anonymous confession channel
- **Roleplay** — Interactive roleplay commands

### 🎮 Fun & Games

Entertainment features:

- **Trivia** — Multiple categories and difficulty levels
- **Memes** — Reddit meme fetching
- **8ball** — Magic 8-ball predictions
- **Coinflip** — Coin toss
- **Dice** — Roll dice
- **RPS** — Rock Paper Scissors
- **Would You Rather** — Dilemma questions
- **Truth or Dare** — Party game
- **Roast/Compliment** — Random roasts and compliments

### 🎫 Tickets

Web-based support ticket system:

- Multiple ticket categories
- Custom ticket creation messages
- Staff role assignment per category
- Transcript logging
- Web interface for ticket management
- Auto-close inactive tickets
- Ticket claiming by staff
- Priority levels

### 🎉 Giveaways

Complete giveaway management:

- Timed giveaways with auto-end
- Multiple winners support
- Entry requirements (role, level, account age)
- Re-roll functionality
- Bonus entries for specific roles
- Giveaway dashboard

### 📋 Logging

Comprehensive event logging:

- Message edits and deletions (with content)
- Member joins, leaves, and bans
- Role creation, deletion, and updates
- Channel creation, deletion, and updates
- Voice state changes (join, leave, move, mute, deafen)
- Nickname changes
- Invite tracking
- Emoji and sticker changes
- Server setting changes
- Thread events
- Separate log channels per event type

### 💾 Server Backups

Full server state preservation:

- Backup channels (categories, text, voice, forums)
- Backup roles with permissions
- Backup server settings
- Backup emojis and stickers
- Interval-based auto-backups
- Multiple backup slots
- Selective restore options
- Cross-server restore

### ⚡ Automations

Automated workflows:

- **Auto-Responders** — Trigger responses on specific keywords or patterns
- **Auto-Roles** — Automatically assign roles on join
- **Reaction Roles** — Role assignment via message reactions
- **Button Roles** — Role assignment via buttons
- **Dropdown Roles** — Role assignment via select menus
- **Auto-Mod** — Content filtering (links, invites, spam, caps, etc.)

### 👋 Welcome System

Customizable member greeting:

- Welcome messages with embeds
- Leave/goodbye messages
- DM welcome messages
- Variable support ({user}, {server}, {count}, etc.)
- Custom images and banners
- Multiple welcome channels
- Role-based welcome messages

---

## Command Reference

### Command Types

| Type | Description | Example |
|------|-------------|---------|
| **Prefix** | Traditional message-based, configurable prefix (default: `.`) | `.ban @user reason` |
| **Slash** | Discord native application commands with autocomplete | `/ban user:@user reason:reason` |
| **No-Prefix** | Auto-triggered on message patterns, no prefix needed | `hug @user` |

### Command Categories

All commands are organized into these categories:

- **Moderation** — Server moderation and member management
- **AntiNuke** — Server protection configuration
- **VoiceMaster** — Temporary voice channel management
- **Leveling** — XP and leveling system
- **AI** — Artificial intelligence features
- **Notes** — Moderator notes
- **Utility** — General utility commands
- **Social** — Social and engagement features
- **Fun** — Games and entertainment
- **Tickets** — Ticket system management
- **Giveaway** — Giveaway management
- **Logging** — Event logging configuration
- **Backup** — Server backup management
- **Automation** — Auto-responders and auto-roles
- **Welcome** — Welcome/leave message configuration
- **Config** — Bot configuration and settings

For the full, live command reference with all parameters and permissions, visit:
**https://theglobalbot.com/commands**

---

## APIs

GLOBAL exposes several public REST APIs:

### GET /api/v1/commands

Returns the complete list of bot commands.

**Response:**
```json
{
  "commands": [
    {
      "name": "ban",
      "type": "prefix",
      "category": "moderation",
      "description": "Ban a member from the server",
      "usage": ".ban <user> [reason]"
    }
  ]
}
```

### GET /api/v1/status

Returns live telemetry data for all monitored services.

**Response:**
```json
[
  {
    "name": "The Global Bot",
    "currentLatency": 42,
    "history": [
      {
        "status": "up",
        "latency": 42,
        "timestamp": 1697000000000
      }
    ]
  }
]
```

### GET /api/v1/banner

Returns the current bot banner image.

### GET /api/v1/outages

Returns historical outage and incident data.

---

## Integration

### Adding GLOBAL to Your Application

GLOBAL is a Discord bot and can be integrated into any Discord server. Use the invite link:

```
https://discord.com/oauth2/authorize?client_id=1325908731799797781&scope=bot&permissions=8
```

### API Usage

All public APIs are available at `https://theglobalbot.com/api/v1/` and return JSON responses. No authentication is required for public endpoints.

### Webhooks

GLOBAL supports Discord webhook integration for logging and notifications.

---

## Support & Community

- **Discord Support Server**: https://discord.gg/e92wev56XC — Get help, report bugs, suggest features
- **Feedback System**: https://theglobalbot.com/dashboard/feedback — Submit bug reports and feature requests
- **Status Page**: https://status.theglobalbot.com — Monitor service health and incidents
- **Website**: https://theglobalbot.com — Full documentation and dashboard

---

## Technical Specifications

| Property | Value |
|----------|-------|
| Platform | Discord |
| Bot Client ID | 1325908731799797781 |
| Default Prefix | `.` |
| Website | https://theglobalbot.com |
| Status Page | https://status.theglobalbot.com |
| API Base | https://theglobalbot.com/api/v1 |
| Website Framework | Next.js |
| Hosting | Vercel |
| Language | TypeScript/JavaScript |

---

*Last updated: 2025. For the most current information, visit https://theglobalbot.com*