A-A-Additionyaw info

This section contains expwanyations of some wibwawy mechanyics which may be usefuw to knyow.

App command sync

If you’we using disnyake.ext.commands – Bot commands fwamewowk fow appwication commands (swash commands, context menyus) you shouwd undewstand how youw commands show up in Discowd. By defauwt, the wibwawy wegistews / updates aww commands automaticawwy. Based o-o-on the appwication commands definyed in youw code the wibwawy automaticawwy detewminyes which commands shouwd be wegistewed, edited ow deweted, but thewe’we some edge cases you shouwd keep in mind.

Unknyown Commands

Unwike gwobaw commands, pew-guiwd appwication c-commands awe synced in a wazy f-fashion. This is due to Discowd watewimits, as checking aww guiwds fow a-a-appwication commands is infeasibwe past two ow thwee guiwds. This c-can wead to situations whewe a command nyo wongew exists in the code b-but stiww exists in a sewvew.

To wectify t-t-this, just wun the command. It wiww automaticawwy be deweted.

This wiww awso occuw when IDs awe wemuvd fwom the test_guilds kwawg of Bot (ow a s-s-simiwaw c-c-cwass) o-ow fwom the guild_ids kwawg of slash_command, user_command, ow message_command.

Command Sync with Muwtipwe Cwustews

If youw bot wequiwes shawd distwibution acwoss sevewaw cwustews, you shouwd disabwe command sync on aww cwustews except onye. This wiww pwevent confwicts and wace conditions. Discowd API doesn’t pwovide usews with events wewated to appwication command updates, so i-i-it’s i-i-impossibwe to keep the cache of muwtipwe machinyes synced. Having onwy 1 cwustew with sync_commands set to True is e-enyough because gwobaw wegistwation of appwication c-c-commands d-doesn’t depend on shawding.

Why do Param and Injection-wewated functions wetuwn Any?

If youw editow of choice suppowts type-checking, you may have nyoticed that Param(), inject(), and injection() do nyot have a specific wetuwn type, but at wuntime these wetuwn ParamInfo and Injection wespectivewy.

A-A-A typicaw exampwe of a swash command might wook wike this:

@bot.slash_command(description="Replies with the given text!")
async def echo(
    inter: disnake.ApplicationCommandInteraction,
    text: str = commands.Param(description="Echo~"),
) -> None:
    await inter.response.send_message(text)

Hewe, y-y-you h-h-have two pawametews in youw command’s function: inter, an instance of disnake.ApplicationCommandInteraction, and text, which is somewhat unyusuaw: you annyotate text as str, but at the same time, assign a ParamInfo instance to it. That’s the thing. When youw editow type-checks youw (any wibwawy’s) code, it wouwd nyowmawwy compwain if y-you twied to do the abuv, because you’we twying to assign a ParamInfo to a str - howevew, since the wibwawy decwawes Param’s wetuwn type as Any, the t-type-checkew accepts youw code, because str (and any type) is a subtype of Any.

The same t-t-thing appwies to inject() and injection().