diff --git a/docs/api.rst b/docs/api.rst index 9990d036d..0421d5a99 100644 --- a/docs/api.rst +++ b/docs/api.rst @@ -478,6 +478,14 @@ to handle it, which defaults to print a traceback and ignoring the exception. This requires :attr:`Intents.reactions` to be enabled. + .. note:: + + This doesn't require :attr:`Intents.members` within a guild context, + but due to Discord not providing updated user information in a direct message + it's required for direct messages to receive this event. + Consider using :func:`on_raw_reaction_add` if you need this and do not otherwise want + to enable the members intent. + :param reaction: The current state of the reaction. :type reaction: :class:`Reaction` :param user: The user who added the reaction. diff --git a/docs/intents.rst b/docs/intents.rst index 8ba036c95..38264b190 100644 --- a/docs/intents.rst +++ b/docs/intents.rst @@ -118,8 +118,9 @@ It should be noted that certain things do not need a member cache since Discord - :func:`on_message` will have :attr:`Message.author` be a member even if cache is disabled. - :func:`on_voice_state_update` will have the ``member`` parameter be a member even if cache is disabled. -- :func:`on_reaction_add` will have the ``user`` parameter be a member even if cache is disabled. -- :func:`on_raw_reaction_add` will have :attr:`RawReactionActionEvent.member` be a member even if cache is disabled. +- :func:`on_reaction_add` will have the ``user`` parameter be a member when in a guild even if cache is disabled. +- :func:`on_raw_reaction_add` will have :attr:`RawReactionActionEvent.member` be a member when in a guild even if cache is disabled. +- The reaction add events do not contain additional information when in direct messages. This is a Discord limitation. - The reaction removal events do not have the member information. This is a Discord limitation. Other events that take a :class:`Member` will require the use of the member cache. If absolute accuracy over the member cache is desirable, then it is advisable to have the :attr:`Intents.members` intent enabled.