Skip to content

Commit ab6f6eb

Browse files
authored
docs: update emoji/sticker/event creation methods and slowmode_delay to account for upcoming permission split (#1485)
1 parent a24e6b1 commit ab6f6eb

File tree

4 files changed

+23
-25
lines changed

4 files changed

+23
-25
lines changed

changelog/1485.doc.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
Update descriptions of ``slowmode_delay`` fields and :meth:`Guild.create_custom_emoji`/:meth:`~Guild.create_sticker`/:meth:`~Guild.create_scheduled_event` methods to account for the permission split on 2026-02-23.

disnake/channel.py

Lines changed: 14 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -208,8 +208,7 @@ class TextChannel(disnake.abc.Messageable, disnake.abc.GuildChannel, Hashable):
208208
in this channel.
209209
210210
A value of `0` denotes that it is disabled.
211-
Bots, and users with :attr:`~Permissions.manage_channels` or
212-
:attr:`~Permissions.manage_messages` permissions, bypass slowmode.
211+
Bots, and users with :attr:`~Permissions.bypass_slowmode` permissions, bypass slowmode.
213212
214213
See also :attr:`default_thread_slowmode_delay`.
215214
@@ -218,8 +217,7 @@ class TextChannel(disnake.abc.Messageable, disnake.abc.GuildChannel, Hashable):
218217
in newly created threads in this channel.
219218
220219
A value of ``0`` denotes that it is disabled.
221-
Bots, and users with :attr:`~Permissions.manage_channels` or
222-
:attr:`~Permissions.manage_messages`, bypass slowmode.
220+
Bots, and users with :attr:`~Permissions.bypass_slowmode` permissions, bypass slowmode.
223221
224222
.. versionadded:: 2.8
225223
@@ -1350,9 +1348,10 @@ class VoiceChannel(disnake.abc.Messageable, VocalGuildChannel):
13501348
13511349
slowmode_delay: :class:`int`
13521350
The number of seconds a member must wait between sending messages
1353-
in this channel. A value of `0` denotes that it is disabled.
1354-
Bots, and users with :attr:`~Permissions.manage_channels` or
1355-
:attr:`~Permissions.manage_messages`, bypass slowmode.
1351+
in this channel.
1352+
1353+
A value of `0` denotes that it is disabled.
1354+
Bots, and users with :attr:`~Permissions.bypass_slowmode` permissions, bypass slowmode.
13561355
13571356
.. versionadded:: 2.3
13581357
@@ -2036,9 +2035,10 @@ class StageChannel(disnake.abc.Messageable, VocalGuildChannel):
20362035
20372036
slowmode_delay: :class:`int`
20382037
The number of seconds a member must wait between sending messages
2039-
in this channel. A value of `0` denotes that it is disabled.
2040-
Bots, and users with :attr:`~Permissions.manage_channels` or
2041-
:attr:`~Permissions.manage_messages`, bypass slowmode.
2038+
in this channel.
2039+
2040+
A value of `0` denotes that it is disabled.
2041+
Bots, and users with :attr:`~Permissions.bypass_slowmode` permissions, bypass slowmode.
20422042
20432043
.. versionadded:: 2.9
20442044
@@ -3981,8 +3981,7 @@ class ForumChannel(ThreadOnlyGuildChannel):
39813981
in this channel.
39823982
39833983
A value of ``0`` denotes that it is disabled.
3984-
Bots, and users with :attr:`~Permissions.manage_channels` or
3985-
:attr:`~Permissions.manage_messages`, bypass slowmode.
3984+
Bots, and users with :attr:`~Permissions.bypass_slowmode` permissions, bypass slowmode.
39863985
39873986
See also :attr:`default_thread_slowmode_delay`.
39883987
@@ -3991,8 +3990,7 @@ class ForumChannel(ThreadOnlyGuildChannel):
39913990
in newly created threads in this channel.
39923991
39933992
A value of ``0`` denotes that it is disabled.
3994-
Bots, and users with :attr:`~Permissions.manage_channels` or
3995-
:attr:`~Permissions.manage_messages`, bypass slowmode.
3993+
Bots, and users with :attr:`~Permissions.bypass_slowmode` permissions, bypass slowmode.
39963994
39973995
.. versionadded:: 2.6
39983996
@@ -4418,8 +4416,7 @@ class MediaChannel(ThreadOnlyGuildChannel):
44184416
in this channel.
44194417
44204418
A value of ``0`` denotes that it is disabled.
4421-
Bots, and users with :attr:`~Permissions.manage_channels` or
4422-
:attr:`~Permissions.manage_messages`, bypass slowmode.
4419+
Bots, and users with :attr:`~Permissions.bypass_slowmode` permissions, bypass slowmode.
44234420
44244421
See also :attr:`default_thread_slowmode_delay`.
44254422
@@ -4428,8 +4425,7 @@ class MediaChannel(ThreadOnlyGuildChannel):
44284425
in newly created threads in this channel.
44294426
44304427
A value of ``0`` denotes that it is disabled.
4431-
Bots, and users with :attr:`~Permissions.manage_channels` or
4432-
:attr:`~Permissions.manage_messages`, bypass slowmode.
4428+
Bots, and users with :attr:`~Permissions.bypass_slowmode` permissions, bypass slowmode.
44334429
44344430
default_sort_order: :class:`ThreadSortOrder` | :data:`None`
44354431
The default sort order of threads in this channel.

disnake/guild.py

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2708,7 +2708,7 @@ async def create_scheduled_event(
27082708
27092709
Creates a :class:`GuildScheduledEvent`.
27102710
2711-
You must have :attr:`~Permissions.manage_events` permission to do this.
2711+
You must have :attr:`~Permissions.create_events` permission to do this.
27122712
27132713
Based on the channel/entity type, there are different restrictions regarding
27142714
other parameter values, as shown in this table:
@@ -3539,7 +3539,7 @@ async def create_sticker(
35393539
35403540
Creates a :class:`Sticker` for the guild.
35413541
3542-
You must have :attr:`~Permissions.manage_guild_expressions` permission to
3542+
You must have :attr:`~Permissions.create_guild_expressions` permission to
35433543
do this.
35443544
35453545
.. versionadded:: 2.0
@@ -3688,7 +3688,7 @@ async def create_custom_emoji(
36883688
Emojis with subscription roles (see ``roles`` below) are considered premium emoji,
36893689
and count towards a separate limit of 25 emojis.
36903690
3691-
You must have :attr:`~Permissions.manage_guild_expressions` permission to
3691+
You must have :attr:`~Permissions.create_guild_expressions` permission to
36923692
do this.
36933693
36943694
Parameters

disnake/threads.py

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -94,9 +94,10 @@ class Thread(Messageable, Hashable):
9494
*not* point to an existing or valid message.
9595
slowmode_delay: :class:`int`
9696
The number of seconds a member must wait between sending messages
97-
in this thread. A value of `0` denotes that it is disabled.
98-
Bots, and users with :attr:`~Permissions.manage_channels` or
99-
:attr:`~Permissions.manage_messages`, bypass slowmode.
97+
in this thread.
98+
99+
A value of `0` denotes that it is disabled.
100+
Bots, and users with :attr:`~Permissions.bypass_slowmode` permissions, bypass slowmode.
100101
message_count: :class:`int` | :data:`None`
101102
An approximate number of messages in this thread.
102103
@@ -819,7 +820,7 @@ async def add_user(self, user: Snowflake) -> None:
819820
You must have :attr:`~.Permissions.send_messages` permission to add a user to a public thread.
820821
If the thread is private then :attr:`~.Permissions.send_messages` and either :attr:`~.Permissions.create_private_threads`
821822
or :attr:`~.Permissions.manage_messages` permissions
822-
is required to add a user to the thread.
823+
are required to add a user to the thread.
823824
824825
Parameters
825826
----------

0 commit comments

Comments
 (0)