📚 FOXCADEv3.0 KNOWLEDGE BASE

FoxCade User & Developer Docs

Official documentation covering setup, game distributors, AdSense monetization, themes, and fleet licensing.

Overview

Introduction

FoxCade is a standalone, lightweight, high-performance Content Management System (CMS) specifically engineered for HTML5 games and web arcades. FoxCade is not an addon or WordPress plugin — it is a self-contained, high-speed platform built with clean PHP, MySQL (PDO), and vanilla JavaScript.

With FoxCade, you can launch a fully functional browser game portal with 1,000+ games, Google AdSense monetization, mobile touchscreen theatre player, and centralized fleet licensing in under 5 minutes.

💡
No coding required: All portal colors, game imports, and ad placements can be configured directly from the visual dashboard.
Prerequisites

Server Requirements

FoxCade runs efficiently on almost all shared hosting, cPanel, VPS, or dedicated cloud servers.

Component Supported Versions Notes
PHP 7.4, 8.0, 8.1, 8.2, 8.3+ Memory limit 128M+ recommended
Database MySQL 5.7+ / MariaDB 10.3+ Includes automated JSON flat-file fallback
PHP Extensions pdo_mysql, curl, zip, mbstring Standard on 99% of web hosts
Web Server Apache (with mod_rewrite) or NGINX Both support clean SEO URLs
Setup Guide

Installation Guide

Follow these 3 simple steps to install FoxCade on your domain:

Step 1: Upload Files

Upload all contents of the FoxCade package to your web server root directory (e.g. public_html or /var/www/html) using FTP, cPanel File Manager, or SSH.

Step 2: Database Configuration

Open config.php (or use the web installer wizard at http://yourdomain.com/) and enter your MySQL credentials:

define('DB_HOST', 'localhost'); define('DB_NAME', 'foxcade_db'); define('DB_USER', 'foxcade_user'); define('DB_PASS', 'your_secure_password');

Step 3: Initial Admin Login

Access your Game Manager dashboard by visiting http://yourdomain.com/admin/login.html and log in using default credentials (admin / admin). You will be prompted to set a new password.

Auto-Registration: Your portal will automatically connect to the Master Licensing Authority and receive an active license key on first visit!
Dashboard

Admin Dashboard

The FoxCade admin panel gives you complete control over your games, visitor traffic, ad placements, themes, and settings.

From the dashboard overview, you can inspect daily play counts, top trending titles, total revenue, and system health in real time.

Games

Adding Games: Upload ZIP Method

To add your own custom HTML5 game, export the game into a .zip archive containing an index.html file at the root.

FoxCade supports games created with Construct 2/3, Phaser, Unity WebGL, Godot, PlayCanvas, or custom vanilla JavaScript.

  • Title: Game display name (e.g. Subway Surfers)
  • Category: Action, Arcade, Puzzle, Racing, etc.
  • Thumbnails: Recommended 512x384px PNG/JPG for optimal grid rendering.
  • Instructions: Player keyboard/touch controls.
Distributors

Auto-Fetching Games from Feeds

FoxCade features automated integration with top HTML5 game distributors including GameMonetize and GameDistribution.

Navigate to Admin > Fetch Games, select your distributor feed, choose a category or keyword, and click Fetch Games. You can review the fetched catalog and click Import All to add hundreds of games to your library in seconds.

Bulk Import

JSON Bulk Importer

Import games in bulk by uploading or pasting a JSON catalog array. Sample structure:

[ { "title": "Subway Surfers", "slug": "subway-surfers", "description": "Dash as fast as you can through the subway!", "instructions": "Arrow keys or swipe to dodge trains", "url": "https://games.foxcade.com/subway-surfers/index.html", "width": 1280, "height": 720, "thumb_1": "https://games.foxcade.com/subway-surfers/thumb_1.jpg", "category": "Action,Arcade", "source": "foxcade-feed" } ]
Taxonomy

Categories & Playlists

Organize your game library into browsable genres (Action, Adventure, Racing, Puzzle, Multiplayer, Sports, 2 Player). Each category receives its own search-optimized SEO landing page with breadcrumbs and schema metadata.

Revenue

Google AdSense Integration

FoxCade includes pre-configured ad placements optimized for maximum Viewability without interfering with gameplay:

  • Header Banner (728x90 / 320x50 on mobile)
  • Side Rail Banners (300x250 / 160x600)
  • Below-Game Sticky Unit
  • Auto-Ads Script Hook

Simply paste your Publisher ID in Settings > Monetization and turn on the banner switches.

Video Ads

Video Preroll Interstitial Ads (IMA SDK)

Earn high CPMs by serving 5-15 second video ads before games launch. FoxCade supports standard VAST/VPAID tags and Google Interactive Media Ads (IMA SDK).

Master Authority

Fleet Licensing & Master Authority

If you run multiple game websites or manage client portals, use the Master Fleet Panel (admin.html).

From the master panel, you can:

  • Generate custom license keys with domain quota limits (Basic: 5, Pro: 10, Business: Unlimited).
  • Bind licenses to specific domains or wildcard (*).
  • Use 1-Click Status Switches to instantly activate or suspend any installation.
  • Monitor real-time HMAC-SHA256 heartbeat check-ins from every live installation.
E-Commerce

Orders & Payments (PayPal & Stripe)

Every incoming order placed via PayPal (🅿️) or Stripe (💳) is registered instantly with dedicated customer information, payment amount, quota limit, and dedicated license activation visible in the Master Panel.

Server

Apache & .htaccess Clean URLs

For Apache servers, ensure mod_rewrite is enabled. The standard FoxCade .htaccess file handles clean game slugs automatically:

RewriteEngine On RewriteBase / RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^game/([a-zA-Z0-9_-]+)/?$ index.php?viewpage=game&slug=$1 [L,QSA]
NGINX

NGINX Server Configuration

If you are hosting FoxCade on NGINX, add the following location block to your server configuration:

location / { try_files $uri $uri/ /index.php?$args; } location ~ \.php$ { include fastcgi_params; fastcgi_pass unix:/var/run/php/php8.2-fpm.sock; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; }
Security

HTTPS & SSL Configuration

Modern browser gaming and Google AdSense require a valid SSL certificate (HTTPS). Most hosting providers offer free Let's Encrypt SSL with one click.

⚠️
Mixed Content Note: When embedding external game iframes, always use https:// URLs to prevent browser security blocks.
👑 Master Admin Panel