BUNNY BOT v1.0.3 — مصدر تطوير نظيف
====================================

هذه الحزمة مخصّصة للتطوير والاختبار. لا تحتوي على حسابات المستخدم أو قواعد
البيانات أو الترخيص أو السجلات أو صور التصحيح أو إعدادات جهاز شخصي.

التشغيل:
1) شغّل run.bat.
2) استخدم run_dry.bat لفحص الواجهة من دون ضغط أو سحب داخل المحاكي.
3) شغّل فحص الجاهزية قبل بدء البوت.
4) اختر المحاكي والنسخة المطلوبة من مدير المحاكيات.

تجهيز الجيش:
- افتح الهجوم ← تجهيز الجيش.
- اختر الحساب واكتب سعة المعسكر وسعة التعويذات وسعة آلات الحصار، ثم حدد
  القوات والتعويذات وآلات الحصار والأبطال لهذا الحساب.
- لكل حساب خطة مستقلة، ويمكن للبوت تصحيح السعة المحفوظة من الرقم الظاهر داخل
  نافذة My Army قبل تجهيز الوصفة.
- لا يبدأ البوت الهجوم إذا كانت الخطة أكبر من السعة أو تعذر العثور بأمان على
  بطاقة مطلوبة داخل واجهة اللعبة.
- يسحب البوت أشرطة الاختيار أفقيًا حتى يعثر على البطاقات الموجودة خارج الجزء
  الظاهر. عند تغيير الخطة يبني الوصفة الجديدة أولًا، ثم يحذف الجيش الحالي
  ويطبقها. لا يحذف دعم قلعة القبيلة، ولا يكرر الحذف إذا لم تتغير الخطة.

التطوير:
- ملفات الاختبار موجودة في نسخة التطوير فقط.
- أنشئ نسخة توزيع جديدة بواسطة tools/create_clean_release.py.
- لا تضع مفتاح Ed25519 الخاص بالتوقيع داخل المشروع أو حزمة المستخدم.
- يجب أن تحتوي النسخة النهائية على BUNNY_BOT.exe وBUNNY_BOT_UPDATER.exe
  من دون ملفات Python مكشوفة.

متطلبات التشغيل الموصى بها:
- الدقة: 860×732.
- DPI: 300.
- محاكي مدعوم واتصال ADB سليم.
- Clash of Clans مثبتة ومفتوحة على المنظر الافتراضي عند الحاجة.

ملاحظة الاختبار:
إذا لم تكن مباريات القبيلة أو غارات عاصمة القبيلة متاحة داخل اللعبة، يفحص
الاختبار قوالبها ومساراتها ومنطقها برمجيًا، ولا يدّعي إجراء اختبار حي لها.

أين يجوز تثبيت البرنامج بعد بنائه
---------------------------------
يحفظ BUNNY BOT كل ما يملكه بجوار ملفه التنفيذي: config.json و stats.json و
data/bunnybot.db و data/license.dat و logs/ و instance.lock. هذا يجعل مجلد
الإصدار مكتفيًا بذاته وقابلًا للنقل، وهو ما يسمح بتشغيل محاكٍ ثانٍ بمجرد نسخ
المجلد.

ويترتب على ذلك أن المجلد يجب أن يكون قابلًا للكتابة لمن يشغّل البرنامج:

  * ثبّته في المستندات أو سطح المكتب أو قرص بيانات.
  * لا تثبّته في Program Files ولا في أي مكان يحتاج صلاحيات المسؤول. يكتشف
    البرنامج ذلك عند البدء ويرفض التشغيل مع شرح السبب، بدل أن يفشل لاحقًا
    بقاعدة بيانات مكتوبة نصفها.
  * مجلد واحد لكل محاكٍ. لا يجوز أن تتشارك نافذتان مجلدًا واحدًا، ومطالبة كل
    محاكٍ تُسجَّل في %LOCALAPPDATA%\BUNNY BOT\locks حتى ترى النسخ المثبّتة في
    أي مكان على الجهاز بعضها.
  * يُفضَّل مجلد لا يرفعه عميل مزامنة باستمرار. قاعدة البيانات تُفتح بوضع WAL
    ويُكتب فيها أثناء عمل البوت، فالعميل الذي ينسخ الملف أثناء الكتابة ينافس
    البرنامج عليه.
