ساخت بازی سهبعدی با WebGPU و Expo در سه روز
خلاصهٔ کاملتر
Błażej Kustra از Software Mansion تو این مقاله تعریف میکنه که چطور بازی Purrkour رو ساخته. یه پازل گربهای روی صفحهٔ ۵×۵ که باید همهٔ گربهها رو بفرستی تو جعبه و از روی گربهها، گلدونها و جعبههای پر بپری. کل بازی با WebGPU داخل یه اپ Expo رندر میشه و هیچ فایل تصویر، مدل یا صدا نداره. اولین کامیت ۲۱ جولای ۲۰۲۶ بود و نسخهٔ 1.0.0 با تبلیغات، privacy policy و نسخهٔ وب، ۲۳ جولای آمادهٔ App Store شد.
نویسنده میگه بهجای Unity یا Godot، Expo رو انتخاب کرده چون میخواست منطق بازی، رندر و UI همه TypeScript باشن. نقش اصلی رو TypeGPU داره، یعنی کتابخونهای که تابعهای TypeScript رو به WGSL (زبون shader در WebGPU) کامپایل میکنه. با دستور "use gpu" یه تابع بهعنوان کد shader علامت میخوره و همون کد هم تو Chrome اجرا میشه هم روی گوشی از طریق react-native-webgpu. Expo SDK 57 با New Architecture (React Native 0.86) هم کمک کرد که همهٔ ماژولها بدون دردسر کنار هم کار کنن.
کل بازی تو packages/engine هست و اپ Expo و سایت Vite فقط دو پوستهٔ نازک دورش هستن. یعنی هر باگی یه بار درست بشه، روی هر دو پلتفرم درست شده. موتور اصلاً نمیدونه رو کدوم پلتفرمه و چیزایی مثل GPU context، AudioContext و حافظهٔ ذخیرهسازی (MMKV روی موبایل، localStorage روی وب) از بیرون بهش داده میشن. همهٔ شکلها از مکعب و هرم ساخته شدن و صداها هم زنده از oscillatorها از طریق react-native-audio-api تولید میشن.
بازی ۲۵ مرحله داره. ۱۰ تای اول دستی طراحی شدن و بقیه رو یه اسکریپت از بین دهها هزار صفحهٔ تصادفی انتخاب کرده که یه solver از نوع BFS (یعنی جستوجوی سطحبهسطح که کوتاهترین راهحل رو پیدا میکنه) تأییدشون کرده. مثلاً مرحله نباید فقط با گربهها حل بشه و حرکت اولش هم نباید واضح باشه. یه تست واحد هم هر ۲۵ مرحله رو دوباره حل میکنه تا امتیاز کامل همیشه یه حداقل اثباتشده باشه.
بازی با Claude Code ساخته شده و ایجنت با ابزار Argent خودش بازی رو روی شبیهساز iOS و Chrome اجرا میکرد. مشکل این بود که کل صفحه یه canvas واحده و accessibility tree نداره، پس برای ایجنت فقط یه عکسه. برای همین نویسنده تو نسخهٔ development یه آبجکت __purrkour روی global گذاشت که با همون محاسبهٔ دوربینِ رندرر، جای دقیق هر خونه رو روی صفحه برمیگردونه. ایجنت حرکت بعدی رو از solver میگرفت، جاش رو از این bridge میپرسید، تپ میکرد و با state() و اسکرینشات نتیجه رو چک میکرد.
بازی روی 120fps اجرا میشه، هرچند نویسنده میگه این بیشتر نشون میده که استک سر راه نیست تا یه بنچمارک واقعی. تنها آرزوش از Expo هم پشتیبانی WebGPU تو Expo Go هست تا بشه بدون development build امتحانش کرد.
نکات کلیدی:
- از اولین کامیت (۲۱ جولای ۲۰۲۶) تا آماده شدن برای App Store فقط سه روز و ۱۵ کامیت طول کشید.
- TypeGPU کد TypeScript رو به WGSL تبدیل میکنه و همون shader روی وب و iOS اجرا میشه.
- استک: Expo SDK 57، React Native 0.86، react-native-webgpu، react-native-audio-api، Reanimated 4.
- ۲۵ مرحله که سختترهاش با یه solver از نوع BFS فیلتر شدن و از ۱ تا ۲۰ حرکت سختی دارن.
- یه debug bridge به اسم __purrkour به ایجنت هوش مصنوعی اجازه داد روی canvas بدون accessibility tree تست کنه.
- WebGPU هنوز تو Expo Go پشتیبانی نمیشه و development build لازمه.




