fzjstrs/boot

⚡ Sayed's Minecraft Bot v10.0

نظام بوتات Minecraft متطوّر يعمل 24/7 على سيرفرات Aternos مع تجاوز احترافي لحماية كشف البوتات.

---

📋 المحتويات

الملف	الوصف
bot.js	بوت واحد متطوّر — v10.0
bot-team.js	نظام 3 بوتات منسّقة — v10.0
.env.example	قالب إعدادات البيئة
Dockerfile	للنشر على Docker / Hugging Face
package.json	التبعيات

---

⚡ التشغيل السريع

# 1. نسخ ملف الإعدادات
cp .env.example .env

# 2. تعديل القيم في .env
nano .env

# 3. تثبيت المكتبات
npm install

# 4. تشغيل نظام الثلاثة بوتات (موصى به)
node bot-team.js

# أو تشغيل بوت واحد فقط
node bot.js

---

⚙️ إعدادات .env

# السيرفر (مطلوب)
MC_HOST=yourserver.aternos.me
MC_PORT=25565
MC_VERSION=1.20.4

# الأسماء (offline mode)
BOT1_NAME=Alex_miner26
BOT2_NAME=Steve_builder
BOT3_NAME=NightExplorer

# Microsoft Auth (موصى به — يحل اليوم الثالث)
# MC_EMAIL=your@email.com
# MC_PASSWORD=yourpassword

# مدة الجلسة (ساعات)
SESSION_MIN_H=5
SESSION_MAX_H=10

# فترة الغياب (دقائق)
DAY3_BREAK_MIN=30
DAY3_BREAK_MAX=90

# توقيت الدخول بين البوتات (ثوانٍ)
BOT_STAGGER_MIN=120
BOT_STAGGER_MAX=240

# منفذ لوحة المراقبة
PORT=7860

---

🛡️ إصلاحات v10.0

Bug Fixes

الكود	الوصف
BUG-01	handleChat يُرسل رسالة مختلفة عمّا يُسجّل — مُصلَح
BUG-02	chatLoop يضرب بدل يقسم chatFreq — مُصلَح
BUG-03	miner يحفر في نفس موقع البوت — مُصلَح
BUG-04	coordinator restart يتجاوز scheduleReconnect — مُصلَح
BUG-05	bot.options.auth غير موجود → crash في spawn — مُصلَح
BUG-06	blockInteract لا يتحقق من وجود البلوك — مُصلَح

الاستقرار (STAB)

الكود	الوصف
STAB-01	معالجة EPIPE/ETIMEDOUT/ECONNRESET على مستوى العملية
STAB-02	Self-Heal loop — تُعيد أي حلقة توقفت أكثر من 8 دقائق
STAB-03	تنظيف كامل لكل المؤقتات عند الانقطاع
STAB-04	Backoff أسّي يُصفَّر بعد كل نجاح اتصال
STAB-05	spawn handler مُغلَّف بـ try-catch — لا crash يوقف الحلقات
STAB-06	connTimer يُلغى في جميع مسارات الخروج

---

🎭 الشخصيات الثلاثة

البوت	الشخصية	السلوك
⛏️ Alex_miner26	حفّار	يركض للكهوف، يحفر بلوكات حقيقية بـ findBlock()
🏗️ Steve_builder	بنّاء	يتحرك ببطء، يتراجع وينظر للبناء
🗺️ NightExplorer	مستكشف	يدور 360°، يندفع مفاجئاً، يتوقف وينظر

---

📊 لوحة المراقبة

بعد التشغيل افتح: http://localhost:7860

• حالة كل بوت (متصل / منقطع / يتصل)
• إجمالي الجلسات والوقت المتصل
• متوسط Ping
• صحة كل حلقة (walk, chat, look, ...) مع loopTick
• وضع الاستخفاء والشات

---

🐳 تشغيل بـ Docker / Hugging Face

Hugging Face Space (مجاني 24/7)

1. أنشئ Space جديد → اختر Docker
2. ارفع جميع الملفات
3. في Settings → Variables أضف:
   • MC_HOST ← عنوان سيرفرك
   • MC_PORT ← المنفذ
   • MC_VERSION ← إصدار السيرفر (مثال: 1.20.4)
4. اختياري: أضف MC_EMAIL و MC_PASSWORD لـ Microsoft Auth

Docker محلي

docker build -t sayed-bot .
docker run -d \
  --name mc-bot \
  --env-file .env \
  -p 7860:7860 \
  --restart unless-stopped \
  sayed-bot

---

📝 الحلقات النشطة

الحلقة	الوصف	التوقيت
walk	مشي عشوائي بـ pathfinder	15-33 ثانية
look	نظر حول + تتبّع اللاعبين	4-11 ثانية
chat	رسائل عشوائية بشخصية مميّزة	2-7 دقائق
gesture	زحف، قفز، دوران	38-88 ثانية
antiAfk	حركة صغيرة لمنع AFK	55-98 ثانية
microAdj	تعديلات اتجاه صغيرة جداً	3-8 ثوانٍ
swing	تأرجح الذراع	9-38 ثانية
hotbar	تغيير الخانة النشطة	4-14 دقيقة
inventory	محاكاة فتح الحقيبة	8-22 دقيقة
blockInteract	تفاعل حقيقي مع بلوكات قريبة	10-25 دقيقة
sprintJump	ركض + قفزات متتالية	14-38 دقيقة
command	أوامر /list /help	28-88 دقيقة
personality	سلوك خاص بالشخصية (حفر/بناء/استكشاف)	7-20 دقيقة

---

🔧 استكشاف الأخطاء

المشكلة	الحل
"Connection refused"	تأكد أن السيرفر شغّال في Aternos
"Bot detected"	Stealth Mode يُفعَّل تلقائياً لـ 40+ دقيقة
"Server is full"	البوت يعيد المحاولة بعد 90-180 ثانية
"chat signing required"	ضع enforce-secure-profile=false في Aternos Options
البوت مطرود بـ AFK	ضع player-idle-timeout=0 في Aternos Options
الكل انقطع	B1 يُعيد الاتصال تلقائياً خلال 15-120 ثانية

---

by Sayed — Bot Team v10.0