README.md

metadata

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
• اضغط 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 وسجل مجاناً
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 بهذا المحتوى:

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 وسجل مجاناً
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 في السيرفر