Discord Server Cloner Documentation

Overview

The Discord Server Cloner is a Node.js API that enables copying roles, channels, categories, and emojis from a source Discord server to a target server using a self-bot. This tool is intended for server administrators to replicate server setups efficiently.

⚠️ Warning: Using self-bots violates Discord's Terms of Service and may result in account bans. Use at your own risk, and consider using an official bot account with Discord.js for compliance.

Setup

1. Ensure Node.js is installed (version 14 or higher recommended).
2. Install dependencies for the API:

   npm install express discord.js-selfbot-v13 axios

3. Save the API code as api/index.js and run it:

   node api/index.js

4. Place the documentation page in public/index.html.
5. Deploy to Vercel or host locally. The API is accessible at /clone, and docs at /.

API Endpoint: /clone

POST /clone

Clones a source Discord server to a target server, copying roles, channels, categories, and optionally emojis.

Request Body

{
  "token": "your_discord_token",
  "guild_s": "source_guild_id",
  "guild": "target_guild_id",
  "clone_emojis": true
}
      

• token: Discord user token (string, required).
• guild_s: Source server ID (string, numeric, required).
• guild: Target server ID (string, numeric, required).
• clone_emojis: Copy emojis (boolean, optional, defaults to false).

Example Request

curl -X POST https://cloner.theatlantis.asia/clone \
  -H "Content-Type: application/json" \
  -d '{
    "token": "your_discord_token",
    "guild_s": "123456789012345678",
    "guild": "987654321098765432",
    "clone_emojis": true
  }'
      

Responses

• 200 OK: { "message": "Sao chép server thành công", "status": "success" }
• 400 Bad Request: Invalid input (e.g., non-numeric guild IDs).
• 401 Unauthorized: Invalid token.
• 403 Forbidden: Insufficient permissions.
• 429 Too Many Requests: Rate limit exceeded.
• 500 Internal Server Error: Unexpected error with details.

Creating a Custom Tool

You can create a custom JavaScript tool to interact with the cloner API programmatically. Below is a sample script that sends a POST request to the /clone endpoint.

Sample Tool Script

const axios = require('axios');

async function cloneServer(token, sourceGuildId, targetGuildId, cloneEmojis = false) {
  try {
    const response = await axios.post('https://cloner.theatlantis.asia/clone', {
      token,
      guild_s: sourceGuildId,
      guild: targetGuildId,
      clone_emojis: cloneEmojis,
    }, {
      headers: { 'Content-Type': 'application/json' },
    });
    console.log('Success:', response.data);
  } catch (error) {
    console.error('Error:', error.response ? error.response.data : error.message);
  }
}

// Example usage
cloneServer(
  'your_discord_token',
  '123456789012345678',
  '987654321098765432',
  true
);
      

Setup Instructions

1. Create a new file, e.g., cloner-tool.js, and copy the script above.
2. Install the axios dependency:

   npm install axios

3. Replace your_discord_token, 123456789012345678, and 987654321098765432 with your actual token and guild IDs.
4. Run the script:

   node cloner-tool.js

Customization Tips

• Add command-line arguments using process.argv for dynamic inputs.
• Implement retry logic for rate limit errors (HTTP 429).
• Extend the script to handle multiple cloning tasks sequentially.

⚠️ Keep your token secure and never expose it in public code or repositories.

Permissions Required

• MANAGE_ROLES: To create/delete roles.
• MANAGE_CHANNELS: To create/delete channels and categories.
• MANAGE_EMOJIS_AND_STICKERS: To create emojis (if clone_emojis is true).
• MANAGE_GUILD: To edit guild name and icon.

Ensure the account has these permissions in the target server to avoid 403 errors.