99gamez — Gamified HTML5 PHP Gaming Portal

by WebWizards (cibey)

Play, level up, and collect badges! 99gamez is a complete PHP/MySQL gaming portal where players can enjoy HTML5 games, earn XP, level up, unlock badges, complete weekly quests, and interact socially. It includes a powerful admin panel, blog, and automatic game importers — all wrapped in a modern Bulma-based design.

This lightweight yet feature-rich system is ideal for launching your own game site with gamification, social networking, and monetization-ready ad zones.

Built for performance and easy customization — no external framework required, 100% self-hosted, and marketplace-ready!

✨ Main Features

• 🎮 Games Engine: Import from GameDistribution, GameMonetize, or GamePix; add your own iframe or self-hosted games.
• 🏆 Gamification: XP system, triangular level progression, badge catalog, and weekly quests with rewards.
• 👥 Social System: Friends, favorites, reactions (like/dislike), ratings, threaded comments, and live activity feed.
• 📝 Blog: Full blog with categories, search, image uploads, and SEO-friendly post pages.
• 🔐 Authentication: Email/password with roles (Admin, Editor, User) and optional Google OAuth login.
• 🧰 Admin Panel: Manage games, users, comments, XP, badges, quests, blog posts, settings, and ads zones.
• 💡 Settings: Favicon/logo upload, title & meta settings, CAPTCHA & OAuth setup, footer HTML editor.
• 📦 Installer: Easy step-by-step installer that auto-imports SQL, creates admin, and writes config file.
• 📱 Responsive: Built with Bulma CSS for a clean, mobile-friendly layout.
• 💬 Notifications: Contact form & message system for player feedback.

✅ Requirements

• PHP 8.0 or higher (tested on 8.1+)
• MySQL 5.7+ or MariaDB 10.4+
• PHP Extensions required:
  • pdo_mysql
  • openssl
  • json
  • mbstring
  • curl
  • fileinfo
• Web Server:
  • Apache with mod_rewrite enabled
  • or Nginx with PHP-FPM
• Writable directories:
  • /uploads
  • /uploads/blog
  • /uploads/badges
• Recommended browser: Chrome, Firefox, Safari, Edge
• Optional integrations:
  • Google OAuth (for social login)
  • reCAPTCHA or hCaptcha site/secret keys

🚀 Installation Instructions

1. Upload all script files to your web root directory or subfolder on your hosting.
2. Create a new MySQL or MariaDB database and assign a user with full privileges.
3. Visit https://yourdomain.com/install/ in your browser.
4. Enter the following details in the installer:
   • Database host, name, username, and password
   • Site title
   • Admin email and password
5. The installer will automatically:
   • Import all required SQL tables
   • Seed demo data (categories, badges, etc.)
   • Create your admin account
   • Generate core/config/settings.php with your credentials
6. After successful installation, you will see a success page with confetti 🎉
7. Login to your site via /pages/login.php using the admin credentials you created.

🎮 Quick Game Import (GameDistribution)

1. Go to GameDistribution RSS Builder and create a JSON feed.
2. Copy the direct feed URL.
3. In the Admin panel → Games → GD Importer, paste the JSON URL in the Direct JSON Catalog field.
4. Click Import to add games automatically.

🌐 Apache Configuration (.htaccess)

<code>RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.+)$ $1 [L,QSA]
</code>

🌐 Nginx Configuration (sample)

<code>location / {
  try_files $uri $uri/ /index.php?$args;
}

location ~ .php$ {
  include fastcgi_params;
  fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
  fastcgi_pass unix:/run/php/php8.1-fpm.sock;
}
</code>

After setup, your site is ready! Customize branding, add badges or quests, and start importing HTML5 games.