glizzykingdreko / discordwizard

A powerful and efficient tool to clone and mirror entire Discord servers in real-time, using websockets and webhooks for seamless synchronization.

DiscordWizard: Your Portal to Discord Server Replication 🧙‍♂️

Welcome to the world of DiscordWizard, your trusty ally for cloning entire Discord servers. With its unique and efficient powers, DiscordWizard will help you mirror a Discord server in no time.

To work with DiscordWizard, you'll need:

• The token of a Discord account that is a member of the server you wish to copy
• A target server where the messages will be replicated, along with the token of an account with administrative privileges
• That's it! You're ready to go.

How DiscordWizard Works 🎩

DiscordWizard operates by having the account in the source server monitor changes and new messages using a websocket. The target account then replicates these changes, creating categories, channels, and even renaming them as needed. Messages are sent through webhooks, ensuring a seamless connection between servers.

To set up DiscordWizard, configure the settings.yaml file as shown:

client:
  token: "" # Token of the account in the server to be mirrored
  server_id: 107... # Server ID
  excluded_channels:
    - 0 # List of excluded channels, if any
  regex_filter: "(badword1|badword2)" # Regex to block forwarding of messages based on it

server:
  token: "" # Administrator token within your server
  server_id: 109... # Your server ID
  interval: 60 # Delay in seconds between interactions with Discord APIs to create channels/webhooks/categories
  webhook_name: "DiscordWizard" # Webhook name to use
  websocket:
    port: 8080 # Port to use
    host: "localhost" # Host to use

Additionally, you can use the proxies.txt file to provide a list of proxies to prevent hitting Discord rate limits when mirroring large servers with high message volume. List one proxy per line in the format ip:port:user:pass or ip:port.

To start the server, run:

python3 server.py

To launch the client, execute:

python3 client.py

And just like that, the replication begins! 🎉

DiscordWizard separates the client and server into two different scripts. This versatile design allows you to mirror multiple source servers (clients) to the same target server, broadening your possibilities and streamlining the process.

Note: The first time you run DiscordWizard, it will create channels, categories, and webhooks. This may take a moment due to Discord's rate limit restrictions. For larger servers, use a higher interval (40/60) to avoid hitting Discord's rate limits.

How to Contribute 🤝

We welcome and appreciate contributions from the community! If you'd like to contribute to DiscordWizard, here's how you can get involved:

1. Fork the repository: Click the 'Fork' button at the top-right corner of the main GitHub page to create your own copy of the repository.

2. Clone your fork: Clone your forked repository to your local machine using git clone https://github.com/YOUR-USERNAME/DiscordWizard.git.

3. Create a branch: Before making any changes, create a new branch for your contribution using git checkout -b your-feature-branch.

4. Make changes: Implement your feature, fix bugs, or make other improvements to the code.

5. Commit and push: Commit your changes and push them to your forked repository using git commit -m "Your commit message" followed by git push origin your-feature-branch.

6. Create a pull request: On the GitHub page of your forked repository, click the 'Compare & pull request' button to submit your changes for review. Provide a clear description of your changes and any additional information that may be helpful.

7. Stay involved: Keep an eye on your pull request and be ready to respond to feedback, make changes, or answer questions. Your active participation is crucial for a smooth review process.

By following these steps, you can contribute to the development of DiscordWizard and help make it even better for everyone! We look forward to collaborating with you. 🚀

Connect with the Developer 🚀

Stay connected and keep up with ongoing projects and innovations.

💌 For questions or feedback, feel free to reach out via email at [email protected].

🐦 Follow on Twitter for updates and insights at @glizzykingdreko.

📚 Read more about work on Medium by visiting medium.com/@glizzykingdreko.

🔮 Explore code repositories on GitHub at github.com/glizzykingdreko.

Join the journey and make your Discord server replication experience a breeze! 🎉

discordwizard's Issues

raise HTTPException(r, data) discord.errors.HTTPException: 400 Bad Request (error code: 50035): Invalid Form Body In name: Username cannot contain "discord"

Tried to reinstall project, didnt helped, what i need to do to fix this error?
https://imgur.com/a/ARZXhwF

Error with 'discord' in name

Started server.py
Started client.py

All was working smoothly, until....

Traceback (most recent call last):
  File "/opt/homebrew/lib/python3.10/site-packages/websockets/legacy/server.py", line 240, in handler
    await self.ws_handler(self)
  File "/opt/homebrew/lib/python3.10/site-packages/websockets/legacy/server.py", line 1186, in _ws_handler
    return await cast(
  File "/Users/tester/Desktop/DiscordWizard-main/server.py", line 148, in websocket_handler
    updated_sitemap = await update_server_structure(data["data"], sitemap_file)
  File "/Users/tester/Desktop/DiscordWizard-main/server.py", line 59, in update_server_structure
    webhook = await channel.create_webhook(name=WEBHOOK_NAME)
  File "/opt/homebrew/lib/python3.10/site-packages/discord/channel.py", line 419, in create_webhook
    data = await self._state.http.create_webhook(self.id, name=str(name), avatar=avatar)
  File "/opt/homebrew/lib/python3.10/site-packages/discord/http.py", line 302, in request
    raise HTTPException(r, data)
discord.errors.HTTPException: 400 Bad Request (error code: 50035): Invalid Form Body
In name: Username cannot contain "discord"
2023-10-11 10:26:13,705 - INFO - connection closed

Only Cloning Text Channels

Only cloned the text channels. Didn't clone the roles, so the permissions set up on the old server don't transfer over. The voice channels were also not cloned to the new server, I installed PyNaCl plugin, but still didn't do anything

Attribute Error.

Traceback (most recent call last):
File "C:\Users\stefa\Downloads\DiscordWizard-main\DiscordWizard-main\server.py", line 214, in
bot.loop.run_until_complete(start_server)
^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "C:\Users\stefa\AppData\Local\Programs\Python\Python311\Lib\site-packages\discord\client.py", line 129, in getattr
raise AttributeError(msg)
AttributeError: loop attribute cannot be accessed in non-async contexts. Consider using either an asynchronous main function and passing it to asyncio.run or using asynchronous initialisation hooks such as Client.setup_hook

Avoid channels to get copied

More than an issue is a request. Sorry not a coder so first of all thank you for the great work because it works like a charm.

Now what I see is that many times I dont really want to copy the whole structure of the discord server, but just some channels that I might be interested in. Is there a way to accomplish this with your code?

And sorry if this is not the correct place to post this. First time using github. Just created an account to post this.

Thank you in advance!

discord.py instead of discord.py-self

C:\Users-----\Downloads\DiscordWizard-main\DiscordWizard-main>python server.py
Traceback (most recent call last):
File "C:\Users-----\Downloads\DiscordWizard-main\DiscordWizard-main\server.py", line 22, in
bot = commands.Bot(command_prefix='>', self_bot=True)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
TypeError: BotBase.init() missing 1 required keyword-only argument: 'intents'

Newbie question

Is this for clone discord server and copy and update all the new messages in all channels in realtime?

Do I need to keep my computer open for the clone process?

it only clones new messages

it only seems to clone new messages.. any way I can clone old stuff too?