What is the difference between the Embedded and Plugins tabs?

Plugins on the Embedded tab ship inside phBot; you just tick the box. The Plugins tab is for .py files you add yourself, which have to be copied into the Plugins folder.

Where do I download the NsyL Companion plugin?

You don't. The plugin ships embedded in phBot: it sits on the Embedded tab under the name xNsyLMobile, and ticking it is all you need to do.

The plugin is not in the list — what should I do?

For embedded plugins, update phBot — the list ships with the phBot version. If it is a plugin you added yourself, make sure the file ends in .py and sits directly inside the Plugins folder.

I ticked the plugin but nothing happens

Look at phBot's Log tab. If the plugin failed to load, the reason is written there. The most common cause is the plugin not matching that phBot version.

Can I use the same plugin on several characters?

Yes. Each character uses its own Plugin Key, and the plugin runs on all of them at once.

إضافة ملحق إلى phBot — خطوة بخطوة مع الحلول

أولاً: تحقّق من التبويب الصحيح

يحفظ phBot الملحقات في تبويبين منفصلين، وطريقة تثبيتهما مختلفة تماماً. إن لم تجد ملحقاً، فربّما تبحث في التبويب الخطأ.

‏Embedded — الملحقات المدمجة

هذه تأتي داخل phBot. لا شيء يُنزَّل ولا يُنسَخ: افتح تبويب Embedded، وأشّر على مربّع Enabled بجانب الملحق، وانتهى الأمر. ملحقات مثل xNsyLMobile, AutoStyria وDonateGP موجودة هنا.

‏Plugins — المضافة من الخارج

.py الملفّات التي نزّلتها من مكان ما تظهر في هذا التبويب. ويجب نسخها إلى مجلّد phBot — والخطوات التالية لها.

إضافة ملحق خارجي

تثبيت ملحق نزّلته يستغرق أربع خطوات:

اعثر على مجلّد Plugins — مجلّد Plugins داخل مكان تثبيت phBot، مثلاً C:\phBot\Plugins.
انسخ الملفّ إليه — ضع ملفّ .py مباشرة في ذلك المجلّد. لا تنشئ مجلّداً فرعياً؛ فـ phBot يقرأ الملفّات في الجذر فقط.
أعد تشغيل phBot — قائمة الملحقات تُفحص عند الإقلاع فقط، لذا أغلق البرنامج تماماً ثم افتحه من جديد.
أشّر عليه في القائمة — افتح تبويب Plugins وأشّر على المربّع بجانبه. صار يعمل الآن.

لا ينطبق شيء من هذا على NsyL Companion. فالملحق مدمج: يكفي أن تؤشّر على xNsyLMobile في تبويب Embedded.

إذا لم يتحمّل الملحق

كلّ الحالات تقريباً ترجع إلى ثلاثة أسباب:

الملفّ في المكان الخطأ

الملحق داخل مجلّد فرعي لا يراه phBot. يجب أن يكون الملفّ مباشرة في Plugins.

عدم توافق الإصدار

ملحق قديم يستدعي دالّة لم يعد phBot الأحدث يوفّرها لن يتحمّل. وتبويب Log يذكر السطر الذي أخفق.

صلاحية الملحقات

بعض نسخ phBot الخاصّة بخوادم معيّنة ترفض الملحقات الخارجية وتشغّل المدمجة فقط. ونسخ ملفّ إليها لا يغيّر شيئاً.

ما فائدة الملحقات

الملحقات تؤدّي ما لا تؤدّيه واجهة phBot نفسها. أمثلة شائعة:

التحكّم عن بُعد وإرسال التنبيهات إلى الهاتف
تصدير سجلّات السقوط والمبيعات والوفاة
أتمتة المهامّ أو الفعاليات أو رحلات القوافل

أسئلة متكرّرة

ما الفرق بين تبويب Embedded وتبويب Plugins؟

ملحقات تبويب Embedded تأتي داخل phBot؛ يكفي أن تؤشّر على المربّع. أمّا تبويب Plugins فهو لملفّات ‎.py‎ التي تضيفها بنفسك، ويجب نسخها إلى مجلّد Plugins.

من أين أنزّل ملحق NsyL Companion؟

لا تنزّله. الملحق مدمج في phBot: تجده في تبويب Embedded باسم xNsyLMobile، والتأشير عليه هو كلّ ما يلزم.

الملحق غير موجود في القائمة — ماذا أفعل؟

للملحقات المدمجة، حدّث phBot — فالقائمة تأتي مع إصدار phBot. وإن كان ملحقاً أضفته بنفسك، فتأكّد أنّ الملفّ ينتهي بـ ‎.py‎ وأنّه مباشرة داخل مجلّد Plugins، ثم أغلق phBot تماماً وافتحه من جديد.

أشّرت على الملحق لكن لا شيء يحدث

انظر إلى تبويب Log في phBot. إذا أخفق تحميل الملحق فالسبب مكتوب هناك. وأشيع سبب هو عدم مطابقة الملحق لإصدار phBot.

هل يمكنني استخدام الملحق نفسه على عدّة شخصيات؟

نعم. كلّ شخصية تستخدم مفتاح إضافة خاصّاً بها، والملحق يعمل عليها جميعاً في الوقت نفسه.

تابع شخصيتك من هاتفك

ملحق NsyL Companion يأتي مع phBot. والتثبيت يستغرق دقيقتين.

دليل التثبيت