منصوبے کے بارے میں

بلیک 8 ماسٹر موبائل لینڈ اسکیپ کے لیے ڈیزائن کیا گیا ایک آف لائن بلیک 8 بلیئرڈ PWA ہے۔ ویب صفحہ کھول کر فوراً کھیلا جا سکتا ہے، اسے موبائل کی ہوم اسکرین پر بھی شامل کیا جا سکتا ہے، اور پہلی بار لوڈ ہونے کے بعد آف لائن چلایا جا سکتا ہے۔ کھیل کے طریقے کے لحاظ سے، کھلاڑی میز پر انگلی سرکا کر کیو کی سمت طے کرتا ہے، دائیں جانب طاقت بار سے ضرب کی طاقت کنٹرول کرتا ہے، اور "شاٹ" پر کلک کر کے تصدیق کرتا ہے۔ پہلی قانونی گیند ڈالنے کے بعد سالڈ یا سٹرائپس تفویض کیے جاتے ہیں، اپنا گروپ صاف کرنے کے بعد بلیک 8 ڈال دینے پر جیت حاصل ہوتی ہے۔ کیو بال جیب میں گرنے، ٹارگٹ گیند کو نہ چھونے یا پہلے غلط گروپ کو چھونے پر فاؤل قرار دیا جاتا ہے اور حریف کو فری بال ملتی ہے؛ جب کھلاڑی کو فری بال ملے تو میز پر قانونی جگہ پر کلک کر کے کیو بال منتقل کی جا سکتی ہے۔ خصوصیات کے اعتبار سے، پروجیکٹ میں Matter.js کے ذریعے گیندوں کا ٹکراؤ، کشن سے ریباؤنڈ، رگڑ سے سست روی اور چھ جیبوں کا پتہ لگانا شامل ہے، نیز آسان بلیک 8 قواعد، مکمل ٹرن اسٹیٹ اور جیت/ہار کا تعین بھی موجود ہے۔ آسان، عام اور مشکل تین کمپیوٹر حریف، تین میز/کیو/ماحول تھیمز، اور قابل ایڈجسٹ نشانہ لائن، طاقت حساسیت، آواز اور وائبریشن فراہم کیے گئے ہیں۔ انٹرفیس لینڈ اسکیپ سیف ایریا کے مطابق ڈھالا گیا ہے، آف لائن کیش اور انسٹال ایبل PWA کی حمایت کرتا ہے۔ مقامی ترقی کے لیے Node.js 22+ اور pnpm درکار ہیں، pnpm install اور pnpm dev چلانے کے بعد براؤزر میں ٹرمینل پر دکھائے گئے لوکل ایڈریس کو کھولیں اور فون کو لینڈ اسکیپ میں گھمائیں۔ تصدیق کے لیے pnpm test اور pnpm build چلائے جا سکتے ہیں، ٹیسٹ قواعد کی سزا، AI کے قانونی ہدف کے انتخاب، ٹکراؤ، رگڑ، کشن ریفلیکشن اور جیب میں گرنے کے تعین کا احاطہ کرتے ہیں۔ اشاعت کے عمل میں، main برانچ پر ہر push ٹیسٹ اور پروڈکشن بلڈ چلاتا ہے، سب پاس ہونے کے بعد GitHub Actions dist کو GitHub Pages پر شائع کرتا ہے؛ پہلی اشاعت کے لیے ریپوزٹری Settings → Pages → Build and deployment میں GitHub Actions منتخب کرنا ضروری ہے۔ ٹیک اسٹیک TypeScript، Vite، Phaser 3، Matter.js، Vitest اور vite-plugin-pwa ہے۔