🚀 Overview

BattleMania is a complete esports tournament management system built for organizing online and custom matches of
PUBG, Free Fire, COD Mobile, and other competitive games. The package includes a Flutter mobile app, responsive website, and admin panel to manage users, matches, results, leaderboards, and payouts.

Experience: Designed for real-world esports communities and tournament hosts, BattleMania streamlines registration, room ID generation, score tracking, and automated notifications, giving both players and admins a smooth experience across devices.

✨ Key Features

• 🎮 Multi-Game Support: Organize tournaments for PUBG, Free Fire, COD, and more.
• 📱 Cross-Platform System: Flutter mobile app + web version + PHP admin panel.
• 💰 Wallet System: Players can add money, join matches, and receive winnings securely.
• 🏆 Match Management: Create custom/private rooms, track participants, and auto-generate room IDs.
• 📊 Leaderboard & Stats: Automatic ranking, kill counts, and tournament results display.
• 🧾 Payment Gateway: Integrated Razorpay / Paytm / Stripe / Manual top-up support.
• 🔔 Push Notifications: Firebase push alerts for upcoming matches, results, and wallet updates.
• 📩 Result Upload: Admins can upload results or screenshots for transparency.
• 👥 User Management: Manage profiles, referrals, and bans from admin dashboard.
• 🌐 Responsive Web: Public tournament listings with live updates and leaderboards.
• 📈 Analytics: Monitor player activity, match participation, and revenue reports.
• 💬 Support Tickets: In-app chat and support request system.
• 🔐 Security: JWT authentication, encrypted transactions, and role-based admin controls.

⚙️ Technical Stack

• Mobile App: Flutter 3.x (Dart 3), Firebase Cloud Messaging, Provider/Bloc state management.
• Web Version: Responsive PHP + Bootstrap frontend.
• Backend: PHP 8.1+ (Laravel or Core PHP), MySQL 8, RESTful API.
• Server: Apache/Nginx, HTTPS, PHP-FPM, cron jobs enabled.
• Push & Notifications: Firebase Cloud Messaging (FCM).
• Payments: Razorpay / Paytm / Stripe API integration.
• Admin Panel: Laravel Blade/Tailwind with CRUD modules and analytics dashboard.
• Requirements: PHP 8.1+, cURL, OpenSSL, intl, mbstring, GD, MySQL 8, SSL certificate.

🧩 Installation Guide

1. Upload the backend folder to your hosting and create a MySQL database.
2. Edit the .env file and update DB credentials and payment gateway keys.
3. Run php artisan migrate --seed to create required tables (for Laravel version).
4. In the Flutter app, open lib/config.dart and set your API base URL.
5. Connect Firebase project and add google-services.json for notifications.
6. Run flutter pub get and build the release APK: flutter build apk --release.
7. Access the admin panel via /admin to manage matches, users, and payments.

📦 Deliverables

• ✅ Complete Flutter mobile app source code
• ✅ PHP/Laravel backend API with MySQL schema
• ✅ Web version (responsive player dashboard)
• ✅ Admin panel with user & match management
• ✅ Firebase push integration setup
• ✅ Payment gateway configuration scripts
• ✅ Documentation & GPL license file

📱 Supported Platforms

• Android: Version 8.0+ (Oreo and above)
• iOS: 13+ (optional Flutter build)
• Web: Chrome, Firefox, Edge, Safari (latest)
• Server: Linux (Ubuntu 22.04+), Docker-ready, cPanel supported

👨‍💻 Original Developer Credit

Inspired by the commercial tournament app framework from CodeCanyon.
Please support the original creator here:
CodeCanyon – Original Author.

🔒 Disclaimer

This source code is redistributed under the GPL v3 license for educational and lawful use.
We are not affiliated with PUBG, Free Fire, COD, or the original developer. All game names and logos are trademarks of their respective publishers.
Ensure you follow all Esports API policies, fair play rules, and local gaming regulations when hosting tournaments.