الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

رباعي

تيه · شجرة · اذهب

عرض التطبيق

تطبيق Golang لـ Tetris، وفقًا للمبادئ التوجيهية الرسمية لتصميم Tetris لعام 2009.

يتكون هذا المشروع من ثلاثة مكونات رئيسية، اعتمادًا على أهدافك:

  • "أريد فقط أن ألعب تتريس"
    • إن TUI (واجهة المستخدم النصية) في cmd/tetrigo/ مناسبة لك. راجع قسم التثبيت.
  • "أريد إنشاء لعبة Tetris/واجهة المستخدم الخاصة بي"
    • الحزم الموجودة في pkg/tetris/modes/ مخصصة لك. يمكنك إعادة استخدام أوضاع اللعبة هذه باستخدام واجهة المستخدم الخاصة بك.
  • "أريد إنشاء وضع لعبة Tetris الخاص بي"
    • الحزم الموجودة في pkg/tetris/ مخصصة لك. يمكنك إنشاء وضع اللعبة الخاص بك باستخدام مجموعة مخصصة من القواعد والمتطلبات.

يمكنك العثور على مزيد من المعلومات حول هذه الأقسام في قسم التطوير. إذا كان لديك اقتراح أو خطأ أو طلب ميزة، يرجى فتح مشكلة GitHub.

محتويات

  • تثبيت
  • الاستخدام
  • إعدادات
  • بيانات
  • تطوير

تثبيت

يمكن تثبيت Tetrigo عن طريق تنزيل الملف الثنائي أو عن طريق البناء من المصدر. راجع الإرشادات أدناه لمعرفة الطريقة المفضلة لديك.

ثنائي

يمكنك تنزيل الملف الثنائي المتوافق مع نظام التشغيل الخاص بك من صفحة الإصدارات على GitHub.

بمجرد التنزيل، يمكنك تشغيل الملف الثنائي من سطر الأوامر: 

 # Linux or macOS
./tetrigo

# Windows
tetrigo.exe

اختياريًا، يمكنك نقل الملف الثنائي إلى دليل في $PATH الخاص بك لتشغيله من أي مكان (على سبيل المثال).

البناء من المصدر

تأكد من أن لديك إصدارًا مدعومًا من Go مثبتًا وإعدادًا بشكل صحيح. يمكنك العثور على الحد الأدنى المطلوب من إصدار Go في ملف go.mod.

يمكنك بعد ذلك تثبيت الإصدار الأحدث عالميًا عن طريق تشغيل: 

go install github.com/Broderick-Westrope/tetrigo/cmd/tetrigo@latest

أو يمكنك التثبيت في دليل آخر: 

env GOBIN=/bin go install github.com/Broderick-Westrope/tetrigo/cmd/tetrigo@latest

الاستخدام

للحصول على معلومات عامة حول كيفية لعب تتريس، راجع دليل المبتدئين هذا.

الضوابط

عناصر التحكم الافتراضية في اللعبة هي كما يلي:

  • التحرك لليسار : A
  • التحرك لليمين : D
  • تبديل تشغيل/إيقاف التشغيل الناعم : S
  • السقوط الصعب : W
  • تدوير في اتجاه عقارب الساعة : E
  • تدوير عكس اتجاه عقارب الساعة : Q
  • اضغط مع الاستمرار على خيار قائمة Tetrimino / إرسال : Space أو Enter
  • إيقاف اللعبة مؤقتًا / الخروج : Escape
  • لعبة فرض الإنهاء : Ctrl+C
  • عرض تعليمات عناصر التحكم : ?

يمكن تغيير عناصر التحكم في اللعبة في ملف التكوين.

يمكن التنقل في القائمة ولوحة المتصدرين وما إلى ذلك باستخدام مفاتيح الأسهم (التحرك)، والهروب (الخروج)، والدخول (الإرسال). عناصر التحكم هذه غير قابلة للتكوين.

إعدادات

سطر الأوامر

سيؤدي بدء تشغيل Tetrigo بدون أمر فرعي أو أعلام إلى بدء اللعبة في القائمة حيث يمكنك تكوين الإعدادات البسيطة يدويًا مثل اسم اللاعب ووضع اللعبة: 

./tetrigo

يمكنك أيضًا بدء اللعبة مباشرةً في أحد أوضاع اللعب (على سبيل المثال، ماراثون)، وتخطي القائمة: 

 # Start the game in Marathon mode with a level of 5 and the player name "Brodie"
