| --- |
| title: Sayed Bot Team v17 |
| emoji: ⛏️ |
| colorFrom: purple |
| colorTo: blue |
| sdk: docker |
| pinned: false |
| app_port: 7860 |
| --- |
| |
| # Sayed Bot Team v17.0 🤖 |
|
|
| نظام بوتات Minecraft ذكي يبقي سيرفر Aternos يعمل 24/7 |
| مع أدوار متخصصة • سجل لاعبين • حماية AFK • تحسين تلقائي |
|
|
| --- |
|
|
| ## 🚀 خطوات التشغيل |
|
|
| **لا تحتاج تعدل أي كود!** كل الإعداد من المتصفح. |
|
|
| ### 1. أنشئ Space على HuggingFace |
| - روح [huggingface.co/spaces](https://huggingface.co/spaces) |
| - اضغط **Create New Space** |
| - اختر **SDK: Docker** |
| - اكتب اسم (مثلاً: `sayed-bot-team`) |
| - اضغط **Create** |
|
|
| ### 2. ارفع الملفات |
| من تبويبة **Files** داخل الـ Space، اضغط **Upload Files** وارفع: |
| - `Dockerfile` |
| - `bot-team.js` |
| - `package.json` |
| - `README.md` |
| - `aternos-starter.js` |
|
|
| اضغط **Commit changes** وانتظر يبني (دقيقتين تقريباً) |
|
|
| ### 3. ابدأ الإعداد |
| - افتح رابط الـ Space |
| - ستظهر صفحة **إعداد السيرفر** |
| - املأ: IP السيرفر، البورت، الإصدار، عدد البوتات، أسماء البوتات |
| - اضغط **🚀 بدء تشغيل البوتات** — خلاص! ✅ |
|
|
| --- |
|
|
| ## 🔴 حل مشكلة "This Space has been paused" |
|
|
| HuggingFace يوقف الـ Space تلقائياً لو ماجاش زيارة خارجية لفترة. |
| الحل: **واحد من الثلاث طرق دول** (الطريقة 1 أسهل) |
|
|
| --- |
|
|
| ### ✅ طريقة 1 — cron-job.org (أسهل وأسرع، مجاني) |
|
|
| 1. روح [cron-job.org](https://cron-job.org) وسجل مجاناً |
| 2. اضغط **Create cronjob** |
| 3. ضع هذا الـ URL: |
| ``` |
| https://USERNAME-SPACENAME.hf.space/wake |
| ``` |
| *(غيّر `USERNAME` و `SPACENAME` باسمك واسم الـ Space)* |
| 4. **Schedule**: كل 20 دقيقة (Every 20 minutes) |
| 5. اضغط **Create** — خلاص! ✅ |
|
|
| --- |
|
|
| ### ✅ طريقة 2 — GitHub Actions (مجاني 100%) |
|
|
| 1. أنشئ Repository على GitHub (مجاني، حتى private) |
| 2. أنشئ ملف `.github/workflows/keep-alive.yml` بهذا المحتوى: |
|
|
| ```yaml |
| name: Keep HF Space Alive |
| on: |
| schedule: |
| - cron: '*/25 * * * *' |
| workflow_dispatch: |
| jobs: |
| ping: |
| runs-on: ubuntu-latest |
| steps: |
| - name: Ping Space |
| run: | |
| curl -sf "https://USERNAME-SPACENAME.hf.space/wake" || true |
| curl -sf "https://USERNAME-SPACENAME.hf.space/healthz" || true |
| ``` |
|
|
| 3. في **Settings → Secrets → Actions**, أضف `HF_SPACE_URL` |
| 4. فعّل الـ workflow من تبويبة **Actions** |
|
|
| --- |
|
|
| ### ✅ طريقة 3 — UptimeRobot (مراقبة + ping، مجاني) |
|
|
| 1. روح [uptimerobot.com](https://uptimerobot.com) وسجل مجاناً |
| 2. **New Monitor → HTTP(s)** |
| 3. URL: |
| ``` |
| https://USERNAME-SPACENAME.hf.space/healthz |
| ``` |
| 4. Interval: **5 minutes** |
| 5. احفظ — UptimeRobot يضرب الـ Space كل 5 دقائق ✅ |
|
|
| --- |
|
|
| ### ⚙️ إعداد إضافي (اختياري — يقوي الحل) |
|
|
| في الـ Space على HuggingFace → **Settings → Variables and secrets** |
| أضف: |
| ``` |
| HF_SPACE_URL = https://USERNAME-SPACENAME.hf.space |
| ``` |
| هذا يجعل البوت يضرب URL الخارجي من الداخل أيضاً (طبقة إضافية). |
|
|
| --- |
|
|
| ## 🎭 أدوار البوتات (v17) |
|
|
| | الدور | المهمة | |
| |-------|--------| |
| | 🎖️ القائد | يوجّه الفريق، يراقب الأداء، يُفعّل أحداث خاصة | |
| | 🛡️ الحارس | يكشف AFK ويطرد الخاملين (35+ دقيقة) | |
| | 🌾 المزارع | يُعلن عن الأكل ويدير الموارد | |
| | 🔨 البنّاء | نشاط بناء وحركة ذكية | |
| | 💬 الدبلوماسي | يرحّب باللاعبين الجدد ويُرسل رسائل تشجيع | |
|
|
| --- |
|
|
| ## ⚡ تحسينات السيرفر التلقائية (عند الحصول على OP) |
|
|
| البوت يُطبّق هذه الأوامر تلقائياً فور حصوله على OP: |
| ``` |
| /worldborder set 5000 |
| /gamerule doPatrolSpawning false |
| /gamerule doTraderSpawning false |
| /gamerule doInsomnia false |
| /gamerule announceAdvancements false |
| /gamerule maxEntityCramming 8 |
| /gamerule spawnRadius 8 |
| ``` |
|
|
| --- |
|
|
| ## 🎮 إعدادات السيرفر المُوصى بها |
|
|
| 1. **`server.properties`**: |
| - `player-idle-timeout=0` ← لا تطرد البوتات |
| - `online-mode=false` ← لـ Aternos (مهم!) |
| - `view-distance=4` ← أقل lag |
|
|
| 2. **بلاجن مفيدة** من Aternos Plugins: |
| - **AntiAFKPlus** ← ضروري |
| - **ClearLag** ← يُحسّن الأداء |
| - **Spark** ← مراقبة TPS |
|
|
| 3. **اعطِ البوتات OP** من Aternos → Players → OP |
| (أضف اسم كل بوت — هيطبّق التحسينات تلقائياً) |
|
|
| --- |
|
|
| ## 📊 لوحة التحكم |
|
|
| | القسم | المحتوى | |
| |-------|---------| |
| | 🎭 الأدوار | عرض دور كل بوت وحالته | |
| | 🤖 البوتات | حالة كل بوت لحظياً، Ping، موقع | |
| | 👥 سجل اللاعبين | كل لاعع دخل السيرفر + عدد الزيارات | |
| | 📋 الأحداث | سجل كل ما يحدث | |
| | 🔌 البلاجن | البلاجن المكتشفة تلقائياً | |
| | 📈 الأداء | TPS السيرفر وتاريخ الأداء | |
|
|
| --- |
|
|
| ## ❓ مشاكل شائعة |
|
|
| | المشكلة | الحل | |
| |---------|------| |
| | Space paused | طبّق إحدى طرق الـ keep-alive أعلاه | |
| | البوت مش يتصل | تحقق من IP السيرفر وإن Aternos شغّال | |
| | Permission Denied في logs | الـ Dockerfile محدّث (v17) يحل هذا | |
| | إصدار غير متوافق | غيّر الإصدار لـ `auto` في الإعداد | |
| | البوت بيتطرد كل شوية | نصّب AntiAFKPlus في السيرفر | |
|
|
