Games Box - Android Games Bundle

🎮 Games Box - 8 in 1 Offline Android Games Bundle

صندوق الألعاب - حزمة 8 ألعاب أندرويد أوفلاين متكاملة (Jetpack Compose + AdMob)

🔥 8 GAMES IN 1 📶 100% OFFLINE 💰 ADMOB READY 🎨 1-FILE RESKIN ⚡ 120 FPS COMPOSE

Overview: Games Box is a complete, top-tier, production-ready Android multi-game platform featuring 8 globally trending, highly addictive casual, logic puzzle, and card games in a single lightweight application! Engineered with modern Jetpack Compose, Kotlin Coroutines, and Clean Multi-Module Architecture.

نبذة عامة: تطبيق جيمز بوكس (Games Box) هو سورس كود متكامل وجاهز للإنتاج فوراً، يضم 8 من أقوى وأشهر الألعاب العالمية في الذكاء والألغاز والورق ضمن تطبيق واحد خفيف وعصري. تم بناؤه بأحدث تقنيات أندرويد (Jetpack Compose و كوتلن) ليعمل بسرعة فائقة 120 إطار بالثانية وبدون إنترنت نهائياً.

🎯 Single-File Reskin System | ميزة الريسكين الفوري من ملف واحد

All game economy, timers, grid sizes, difficulty tiers, and Google AdMob ad units are 100% centralized inside core/src/main/java/com/gr8/core/AppConstants.kt. Customize the whole bundle in minutes without touching internal game algorithms!

جميع إعدادات الألعاب، الاقتصاد، المؤقتات، مستويات الصعوبة، ومعرفات إعلانات أد موب مجمعة بنسبة 100% داخل ملف مركزي واحد AppConstants.kt موثق بالكامل بالعربية والإنجليزية لتعديل التطبيق بالكامل خلال دقائق!

🎮 Included 7 Full Games | تفاصيل الألعاب الـ 7 المدمجة

1. 🧱 Block Blast 3D (Neon Block Puzzle) | تفجير كتل النيون ثلاثي الأبعاد

• World's top trending block puzzle with 3D crystal gemstone blocks, tumbling physics shards, shockwave rings, and punchy explosion audio. اللعبة الأكثر شهرة عالمياً بمظهر نيون 3D وأحجار كريستالية ملونة، شظايا متطايرة، واهتزاز واقعي ومؤثرات صوتية حماسية.
• Dynamic combo multiplier streaks, instant 1:1 hardware touch tracking with zero drag slop delay. سلاسل كومبو متتالية ومضاعفة للنقاط، واستجابة لمس فورية بدون أي تأخير عند السحب والتركيب.

2. 🏹 Arrow Escape (Smart Maze Puzzle) | هروب الأسهم الذكي

• Highly addictive spatial logic puzzle testing planning, sequence reasoning, and path clearance. لغز ذكاء ومتاهات أسهم مشوق للغاية لاختبار التخطيط والتفكير المنطقي وتحرير المسارات.
• Hundreds of progressive grid levels, smooth arrow flyout animations, hearts/lives system, and smart hints & undos. مئات المراحل المتدرجة في الصعوبة، حركات انطلاق رشيقة للأسهم، نظام قلوب وأرواح، وتلميحات وتراجعات ذكية.

3. 🧪 Liquid Sort Puzzle (Water Color Sort) | لغز فرز وسكب الألوان

• Globally renowned relaxing color puzzle with smooth liquid physics and glowing tubes. اللعبة المهدئة للأعصاب الأكثر نجاحاً لفرز السوائل الملونة داخل قوارير زجاجية براقة بفيزياء سكب ممتعة.
• Infinite procedural stage generator, hint assistance, undo moves, and extra bottle helpers. توليد مراحل لا نهائي وتلقائي، تلميحات مساعدة، تراجع عن الحركات، وإمكانية إضافة قارورة إضافية.

4. 🔢 Classic Sudoku (Number Logic) | سودوكو الكلاسيكية

• Full-featured timeless number puzzle with 5 balanced difficulty tiers (Beginner to Expert). لغز الأرقام الياباني الكلاسيكي مع 5 مستويات صعوبة مدروسة (من المبتدئ إلى الخبير).
• Auto-fill candidate notes, real-time error checking, smart highlighting, and detailed gameplay statistics. تدوين تلقائي للملاحظات، فحص فوري للأخطاء، تمييز ذكي للخلايا، وإحصائيات تفصيلية للانتصارات والأوقات.

5. 🃏 Tarneeb 4 Players (Epic Card Partnership) | طرنيب 4 لاعبين

• The most popular 4-player partnership card game in the Middle East with competitive, smart AI bots. أشهر لعبة ورق شراكة 4 لاعبين في العالم العربي والشرق الأوسط مع ذكاء اصطناعي محترف وتكتيكي.
• Authentic bidding system, trump suit mechanics, and classic 31, 41, and 61 score modes. نظام مزايدة وطلبات حقيقي، تحكم كامل بورق الطرنيب، ومطابقات أهداف 31 و 41 و 61 نقطة.