./tetrigo play marathon --level=5 --name=Brodie

لرؤية المزيد من الخيارات لبدء اللعبة يمكنك تشغيل: 

./tetrigo --help

تومل

يمكن إجراء تكوين أكثر تعقيدًا باستخدام ملف TOML. إذا لم يتم العثور على ملف التكوين، فسيتم استخدام الإعدادات الافتراضية المعقولة.

افتراضيًا، سيبحث Tetrigo عن الملف ./tetrigo/config.toml داخل دليل تكوين XDG للأجهزة (أو ما يعادله). يحدد adrg/xdg قيم XDG_CONFIG_HOME لأنظمة تشغيل مختلفة (على سبيل المثال، في نظام التشغيل macOS يوجد دليل ~/Library/Application Support وسيتم تخزينه هناك، وإلا في ~/Library/Preferences ). يمكنك تحديد ملف مختلف باستخدام علامة --config . 

./tetrigo --config=/path/to/config.toml

يتوفر مثال لملف التكوين في example.config.toml .

بيانات

يتم تخزين بيانات اللعبة في قاعدة بيانات SQLite. افتراضيًا، يتم تخزين قاعدة البيانات في ./tetrigo/tetrigo.db داخل دليل بيانات XDG للأجهزة (أو ما يعادله). يحدد adrg/xdg XDG_DATA_HOME لأنظمة التشغيل المختلفة (على سبيل المثال، في نظام التشغيل macOS، إذا كان دليل ~/Library/Application Support موجودًا، فسيتم تخزينه هناك، وإلا في /Library/Application Support ). يمكنك تحديد مسار ملف مختلف باستخدام علامة --db . 

./tetrigo --db=/path/to/data.db

تطوير

يتكون هذا المشروع من ثلاثة مكونات رئيسية:

  1. cmd/tetrigo/ : واجهة مستخدم نصية (TUI) تتيح لك تشغيلها خارج الصندوق. كما أنه بمثابة عرض توضيحي لكيفية استخدام الحزم وكيفية إنشاء TUI باستخدام Bubble Tea.
  2. pkg/tetris/modes/ : الوظيفة لمختلف أوضاع لعبة Tetris. يمكن استخدام هذا لإنشاء لعبة Tetris بسهولة باستخدام واجهة المستخدم الخاصة بك ولكن دون الحاجة إلى معرفة مجموعة القواعد.
  3. pkg/tetris/ : منطق Tetris الأساسي، بما في ذلك أشياء مثل Tetrminimos، وMatrix، والتسجيل. يمكن استخدام هذا لإنشاء أوضاع لعب مع مجموعة القواعد والمتطلبات الخاصة بك.

المهمة هي أداة البناء المستخدمة في هذا المشروع. يوجد تكوين المهمة في Taskfile.yaml. بمجرد تثبيت Task CLI، يمكنك رؤية جميع المهام المتاحة عن طريق تشغيل: 

task -l

يمكنك تشغيل TUI باستخدام مهمة run : 

task run

مبنى

يمكنك بناء المشروع باستخدام مهمة build : 

task build

سيؤدي هذا إلى إنشاء ملف ثنائي في دليل bin/ والذي يمكن تشغيله باستخدام الإرشادات الموجودة في قسم التثبيت.

اختبار

يمكن إجراء الاختبارات باستخدام مهمة test : 

task test

يمكنك أيضًا استخدام مهمة cover لإنشاء تقرير تغطية وفتحه: 

task cover

الأولويات المطلوبة للاختبار هي:

  1. pkg/tetris/
  2. pkg/tetris/modes/
  3. cmd/tetrigo/

المهام

  • إضافة المزيد من الاختبارات
    • إضافة اختبارات لتسجيل النقاط endOnMaxLevel.
    • إعادة النظر في اختبارات التسجيل.
  • أضف خيارات التأمين المتبقية.
  • تحقق من القفل لمدة 0.5 ثانية بعد الهبوط على السطح
    • أيضًا على Soft Drop، ولكن ليس على Hard Drop.
    • يتم إعادة ضبط هذا بعد كل حركة ودوران، ليصبح المجموع 15 حركة/دورة.
    • راجع "تأمين الموضع الممتد" في إرشادات التصميم.
  • تسجيل نقاط من T-Spins
  • SSH Multiplayer (أشبه بـ Gambit)
يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل