الأدوار والصلاحيات

كيف تُحسب الصلاحيات

1. يستطيع مالك السيرفر فعل كل شيء.
2. وإلا فالبداية من الصلاحيات الافتراضية للسيرفر (@everyone).
3. أضف صلاحيات كل دور للعضو (allow)، ثم احذف ما ترفضه الأدوار، من الأدنى ترتيبًا إلى الأعلى.
4. في القناة، طبّق التجاوز الافتراضي للقناة، ثم تجاوزات الأدوار بالطريقة نفسها.
5. العضو في مهلة لا يحتفظ إلا برؤية القناة وقراءة الرسائل السابقة.

الصلاحيات رقم من 64 بتًا، وكل صلاحية بت واحد. استخدم BigInt في JavaScript: فالرقم العادي لا يحفظ كل بت بدقة.

const SEND_MESSAGE = 1n << 22n;
const canSend =
  (BigInt(interaction.user_permissions_string) & SEND_MESSAGE) === SEND_MESSAGE;

يخبرك كل تفاعل بصلاحيات من استخدمه (user_permissions_string) وصلاحيات بوتك (app_permissions_string) في تلك القناة، فنادرًا ما تحتاج إلى حسابها بنفسك.

أسماء الصلاحيات

تذكر نقاط النهاية في هذا المرجع صلاحيات مثل Timeout Members. وفي الأخطاء تُكتب الصلاحية نفسها TimeoutMembers، وهو العمود الأول في الجدول أدناه. اجمع القيم لإرسال عدة صلاحيات: Kick Members (64) وBan Members (128) تساويان 192.

المواضيع والمنتديات

الصلاحيات CreateThreads وSendMessageInThreads وCreateForumPosts مفعّلة افتراضيًا لـ @everyone. امنعها في دور أو في قناة ليقتصر هؤلاء الأعضاء على القراءة. تُقرأ من القناة الأم، إضافة إلى صلاحية إرسال الرسائل.

الترتيب

للأدوار ترتيب، والرقم الأقل أعلى مرتبة. لا يعدّل البوت أو يمنح أو يسحب أو يطرد أو يحظر أو يعطي مهلة إلا لأعضاء وأدوار أدنى من أعلى دور له. وإلا أجاب السيرفر بـNotElevated. اطلب من مسؤولي السيرفر رفع دور بوتك إذا كان يشرف.

بتات الصلاحيات

المرجع

PUT /channels/{target}/permissions/{role_id}

Set Role Permission. Sets permissions for the specified role in this channel. Channel must be a TextChannel.

الصلاحيات: Channel:ManagePermissions · حد المعدل: channels, 15 / 10 s

PUT /channels/{target}/permissions/default

Set Default Permission. Sets permissions for the default role in this channel. Channel must be a Group or TextChannel. A channel synced with its category stops following it: it keeps a copy of the category's permissions and the change applies on top.

الصلاحيات: Channel:ManagePermissions · حد المعدل: channels, 15 / 10 s

PUT /channels/{target}/permissions/members/{user_id}

Set Member Permission. Sets one member's permissions in this channel, applied after every role (for example a ticket only its author and the staff can see). An empty override (allow 0, deny 0) removes it. Channel must be a TextChannel. Needs Manage Permissions in the channel, a higher rank than the member, and only the permissions you hold yourself.

الصلاحيات: Channel:ManagePermissions · حد المعدل: channels, 15 / 10 s

POST /channels/{target}/permissions/sync

Sync Permissions With Category. The channel follows its category's permissions again; its own default and role overrides are cleared. Per-member overrides stay.

الصلاحيات: Channel:ManagePermissions · حد المعدل: channels, 15 / 10 s

PUT /servers/{target}/categories/{category_id}/permissions/{role_id}

Set Category Role Permission. Sets a role's permissions for a category. Channels synced with the category use them instead of their own. An empty override removes it.

حد المعدل: servers, 5 / 10 s

PUT /servers/{target}/categories/{category_id}/permissions/default

Set Category Default Permission. Sets the default permissions for a category. Channels synced with the category use them instead of their own.

حد المعدل: servers, 5 / 10 s

PUT /servers/{target}/permissions/{role_id}

Set Role Permission. Sets permissions for the specified role in the server.

الصلاحيات: Channel:ManagePermissions · حد المعدل: servers, 5 / 10 s

PUT /servers/{target}/permissions/default

Set Default Permission. Sets permissions for the default role in this server.

الصلاحيات: Channel:ManagePermissions · حد المعدل: servers, 5 / 10 s

POST /servers/{target}/roles

Create Role. Creates a new server role.

الصلاحيات: Channel:ManageRole · حد المعدل: servers, 5 / 10 s

DELETE /servers/{target}/roles/{role_id}

Delete Role. Delete a server role by its id.

الصلاحيات: Channel:ManageRole · حد المعدل: servers, 5 / 10 s

GET /servers/{target}/roles/{role_id}

Fetch Role. Fetch a role by its id.

حد المعدل: servers, 5 / 10 s

PATCH /servers/{target}/roles/{role_id}

Edit Role. Edit a role by its id.

الصلاحيات: Channel:ManageRole · حد المعدل: servers, 5 / 10 s

PATCH /servers/{target}/roles/ranks

Edits server roles ranks. Edit's server role's ranks.

الصلاحيات: Channel:ManageRole · حد المعدل: servers, 5 / 10 s