يرسل ويب هوك رسالة قصيرة إلى قناة Discord عندما يحدث شيء في سيرفرك: يبدأ أو يتوقف أو يتعطل، أو ينضم لاعب أو يغادر، أو تنتهي نسخة احتياطية. يراها كل من في القناة دون فتح اللوحة. ويمكن لويب هوك أيضًا أن يرسل إلى أي عنوان https آخر، لأدواتك الخاصة.
مالك السيرفر وحده يستطيع إعداد الويب هوك الخاص به. الأشخاص الذين دعوتهم إلى السيرفر لا يرون هذه الصفحة.
1. أنشئ ويب هوك في Discord
تحتاج إلى صلاحية إدارة الويب هوك في سيرفر Discord. مالكه ومشرفوه يملكونها عادةً.
- في Discord افتح Server Settings ثم انتقل إلى Integrations.
- اضغط Create Webhook، وسمِّه، واختر القناة النصية التي يرسل إليها، مثل قناة
#server-alerts. - اضغط Copy Webhook URL.
يشرح Discord هذه الخطوات بالصور في دليله Intro to Webhooks. تعامل مع رابط الويب هوك كأنه كلمة مرور: أي شخص يملكه يستطيع النشر في تلك القناة.
2. أضفه إلى سيرفرك
- افتح سيرفرك في لوحة التحكم واضغط ويب هوك في القائمة اليمنى.
- اضغط أضف واحدًا، أو ويب هوك جديد إذا كان للسيرفر ويب هوك بالفعل.
- أعطه الاسم إن أردت. هو لك وحدك، ويسمّي الويب هوك في قائمتك.
- الصق العنوان في URL. يجب أن يبدأ بـ
https://. وعندما يكون ويب هوك من Discord، تعرض اللوحة تم التعرف على ويب هوك Discord. - تحت أرسله عندما، حدّد الأحداث التي تريدها (انظر أدناه). الخيار تعطل الخادم محدّد في البداية، ويجب تحديد حدث واحد على الأقل.
- اضغط إنشاء ويب هوك.
الأحداث
| الحدث | متى يُرسل |
|---|---|
| بدأ الخادم | عندما يصبح السيرفر جاهزًا للاعبين، بما في ذلك بعد إعادة التشغيل. |
| توقف الخادم | إيقاف طلبه أحدهم: أنت أو أحد أعضاء الفريق أو جدول. |
| تعطل الخادم | توقف السيرفر دون أن يُطلب منه ذلك. يُرسل بعد دقيقة أو دقيقتين، حين نتأكد، ويذكر ما إذا كان السيرفر قد عاد من تلقاء نفسه. |
| انضمام لاعب | مع اسم اللاعب، في الألعاب التي تبلغ عمّن هو متصل. أما الألعاب التي تبلغ عن العدد فقط فتذكر كم عددهم. |
| مغادرة لاعب | الأمر نفسه عندما يغادر أحد. يُفحص اللاعبون مرة في الدقيقة ما دام السيرفر يعمل. |
| انتهت النسخة الاحتياطية | يذكر هل نجحت النسخة الاحتياطية، وما حجمها. |
| انتهى التثبيت | بعد التثبيت الأول أو إعادة التثبيت. |
| انتهى النقل | عندما ينتهي نقل سيرفرك. |
لسيرفرات Project Zomboid أحداث إضافية تُقرأ من سجل اللعبة: موت لاعب وقتل PvP وإجراء مشرف وتحديث مود وبدأ العد التنازلي لإعادة التشغيل ونقل الدردشة داخل اللعبة. لا تُرسل الدردشة إلا إذا حدّدتها، ولا تُرسل إلا الدردشة العامة: لا تُرسل أبدًا الهمسات ولا دردشة الفصائل ولا دردشة الملاجئ.
ما الذي يصل
- في Discord تأتي الرسائل من PlayNHost على شكل بطاقات قصيرة فيها اسم السيرفر وما حدث ومتى. يعرض Discord الوقت بالمنطقة الزمنية لكل قارئ.
- تذكر الرسائل اسم سيرفرك لكنها لا تتضمن عنوانه ولا معرّفه أبدًا، لذلك يمكن إرسالها إلى قناة عامة. ولتغيير الاسم الذي تعرضه، أعد تسمية السيرفر. راجع كيف تعيد تسمية سيرفرك وتغيّر خانات اللاعبين.
- لا يستطيع لاعب أن ينبّه قناتك باسمه. اسم مثل
@everyoneيصل كنص عادي. - أي عنوان آخر يتلقى الأحداث بصيغة JSON. راجع لأدواتك الخاصة أدناه.
أوقف الويب هوك أو عدّله أو احذفه
- استخدم المفتاح في صف الويب هوك لإيقافه وتشغيله مرة أخرى. يحتفظ بإعداداته وهو متوقف.
- افتح قائمة الصف واختر تعديل لتغيير الاسم أو العنوان أو الأحداث، أو حذف لإزالته. لا يتأثر شيء آخر: يواصل سيرفرك العمل، وتتوقف القناة ببساطة عن تلقي الرسائل.
معلومات مفيدة
- يمكن أن يكون للسيرفر حتى 10 ويب هوك، مثلًا واحد لكل قناة.
- لإبقاء القناة مقروءة، يرسل كل ويب هوك 4 رسائل في الدقيقة و40 رسالة في الساعة على الأكثر. تُتجاوز الرسائل الزائدة بدل أن تصل متأخرة، وتذكر الرسالة التالية كم تحديثًا سابقًا تم تجاوزه.
- إذا حُذف الويب هوك في Discord، توقفه اللوحة بنفسها عند أول محاولة إرسال تالية، ويعرض الصف متوقف. أنشئ ويب هوك جديدًا في Discord، واختر تعديل، والصق العنوان الجديد، ثم شغّله مرة أخرى.
- لا يوجد زر اختبار. للتحقق من ويب هوك جديد، حدّد بدأ الخادم وأعد تشغيل سيرفرك. تصل الرسالة بعد وقت قصير من جاهزية السيرفر.
- الويب هوك مخصص لقناة تتشاركها مجموعتك. وللتنبيهات التي تصلك أنت وحدك، في اللوحة أو بالبريد الإلكتروني، راجع كيف تدير الإشعارات والتفضيلات.
لأدواتك الخاصة
العنوان الذي ليس ويب هوك من Discord يتلقى طلب POST بمحتوى JSON:
sourceقيمتهPlayNHost.eventsقائمة. لكل حدثtype(مثلserver.crashأوplayer.join)، وserver(اسم السيرفر)، وat(متى حدث)، وtitleوtextمقروءان، وكائنdataفيه التفاصيل.skippedهو عدد الرسائل السابقة التي تُركت بسبب الحد المذكور أعلاه.
يجب أن يستخدم العنوان https وأن يشير إلى عنوان عام على الإنترنت. لا تُتّبع عمليات إعادة التوجيه. الرسائل غير موقّعة، لذلك أبقِ العنوان نفسه سريًا.
مقالات ذات صلة
- كيف ترى ما حدث على سيرفرك يوضح من شغّل أو أوقف أو غيّر ماذا، ومتى.
- كيف تصلح سيرفرًا لا يبدأ يساعدك عندما يتكرر تنبيه التعطل.
