Skip to content

A powerful Discord bot that automatically backs up server messages, media, emojis, roles, and member data. Perfect for server admins who want to archive their community.

License

Notifications You must be signed in to change notification settings

HighMark-31/Discord-Bot-Server-Backup

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

13 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🎯 Discord Server Backup Bot

Stars License Visitors

πŸš€ VERSION 2.0 - MAJOR UPDATE RELEASED!

Complete Server Archival with Interactive Viewer & Multiple Export Formats

Features β€’ What's New in v2.0 β€’ Quick Start β€’ BackupViewer β€’ Commands


πŸ“Œ About

Discord Server Backup Bot is a powerful, fully-featured Discord bot designed for server administrators who need complete, reliable backups of their community data. With v2.0, we've revolutionized how you archive, view, and restore server information.

✨ Go beyond simple backups - Save everything: messages, embeds, roles, members, emojis, and media. Then explore it all with our beautiful interactive viewer.


πŸ’Ž Key Features

Original Features

  • βœ… Full message backup including attachments (images, videos, files)
  • βœ… Custom emoji preservation - Save all custom server emojis
  • βœ… Complete member export - Roles, IDs, join dates, and more
  • βœ… Server configuration backup - Roles, channels, and server info
  • βœ… Real-time progress - Live progress bar every 2 seconds
  • βœ… Well-organized structure - Easy-to-browse backup folders

πŸŽ‰ NEW IN v2.0 - Game-Changing Features

πŸ”„ Dual Export Formats

  • JSON Format - Structured data perfect for embeds, reactions, and rich content
  • Database Format - Optimized for massive servers with millions of messages
  • TXT Format - Human-readable, universal compatibility

Smart Backup Modes

  • FULL Mode - Complete everything: messages, embeds, reactions, attachments, metadata, roles, permissions
  • FAST Mode - Quick backup of essentials (messages + basic data, no embeds)

πŸ‘€ BackupViewer - The Game Changer

Browse your backups exactly like Discord! Open BackupViewer.html in any browser and explore your server backups with a beautiful Discord-like interface. Perfect for previewing and auditing your data.

  • Discord-like UI - Familiar interface that feels native
  • Easy Navigation - Browse channels and messages intuitively
  • Search & Filter - Find exactly what you're looking for
  • Rich Preview - View embeds, media, and metadata

πŸ” Selective Restoration

  • !restorebackup - Bring your server back to its former glory
  • Restore messages, embeds, roles, permissions, and configuration
  • Only works with v2.0+ backups (version guaranteed)

πŸ“ Embed Support

  • Full Discord embed backup and viewing
  • Rich content preservation (colors, fields, thumbnails, images)
  • Perfect embed restoration

🎯 What's New in Version 2.0

Feature Before After
Export Formats Text Only JSON, Database, Text
Backup Modes All-or-nothing Full or Fast Smart Modes
Embed Support ❌ Not supported βœ… Complete embed backup
Data Viewer ❌ Manual file browsing βœ… BackupViewer.html interactive UI
Restore Option ❌ Not available βœ… !restorebackup command
Metadata Basic Comprehensive backup_metadata.json
Speed Single mode Fast mode for quick saves

πŸš€ Quick Start

1️⃣ Installation & Setup

# Install dependencies
pip install -U discord.py

# Replace TOKEN with your bot token in bot.py and run
python bot.py

2️⃣ Invite to Your Server

  • Invite with Administrator permissions
  • Enable Server Members Intent and Message Content Intent in Developer Portal

3️⃣ Run Your First Backup

!backup

πŸ’Ύ Boom! Your server is now backed up.


πŸ“Š Commands Reference

Backup Command

!backup [format] [mode]

Parameters:

Format (optional - default: txt)

json          Structured JSON format - best for embeds & metadata
db            Database format - optimized for huge servers  
txt           Human-readable text - universal compatibility

Mode (optional - default: full)

full          Complete backup: ALL messages, embeds, attachments, metadata, roles
fast          Quick backup: Messages & essentials only (no embeds, ~60% faster)

Examples:

!backup                    # Full backup in TXT format (safest default)
!backup json               # Full backup in JSON (best for embeds)
!backup db                 # Database format, full mode (large servers)
!backup json fast          # Quick JSON backup (speed priority)
!backup txt full           # Complete text backup (maximum data)

What Gets Backed Up:

  • Full Mode (full) ✨

    • All messages with complete metadata
    • Discord embeds, reactions, mentions
    • All attachments and media files
    • Member list with roles and join dates
    • Server configuration and permissions
    • Emojis and server settings
  • Fast Mode (fast) ⚑

    • All messages and basic metadata
    • Member information
    • Server structure
    • Skips: Embeds, detailed metadata, heavy processing

Restore Command (v2.0+)

