📚 وثائق بلاك تريغرام
وثائق الهندسة والنظام
وثائق شاملة لهندسة بلاك تريغرام، تصميم النظام، وأنماط التنفيذ. للمطورين والمهندسين والمساهمين في المصادر المفتوحة.
🏗️ نظرة عامة على الهندسة
بلاك تريغرام مصمم باستخدام مبادئ الهندسة الحديثة، مع التركيز على قابلية الصيانة والأمان والأداء.
🎮 محرك اللعبة
المحرك: Unity (أحدث إصدار LTS)
اللغة: C# للمنطق الأساسي للعبة
الأنماط: ECS (Entity Component System)، State Machines، Observer Pattern
الفيزياء: محرك Unity مع أنظمة ضرر مخصصة
📊 نموذج البيانات
النقاط الحيوية: 70 موقعًا تشريحيًا مع خصائص
الأنماط القتالية: 5 أنماط مع تقنيات فريدة
تقنيات الفنون القتالية: تايكيون وهابكيدو مصنفة
إدارة الحالة: آلات الحالة المحدودة للقتال
🔐 هندسة الأمان
SLSA Level 3: أمن سلسلة التوريد
CI/CD: GitHub Actions مع بوابات أمان
جودة الكود: SonarCloud، CodeQL
الاعتماديات: Dependabot، مراجعات أمان
⚔️ تصميم نظام القتال
🎯 نظام الاستهداف
محرك الاستهداف: خوارزميات اكتشاف النقاط الحيوية بأشعة مخروطية
حساب الضرر: قائم على الموقع التشريحي والقوة والتوقيت
استجابة الضربة: آثار ديناميكية بناءً على النقطة الحيوية المستهدفة
أنظمة التغذية الراجعة: تأثيرات بصرية، ردود فعل لمسية، صوت
🥋 نظام التقنيات
تايكيون: حركات سلسة، ركلات دائرية، كسح
هابكيدو: قفل المفاصل، مصارعة، نقاط ضغط
الهجمات المركبة: سلاسل تقنيات لضرر أعلى
كسر الدفاع: تقنيات متخصصة لاختراق الدفاع
🤖 نظام الذكاء الاصطناعي
أنماط السلوك: 5 شخصيات ذكاء اصطناعي فريدة
شجرة القرارات: تكتيكات قتالية ديناميكية
التعلم: يتكيف مع أسلوب لعب اللاعب
فلسفة I Ching: توقع الأنماط وصنع القرار
🔧 تكامل Unity
📦 بنية المشروع
Scripts/ - منطق اللعبة بلغة C#
Assets/ - الأصول البصرية والصوتية
Prefabs/ - الشخصيات والأعداء القابلة لإعادة الاستخدام
Scenes/ - بيئات اللعبة ومستويات المباراة
⚙️ أنماط التطوير
ScriptableObjects: تكوينات البيانات
Singleton Pattern: مديرو اللعبة
Observer Pattern: نظام الأحداث
Object Pooling: تحسين الأداء
🎨 خطوط أنابيب الأصول
الرسوم: Sprites ثنائية الأبعاد، الرسوم المتحركة
الصوت: تأثيرات القتال، موسيقى تقليدية
التحسين: أطالس الأنسجة، ضغط الأصول
التوطين: ملفات ترجمة متعددة اللغات
🔒 الأمان والجودة
🛡️ SLSA Level 3
البناءات الآمنة: بيئة بناء معزولة
المصادقة: توقيعات البناء موقعة
الشفافية: سجلات البناء العامة
القابلية للتكرار: بناءات حتمية
📊 جودة الكود
SonarCloud: التحليل المستمر
CodeQL: فحص أمان الكود
التغطية: اختبارات الوحدة والتكامل
المراجعة: مراجعات الأقران المطلوبة
🤝 المصادر المفتوحة
الترخيص: Apache License 2.0
المساهمات: مرحب بها ومراجعة
الوثائق: شاملة ومحدثة
المجتمع: Discord، GitHub Discussions
🔄 سير العمل التطويري
📋 CI/CD Pipeline
الالتزام: الفحوصات التلقائية، التنسيق
البناء: Unity Cloud Build
الاختبار: الوحدة، التكامل، اللعب
النشر: إصدارات GitHub، itch.io
🧪 استراتيجية الاختبار
اختبارات الوحدة: نظام القتال، النقاط الحيوية
اختبارات التكامل: تفاعلات الشخصيات
اختبارات اللعب: الميكانيكا، التوازن
اختبارات الأداء: معدل الإطارات، الذاكرة
📖 التوثيق
README: نظرة عامة على المشروع
وثائق API: مرجع الكود
أدلة: دليل المساهم
Wiki: أدلة التصميم، أفضل الممارسات
🏛️ الحفاظ على الثقافة في التصميم
📚 الأصالة الثقافية
كل تقنية فنون قتالية مبحوثة من مصادر تاريخية. تم التشاور مع خبراء تايكيون وهابكيدو للدقة التقنية.
🎓 القيمة التعليمية
تحتوي اللعبة على محتوى تعليمي حول تاريخ الفنون القتالية الكورية والفلسفة والسياق الثقافي. يتعلم اللاعبون أثناء اللعب.
🌏 الوصول العالمي
دعم التوطين لعدة لغات. تُحفظ المصطلحات الكورية (الهانغل) مع الشروحات في كل لغة.
🚀 البدء
📥 التثبيت
المتطلبات: Unity 2022.3 LTS أو أحدث
الاستنساخ: git clone https://github.com/Hack23/blacktrigram.git
الفتح: افتح المشروع في Unity Hub
البناء: dotnet build
🎮 تشغيل اللعبة
الويب: blacktrigram.com
محليًا: افتح في Unity واضغط على Play
البناء: File → Build Settings → Build
التنزيلات: إصدارات GitHub
🤝 المساهمة
القضايا: أبلغ عن الأخطاء، اقترح الميزات
طلبات السحب: إرشادات المساهمة على GitHub
الترجمة: ساعد في توطين اللعبة
المجتمع: انضم إلى Discord، GitHub Discussions
📂 استكشف الكود
بلاك تريغرام مفتوح المصدر بالكامل. استكشف الكود، تعلم من التنفيذ، وساهم في المشروع.