6. 🎲 Classic Dominoes (Double-Six) | دومينو دبل ستة الكلاسيكية

• Official Double-Six domino rules rendered on a luxury green felt table against competitive AI. قواعد الدومينو الكلاسيكية الرسمية على طاولة خضراء فخمة ضد خصم ذكي وسريع.
• Snapping tile chains, boneyard draw pile, closing/blocking tactics, and multiple score targets (50, 100, 150 pts). سلاسل أحجار مترابطة بسلاسة، سحب من البنك، تكتيكات قفل اللعبة، وأهداف نقاط قابلة للتخصيص.

7. 🃏 Egyptian Basra (Classic Card Match) | البصرة المصرية الشعبية

• Fast-paced Mediterranean card capture game with authentic local rules and vibrant animations. لعبة البصرة والكومي السريعة والممتعة بقوانينها الشعبية الأصلية ورسوميات سلسة.
• Jack and 7-Diamond special Basras, card matching & sum capture, and most-cards round bonus. بصرة الولد والـ 7 كاروه، قش كروت الأرض بالمطابقة أو المجموع، وبونص الأكثر كروتاً في نهاية الجولة.

8. 🕷️ Spider Solitaire (Classic & 150-Level Journey) | سوليتير العنكبوت الملكية

• King of classic card solitaires with 1, 2, and 4-suit modes and an epic 150-level campaign across 10 distinct chapters. ملك ألعاب السوليتير بأنماط 1 و 2 و 4 أشكال وخريطة مراحل ملحمية تضم 150 مرحلة موزعة على 10 فصول شيقة.
• Guaranteed solvable deal generator, daily challenges, luxury mahogany casino canvas table, smart hints, and unlimited undos. خوارزمية ذكية لضمان مراحل قابلة للحل 100%، تحديات يومية، طاولة كازينو خشبية فاخرة، وتلميحات وتراجعات ذكية.

Features

⭐ Key Features | المميزات التقنية والتسويقية

• ✓ 7 High-Retention Games in 1 Single App: Enormous storage and download savings for users. 7 ألعاب كاملة عالية التفاعل في تطبيق واحد لتوفير المساحة ومضاعفة بقاء المستخدمين.
• ✓ 100% Offline Gameplay: Zero server costs, zero maintenance, and players can play anywhere without internet. تعمل 100% بدون إنترنت (صفر تكاليف خوادم وسيرفرات، ولا تحتاج لأي اتصال).
• ✓ Full AdMob Monetization Suite: Pre-integrated Banner, Interstitial, Rewarded Video, and App Open Ads. أقصى ربحية عبر إعلانات AdMob (بانر، إعلانات بينية، فيديو بمكافأة، وإعلانات فتح التطبيق).
• ✓ Modern Jetpack Compose 120 FPS: Pure declarative UI with ultra-smooth rendering on modern screens. واجهات Jetpack Compose حديثة بنسبة 100% مع أداء سلس واستجابة تصل إلى 120 إطار بالثانية.
• ✓ Single-File Reskin (AppConstants.kt): Line-by-line bilingual documentation for effortlessly swapping ad IDs and colors. ريسكن كامل من ملف واحد AppConstants.kt مع شروحات عربية وإنجليزية لكل سطر.
• ✓ Ready-to-Use Marketing Assets: Includes 1024x500 Feature Graphic, 8 high-res 1080x1920 screenshots, and bilingual store descriptions. حزمة تسويقية كاملة لجوجل بلاي (بانر 1024x500، 8 صور 1080x1920، والوصفين العربي والإنجليزي).
• ✓ Interactive Offline HTML Reskin Guides: Includes visual HTML documentation in both English and Arabic. دليلا ريسكن تفاعليان ومصوران بتصميم HTML أنيق مدمجان مع السورس كود.
• ✓ DataStore Persistence: Lightweight, rock-solid persistent storage for scores, stats, coins, and settings. تخزين محلي آمن وسريع عبر DataStore لحفظ النقاط والإعدادات وتطور اللاعبين.
• ✓ Clean Modular Architecture: Highly scalable multi-module Gradle structure (:app, :core, :common, etc.). بنية برمجية معيارية نقية متعددة الموديولات لسهولة التعديل أو إضافة ألعاب إضافية.

Requirements

⚙️ Technical Requirements | المتطلبات التقنية