!restorebackup

Requirements:

  • Backup folder must exist in the bot's directory
  • Backup created with v2.0 or later
  • Bot needs appropriate channel permissions

What Can Be Restored:

  • πŸ“¨ Messages and conversation history
  • 🎨 Embeds and rich content
  • πŸ“ Attachments and media files
  • πŸ‘₯ Roles and member permissions
  • βš™οΈ Server configuration

πŸ‘€ BackupViewer - Interactive Backup Explorer

What is BackupViewer?

The ultimate tool for exploring your Discord backups. Open BackupViewer.html in any web browser and experience your server data with a Discord-like interface.

How to Use:

  1. Locate your backup folder

    • Created by the bot as backup_ServerName_YYYYMMDD_HHMMSS/
  2. Open BackupViewer.html

    • Double-click or open in your browser
    • Select your backup folder from the prompt
  3. Explore Your Data

    • Browse channels like in Discord
    • View messages with full formatting
    • See embeds, images, and media
    • Search for specific content
    • Review member information

Features:

  • 🎨 Beautiful UI - Matches Discord's design language
  • πŸ“± Responsive - Works on desktop, tablet, mobile
  • πŸ” Powerful Search - Find messages, members, content
  • πŸ“Š Data Preview - Full embed and attachment rendering
  • πŸ’Ύ No Upload Required - Everything stays local
  • πŸš€ Fast - Instant access to your backup data

πŸ“‚ Backup Folder Structure

backup_ServerName_YYYYMMDD_HHMMSS/
β”‚
β”œβ”€β”€ πŸ“„ server_info.txt              Server name, ID, owner, settings
β”œβ”€β”€ πŸ“„ roles.txt                    All server roles and permissions
β”œβ”€β”€ πŸ“„ member_list.txt              Complete member list with data
β”œβ”€β”€ πŸ“‹ backup_metadata.json         [v2.0] Format info, mode, timestamp
β”‚
β”œβ”€β”€ πŸ“ emoji/
β”‚   β”œβ”€β”€ custom_emoji1.png
β”‚   └── custom_emoji2.gif
β”‚
β”œβ”€β”€ πŸ“ logs/                        [v2.0] New structure for messages
β”‚   β”œβ”€β”€ general.txt
β”‚   β”œβ”€β”€ announcements.txt
β”‚   └── random.txt
β”‚
β”œβ”€β”€ πŸ“ media/                       Attachments organized by channel
β”‚   β”œβ”€β”€ general/
β”‚   β”‚   β”œβ”€β”€ image1.jpg
β”‚   β”‚   └── video.mp4
β”‚   └── announcements/
β”‚
└── πŸ“ embeds/                      [v2.0] NEW! Discord embed data
    β”œβ”€β”€ general_embeds.json         Embed objects with full metadata
    β”œβ”€β”€ announcements_embeds.json   Colors, fields, thumbnails, etc
    └── random_embeds.json

βš™οΈ Technical Requirements

  • Python 3.8 or higher
  • discord.py v2.x (latest recommended)
  • Administrator permissions on target Discord server
  • Intents enabled:
    • βœ… Server Members Intent
    • βœ… Message Content Intent

πŸ› οΈ Installation

# Clone or download the repository
git clone https://github.com/HighMark-31/discord-server-backup-bot.git
cd discord-server-backup-bot

# Install Python dependencies
pip install -U discord.py

# Configure your bot token in bot.py
# Then run:
python bot.py

πŸ“ Version Comparison

v1.0

  • Basic message backup
  • Text output only
  • No viewer tool
  • No restore function

✨ v2.0 (CURRENT)

  • 🎯 Multiple export formats (JSON, DB, TXT)
  • ⚑ Smart backup modes (Full, Fast)
  • πŸ‘€ Interactive BackupViewer with Discord-like UI
  • πŸ”„ Restore functionality
  • πŸ“ Full embed support
  • πŸ“Š Enhanced metadata
  • πŸš€ Better performance and organization

πŸ“„ License

This project is distributed under a custom license that allows usage and modification only if original credits to Highmark.it remain intact.

See the LICENSE file for full details.


πŸ™Œ Support & Feedback

Love the bot? Show your support!

  • Star this repo on GitHub
  • Leave a review on Trustpilot
  • Report bugs via GitHub Issues
  • Suggest features in Discussions

πŸ“ž Contact & Links

Platform Link
Website https://highmark.it
GitHub HighMark-31/discord-server-backup-bot
Review Trustpilot

Made with ❀️ by HighMark

v2.0 - The Ultimate Discord Server Archival Solution

Back to Top

About

A powerful Discord bot that automatically backs up server messages, media, emojis, roles, and member data. Perfect for server admins who want to archive their community.

Topics

Resources

License

Stars

Watchers

Forks

Contributors