crystal-prd

byLala's World

PRD: PuzzleNaira Project Phase: MVP / Version 1.0 Target Market: Nigeria Currency: Nigerian Naira (₦) 1. Product Overview PuzzleNaira is a skill-based, competitive match-3 mobile game. It enables players to compete in 1v1 battles where the outcome is determined entirely by speed and strategy. By utilizing a Deterministic Shared Seed, the game ensures both players face the exact same board, eliminating the "luck" associated with traditional puzzle games. 2. Core Game Mechanics (Skill-First) To maintain its status as a Game of Skill under Nigerian law: The Shared Seed: Every match uses a pre-generated sequence of blocks. If Player A gets a red block in column 3, Player B is guaranteed to get the same block at the same point in their sequence. Win Conditions: Time Attack: Highest score at the end of 120 seconds. Objective Blitz: First to clear 20 "Ice Blocks" or specific colors. Scoring Logic: 3-match: 100 points. 4-match (Rocket): 300 points. 5-match (Color Bomb): 500 points. Combo Multiplier: Score increases by 0.5x for every cascade triggered by a single move. No Pay-to-Win: Power-ups cannot be bought. They are only generated via 4+ matches during gameplay. 3. Game Modes & Social 3.1 1v1 Battle (PVP) Real-Time (Sync): Live match. A "Ghost Bar" shows the opponent’s score progress in real-time to drive urgency. Asynchronous (Async): Play now, and the system matches you with an opponent's score later. Results are delivered via Push Notification. 3.2 Social Integration WhatsApp Challenges: Users can share a "Challenge Link." If a friend clicks it, they are taken directly into a private lobby to stake ₦ against each other. Leaderboards: Weekly Naira prizes for the top 100 players (funded by the platform as a marketing expense). 4. Economy & Wallet (Naira Focused) 4.1 Payment Gateways Primary Deposit: OPay & PalmPay (Direct API integration for "One-Tap" payments). Alternative Deposit: Paystack/Monnify for Bank Transfers and USSD. Withdrawals: Instant payouts to any Nigerian Bank or OPay/PalmPay wallet. 4.2 Prize Structure (20% Platform Rake) Entry Fee (Per Player) Total Pool Platform Rake (20%) Winner Prize ₦100 ₦200 ₦40 ₦160 ₦500 ₦1,000 ₦200 ₦800 ₦2,500 ₦5,000 ₦1,000 ₦4,000 4.3 Virtual Currency (Gems) Usage: Practice matches only. Retention: Users earn 50 Gems daily for logging in. Ad-Integration: Watch a rewarded video to earn 100 Gems. 5. Technical Requirements 5.1 Anti-Cheat & Security Server-Side Move Validation: The game client sends every "Swap" move to the server. The server re-calculates the score. If the client-reported score and server-calculated score mismatch, the match is voided and the player is flagged. Latency Compensation: The 120-second timer is handled locally but synced at 10-second intervals to prevent "Time Freezing" hacks. 5.2 Regulatory Compliance (Nigeria) Age Gate: Mandatory 18+ verification during signup. KYC: For withdrawals over ₦50,000, users must provide NIN or BVN for identity verification (AML compliance). Licensing: Requires a license from the National Lottery Regulatory Commission (NLRC) as a "Promotional/Skill-based" game. 6. Monetization Model Match Rake (Primary): The 20% fee taken from every cash match. Withdrawal Fee: A flat ₦50 fee per withdrawal to cover bank processing costs. In-App Purchases: Sale of "Aura" effects (visual matches), custom tile skins (e.g., "Naira Green" tiles), and Avatars. Rewarded Ads: Only available in the "Practice" or "Free-to-Play" section. 7. UI/UX Strategy for the Nigerian Market Data Saver Mode: Option to disable high-res animations to save mobile data. Low-End Device Optimization: Ensure the game runs smoothly on devices with 2GB RAM (common in the region). Trust Signals: A prominent "Transaction History" and "Verified Payout" badge on the home screen to build user trust in the cash mechanics. 8. Roadmap Phase 1 (MVP): 1v1 Async matches, OPay/PalmPay deposits, core Match-3 engine. Phase 2 (Social): WhatsApp Friend Challenges, Real-time Sync matches. Phase 3 (Scale): Weekly Tournaments, SDK for third-party developers to add more skill games. 9. KPI Targets Day 1 Retention: 35% Average Matches per User/Day: 5.5 Average Deposit Value: ₦1,200 Viral Coefficient (K-Factor): 0.2 (from WhatsApp invites) 14.6s info Google AI models may make mistakes, so double-check outputs. Start typing a prompt