PyMemoryEditor

مكتبة خالصة بلغة بايثون (مبنية على ctypes) تتيح لك فحص وتعديل والبحث في ذاكرة أي عملية قيد التشغيل ببضعة أسطر من بايثون — سير عمل Cheat Engine على ويندوز ولينكس وماك!

اقرأ واكتب وامسح ذاكرة أي عملية — مباشرة من بايثون.
واجهة واحدة موحدة. ثلاثة أنظمة تشغيل. لا حاجة لمجمّع C. لا خطوة بناء محلية.

يعمل على 🪟 ويندوز · 🐧 لينكس · 🍎 ماك — 32-بت و64-بت.

عدّل قيمة في لعبة قيد التشغيل · افحص حالة برنامج حي · استخرج بيانات مباشرة من الذاكرة العشوائية.

التثبيت

pip install PyMemoryEditor

لتثبيت التطبيق الرسومي المرفق (ماسح على نمط Cheat Engine)، استخدم الملحق app:

pip install "PyMemoryEditor[app]"
pymemoryeditor

للمسوحات الأسرع على العمليات الكبيرة، أضف الملحق speed. فهو يضيف NumPy ويؤتمت حلقة المقارنة الرقمية — بسرعة أكبر بحوالي 10–30× على المسوحات الانتقائية:

pip install "PyMemoryEditor[speed]"

📖 الدليل الكامل على Read the Docs.

شاهده أثناء العمل

from PyMemoryEditor import OpenProcess

with OpenProcess(name="game.exe") as process:

    # امسح العملية بأكملها بحثاً عن كل عنوان يحوي القيمة 100.
    for address in process.search_by_value(int, value=100):
        print(f"Found at 0x{address:X}")

    # اقرأ القيمة الحالية، ثم اكتب قيمة جديدة مكانها.
    current = process.read_int(address)
    process.write_int(address, current + 500)

هذا كل شيء — اقرأ أو اكتب أو امسح عملية أخرى بثلاثة أسطر، بنفس الطريقة على كل منصة.

ما بداخلها

🐍 مكتبة بايثون

تحكم كامل بذاكرة عملية أخرى — ببضعة أسطر من بايثون:

• ✅ اقرأ واكتب القيم (int, float, bool, str, bytes)
• 🔍 مسح القيمة بثمانية أنماط مقارنة
• 🎯 مسح الأنماط (AOB على نمط IDA والتعبير المنتظم)
• 🔗 سلاسل المؤشرات + مقبض RemotePointer حي
• 🧭 مسح المؤشرات — ابحث عن مؤشرات ثابتة تتحمل ASLR
• 🗺️ خريطة الذاكرة، الوحدات، الخيوط
• 🧱 خصص وحرر الذاكرة عن بُعد (ويندوز / ماك)

🖥️ التطبيق الرسومي المرفق

كل قوة المكتبة — دون الحاجة لكتابة كود:

• ⚡ لا إعداد — اتصل بعملية وابدأ المسح في ثوانٍ
• 🧲 سير عمل التصفية — أول مسح → مسح تالٍ مع ردود فعل بصرية حية
• 📋 جدول الغش — جمّد / اكتب القيم فوراً، استيراد/تصدير بصيغة JSON
• 🔬 عارض سداسي — تصفح الذاكرة الخام واكتب فيها مباشرة
• 🧩 واجهة مسح المؤشرات — امسح، صدر، وأعد المسح عبر الجلسات بنقرات قليلة
• 🎨 وصول بنقرة واحدة — كل الميزات في متناول يدك، دون حاجة لكتابة كود

📖 التوثيق

التوثيق الكامل موجود على pymemoryeditor.readthedocs.io — التثبيت، سير عمل Cheat Engine، كل دالة ومعامل، دليل التطبيق الرسومي، ملاحظات المنصة واستكشاف الأخطاء.

خريطة سريعة لأين تذهب:

ماذا يمكنني بناءً بهذا؟

• 🎮 تعديل الألعاب وأدوات السرعة — حالة الاستخدام الكلاسيكي لـ Cheat Engine.
• 🔬 التصحيح والفحص الداخلي — افحص الحالة الحية دون إرفاق مصحح.
• 📊 أدوات المراقبة — اعيّن متغيرات في عملية قيد التشغيل للقياس عن بُعد.
• 🔐 أبحاث الأمان وهندسة عكسية — على أنظمتك الخاصة أو التي لديك إذن صريح لاختبارها.
• 🎓 التعلم — التطبيق المرفق أداة تعليمية رائعة لكيفية عمل مسح الذاكرة.

[!NOTE] الاستخدام المسؤول. يتواصل PyMemoryEditor مع العمليات الأخرى عبر واجهات برمجة التطبيقات على مستوى نظام التشغيل. وجّهه فقط نحو العمليات التي تملكها أو لديك إذن صريح لفحصها.

🤝 المساهمة

مساهمات الطلبات (pull requests) وتقارير الأخطاء واقتراحات الميزات مرحب بها جداً. اقرأ CONTRIBUTING.md لإعداد التطوير، تخطيط الاختبارات، ومجموعة الخصوصيات الخاصة بالمنصة التي يجب معرفتها.

إذا ساعدك PyMemoryEditor في مشروعك، فضلاً أعطه ⭐ على المستودع — إنها أسهل طريقة لدعم العمل ومساعدة الآخرين على اكتشاف المكتبة.

الترخيص

صدر تحت رخصة MIT — مجاني للاستخدام الشخصي والتجاري.