Upload README.md

README.md

@@ -1,10 +1,183 @@
 ---
-title: BOT2
-emoji: 📊
-colorFrom: red
+title: Sayed Bot Team v17
+emoji: ⛏️
+colorFrom: purple
 colorTo: blue
 sdk: docker
 pinned: false
+app_port: 7860
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 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 في السيرفر |