Penalty Kicks – HTML5 Sport Game

✨ Key Features

• One-Touch/Click Shooting: Drag or swipe to set angle and power; tap to place the shot.
• Keeper AI: Dynamic dive logic, difficulty ramp, and shot prediction.
• Shootout & Practice Modes: Classic five-kick sets, sudden death, or infinite training.
• Physics & Curving: Optional ball spin/swerve for advanced play.
• Score & Streaks: Accuracy bonuses, combo multipliers, and high-score memory (localStorage).
• Audio & Visual Juice: Crowd chants, whistle SFX, goal nets, particle hits, screen shake.
• Responsive Canvas: Portrait/landscape auto-scale for phones, tablets, and desktops.
• Localization-Ready: Externalized strings for multilingual deployments (incl. RTL).
• Ad-Ready Hooks: Interstitial/reward callbacks for web ad stacks (AdSense/Ad Manager) or wrapper SDKs.
• PWA Option: Manifest + service worker for installable, offline-tolerant play.

⚙️ Technical Stack

• Engine: Pure HTML5 Canvas + JavaScript (or Phaser 3/Construct 3 export, depending on included version)
• Languages: HTML, CSS, JavaScript
• Assets: Optimized PNG/SVG sprites, MP3/OGG audio
• Build: Plain static files; optional bundler (Vite/Rollup) if provided

Hosting Requirements: Any static host (Nginx/Apache/CDN). Serve via HTTPS for audio unlock/PWA; enable caching headers for assets.

🧩 Installation Guide

1. Unzip & upload the game folder to your web host (or run a local static server).
2. Configure options in config.json/settings.js (difficulty, attempts, audio, localization).
3. Monetization: Add your ad tags/SDK callbacks in the provided ads.js stubs.
4. PWA (optional): Keep manifest.json and service worker registered for installable play.
5. Publish: Point your domain/sub-path to index.html and verify mobile controls.

📦 Deliverables

• ✅ Full HTML/CSS/JS source code
• ✅ Art & audio assets (as included)
• ✅ Config files (config.json / settings.js)
• ✅ Ad callback stubs & integration notes
• ✅ Optional PWA files (manifest + service worker)
• ✅ README & quick-start docs
• ✅ GPL license file

📱 Supported Platforms

• Browsers: Chrome, Safari, Firefox, Edge (latest two versions)
• Mobile: iOS/Android browsers with touch & vibration support
• Wrappers: Works in Cordova/Capacitor/WebView shells for app-store releases

🧠 Notes

• License: Distributed under the GPL — study, modify, and redistribute under GPL terms.
• Customization Tips:
  • Swap stadium/kit colors and add team flags for tournament tie-ins.
  • Tune keeper AI and shot-curve parameters for targeted difficulty.
  • Gate “retry” or “power-shot” features behind rewarded ads to boost ARPDAU.
• SEO Assurance (for web portals): Add descriptive titles, OpenGraph images (goal moment), and schema.org VideoGame markup to improve discoverability and E-E-A-T on listing pages.

👨‍💻 Original Developer Credit

Please retain attribution to the original author and marketplace listing (e.g.,
CodeCanyon) to acknowledge their expertise and the project’s provenance.

🔒 Disclaimer

This package is a GPL redistribution for educational, testing, and development use. We are not the original vendor and do not provide official support or warranties. All brand names and third-party libraries (e.g., Phaser, Construct) remain the property of their owners. For ad-supported releases, ensure compliance with platform policies, COPPA/age ratings, and regional privacy laws (GDPR/CCPA).