README.md

---
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 في السيرفر |