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 .ids are strings or non-snowflake integers.

• Webhook.fetch(), Webhook.edit(), Webhook.delete(), WebhookMessage.delete(), Webhook.delete_message(), and Webhook.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(), and Webhook.delete() require Webhook.server_id to be filled or for you to provide the server parameter to the respective method.

• Client.fetch_invite() does not accept URLs or vanity codes.

• Client.fetch_servers() returns a list of Server instead of an async iterator.

• Server.fetch_channel() does not accept category IDs. Use Server.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:

  • AutoShardedClient

  • AutoShardedBot

• Application Info:

  • AppInfo

  • PartialAppInfo

  • AppInstallParams

  • Team

  • TeamMember

• Voice Related

• Audit Log Data

• Webhooks:

  • SyncWebhook

  • SyncWebhookMessage

• Abstract Base Classes:

  • Snowflake

  • PrivateChannel

  • Connectable

• Models:

  • AutoMod

  • DeletedReferencedMessage

  • ScheduledEvent

  • Integration

  • Spotify

  • VoiceState

  • PartialEmoji

  • RoleTags

  • PartialMessageable

  • ThreadMember

  • StageChannel

  • StageInstance

  • GroupChannel

  • PartialInviteGuild

  • PartialInviteChannel

  • Template

  • WelcomeScreen

  • WelcomeChannel

  • WidgetChannel

  • WidgetMember

  • Widget

  • StickerPack

  • StickerItem

  • Sticker

  • StandardSticker

  • GuildSticker

  • RawMessageDeleteEvent

  • RawBulkMessageDeleteEvent

  • RawMessageUpdateEvent

  • RawReactionClearEvent

  • RawReactionClearEmojiEvent

  • RawIntegrationDeleteEvent

  • RawThreadUpdateEvent

  • RawThreadMembersUpdate

  • RawThreadDeleteEvent

  • RawTypingEvent

  • RawMemberRemoveEvent

  • PartialWebhookGuild

  • PartialWebhookChannel

• Data Classes:

  • AllowedMentions

  • MessageReference

  • PartialMessage

  • MessageApplication

  • Intents

  • MemberCacheFlags

  • ApplicationFlags

  • ChannelFlags

  • AutoModPresets

  • AutoModRuleAction

  • AutoModTrigger

  • BaseActivity

  • Activity

  • Streaming

  • CustomActivity

  • PermissionOverwrite

  • ShardInfo

  • SystemChannelFlags

  • MessageFlags

  • PublicUserFlags

• 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; Use guilded.on_webhook_create() and guilded.on_raw_webhook_update() / guilded.on_webhook_update() instead.