Discord.py Differences¶
guilded.py was designed with discord.py compatibility in mind; You shouldn’t have to rewrite your bot to make it Guilded-ready. The libraries are not identical, though–here are some notable differences.
These lists are not exhaustive.
Breaking¶
Below is a list of “breaking” differences between discord.py and guilded.py; If you use any of the below methods, attributes, or parameters, you must change your code in order for your bot to work with this library.
Modified¶
Guilded/Discord API differences
All
.id
s are strings or non-snowflake integers.Webhook.fetch()
,Webhook.edit()
,Webhook.delete()
,WebhookMessage.delete()
,Webhook.delete_message()
, andWebhook.fetch_message()
require the webhook instance to have authentication info associated with it as webhooks cannot perform these actions on their own.Server.webhooks()
cannot fetch the required information in a single request, so it makes multiple for each compatible channel.Webhook.fetch()
,Webhook.edit()
, andWebhook.delete()
requireWebhook.server_id
to be filled or for you to provide theserver
parameter to the respective method.Client.fetch_invite()
does not accept URLs or vanity codes.Client.fetch_servers()
returns a list ofServer
instead of an async iterator.Server.fetch_channel()
does not accept category IDs. UseServer.fetch_category()
instead.
Not present¶
Methods
Client.add_view
Client.application_info
Client.before_identify_hook
Client.change_presence
Client.create_dm
Client.create_guild
(create_server
)Client.delete_invite
Client.fetch_guilds
Client.fetch_premium_sticker_packs
Client.fetch_stage_instance
Client.fetch_sticker
Client.fetch_template
Client.fetch_webhook
Client.fetch_widget
Client.get_partial_messageable
Client.get_stage_instance
Client.get_sticker
Client.is_ws_ratelimited
Guild.edit
Guild.delete
Category.clone
Category.invites
Category.move
Category.overwrites_for
Category.permissions_for
Category.set_permissions
Parameters
Server.create_webhook()
,ChatChannel.create_webhook()
,ListChannel.create_webhook()
:avatar
,reason
Classes
Clients:
Application Info:
Webhooks:
Abstract Base Classes:
Models:
AutoMod
Data Classes:
All of
ui.*
All of
app_commands.*
Non-breaking¶
Below is a list of non-“breaking” differences between discord.py and guilded.py; You will be able to use guilded.py without complying with any of the below changes. This list is not exhaustive.
The
on_webhooks_update
event does not exist; Useguilded.on_webhook_create()
andguilded.on_raw_webhook_update()
/guilded.on_webhook_update()
instead.