Component | المكون Specification | المواصفات Android Studio Ladybug, Koala, Hedgehog or newer برنامج أندرويد ستوديو الإصدارات الحديثة Language & Framework Kotlin 2.0+ & Jetpack Compose BOM كوتلن وواجهات جيت باك كومبوز الحديثة Android SDK Target Target SDK 36 (Android 15 Ready) / Min SDK 24 (Android 7.0+) يدعم أكثر من 99% من أجهزة أندرويد النشطة بالعالم Java Development Kit JDK 17 or JDK 21 (Bundled inside Android Studio) جافا 17 أو 21 مدمجة تلقائياً في أندرويد ستوديو AdMob Account Free Google AdMob account to create ad unit IDs حساب مجاني لدى Google AdMob لإنشاء وحدات الإعلانات

Instructions

🚀 Step-by-Step Setup & Reskin Instructions | خطوات التثبيت والريسكين

1 Open Project in Android Studio:

Extract the purchased ZIP archive. Open Android Studio (Ladybug, Koala, or Hedgehog recommended), select File > Open... and choose the extracted GamesBox folder. Allow Gradle 1–2 minutes to download dependencies and finish syncing automatically.

فك ضغط ملف الـ ZIP وافتح المشروع عبر أندرويد ستوديو من File > Open واختر مجلد GamesBox وانتظر دقيقة لمزامنة مكتبات Gradle تلقائياً وبدون أي أخطاء.

2 Change Application ID (Package Name):

Open app/build.gradle.kts, locate line 15 inside defaultConfig, and replace applicationId = "com.yourcompany.gamesbox" with your own unique package ID. (No internal directory or package refactoring needed!)

افتح ملف app/build.gradle.kts السطر 15 واستبدل applicationId باسم حزمتك الجديدة الفريد دون الحاجة لأي تعديل على الملفات الداخلية.

3 Configure Google AdMob Ad Units (Single Control File):

Open core/src/main/java/com/gr8/core/AppConstants.kt and scroll to Section 3. Replace the test ad IDs with your live AdMob IDs (ADMOB_APP_ID, ADMOB_BANNER_AD_ID, ADMOB_INTERSTITIAL_AD_ID, ADMOB_REWARDED_AD_ID, ADMOB_APP_OPEN_AD_ID). Also update admob_app_id in core/src/main/res/values/strings.xml.

افتح ملف AppConstants.kt القسم الثالث وضع معرفات إعلانات أد موب الخاصة بك، وحدث معرف admob_app_id في ملف strings.xml.

4 Change Launcher Icon & App Title:

Right-click app/src/main/res > New > Image Asset to generate adaptive launcher icons for all screen densities. Update app_name in core/src/main/res/values/strings.xml (English) and values-ar/strings.xml (Arabic).

حدّث أيقونة التطبيق بنقرة واحدة عبر Image Asset، وغيّر اسم التطبيق في ملفات strings.xml بالعربية والإنجليزية.

5 Splash Screen Branding & Visual Identity:

• Master Hub Splash: Layout is located at app/src/main/res/layout/activity_games_box_splash.xml. To replace the center splash logo, place your PNG image in app/src/main/res/drawable/ and update line 48: android:src="@drawable/your_logo". To customize duration (default 2200 ms) and loading messages, edit app/src/main/java/com/gr8/games/gamesbox/GamesBoxSplashActivity.kt (lines 134 & 142). • Compose Sub-Games: Liquid Sort (liquid_sort_puzzle/.../ui/splash/SplashScreen.kt), Arrow Escape (arrow_escape/.../ui/splash/SplashScreen.kt), Spider Solitaire (spider_solitaire/.../ui/splash/SplashScreen.kt).

لتخصيص شاشة البداية: افتح activity_games_box_splash.xml واستبدل اللوجو في السطر 48 بوضع صورتك في مجلد drawable، وعدل مدة الشاشة ونصوص التحميل في ملف GamesBoxSplashActivity.kt.

6 Keystore Setup & Generate Signed Bundle (.AAB):

1. Go to Build > Generate Signed Bundle / APK... and select Android App Bundle. 2. Click Create new... (or Choose existing...). Enter your keystore path (e.g. keystore.jks), keystore password, Key Alias (e.g. gamesbox_key), key password, validity (25+ years), and Certificate info. 3. Click Next, select Destination folder (app/release), and choose Build Variant: release. 4. Click Create. Your signed Google Play bundle will be exported to app/release/app-release.aab, ready to upload directly to Google Play Console!

توجه إلى Build > Generate Signed Bundle واختر Android App Bundle. أنشئ مفتاح Keystore جديد أو اختر مفتاحك السابق مع تحديد الـ Alias وكلمات المرور، ثم اختر release واضغط Create ليتم استخراج ملف app-release.aab الجاهز للرفع فوراً على متجر جوجل بلاي.

📖 Full Offline Visual Documentation Included | دليلا ريسكن مصوران مدمجان

Inside the root project folder, double-click DOCUMENTATION.html, Reskin_Guide_EN.html (English), or Reskin_Guide_AR.html (Arabic) for exhaustive guides covering all features and troubleshooting!