ROMConsole - Self-Hosted Retro Gaming Community Script

Demo User: [email protected]
Password: password

ROMConsole is a self-hosted browser-based retro gaming community script built for site owners who want to run their own player account system, local ROM launcher, save-state platform, achievement system, reward economy, community area and admin-managed game portal from one PHP/MySQL installation.

The script is designed around legal local ROM usage. Players open compatible ROM files from their own device, and the software can recognise returning local files using metadata/hash matching without needing to upload, store, stream or distribute private ROM files from the server. This makes ROMConsole suitable for communities where users are expected to use files they personally have the right to open and play.

ROMConsole includes a complete player-facing experience with accounts, profiles, activity, local play, cloud saves, achievements, rankings, rewards, wallet support, trading, inbox messaging, community forum areas and responsive frontend pages. The system is intended to feel like a full retro gaming hub rather than a simple emulator page.

For site owners, ROMConsole includes a full administration area for configuring the site, managing players, reviewing activity, controlling public content, handling rewards, adjusting ranking systems, managing wallet settings, moderating the community and maintaining the installation. The admin area also includes dedicated sections for ROMConsole extensions and software updates, allowing site owners to review official extension information, upload signed extension/update packages, validate packages before installation and keep their installation organised from inside the admin panel.

The public site title can be configured from the admin settings, allowing each installed copy to operate under the customer’s own community name while still retaining ROMConsole as the underlying software product. Public activity, player-facing wording and community output are designed to reflect the configured site title where appropriate.

ROMConsole is delivered as a customer-ready installer package with included documentation for installation, setup and usage. It is suitable for developers, hobby communities, retro gaming websites, private gaming groups and site owners who want a self-hosted gaming portal with player accounts and community functionality already built in.

Please note that ROMConsole does not include commercial game ROM files. Site owners and players are responsible for ensuring that any files they open or use with the software are legally obtained and that they have the necessary rights to use them.

Admin Features

• Full web-based admin dashboard
• Customer-ready installer with database setup
• Admin account creation during installation
• System readiness checks
• Core/emulator readiness checks
• Site title and branding settings
• SEO title and meta description settings
• Open Graph and social sharing settings
• Homepage content controls
• Homepage widget controls
• Homepage notice manager
• Maintenance mode controls
• Footer and legal page text controls
• Player account management
• Player profile review tools
• Player role management
• Moderator/admin role support
• Player mute controls
• Public role badge support
• Registration settings
• Password reset settings
• Public CMS game management
• Approved server game/library management
• ROM folder scanning tools
• Console/platform management
• Emulator core configuration
• Play session tracking
• Guest play log review
• Privacy-safe guest session tracking
• Guest play limit settings
• Leaderboard management
• Leaderboard scoring settings
• Suspicious session review
• Global rank and XP settings
• Rank title management
• XP threshold management
• XP activity rule controls
• Achievement management
• Legal-safe custom achievement rules
• Default achievement setup tools
• Reward and collectible item management
• Reward rarity controls
• Reward drop chance settings
• Reward catalogue management
• Reward ownership review
• Reward sync tools
• Admin reward gifting tools
• Bonus reward granting tools
• Player wallet settings
• Wallet coin balance controls
• Wallet text/settings controls
• Wallet payment gateway configuration
• Coin purchase settings
• Player-to-player trading management
• Trade activity review
• Trade transaction history
• Trading and reward gifting tools
• Inbox/system message tools
• Player message report review
• Forum category management
• Forum topic moderation
• Forum post moderation
• Community moderation tools
• Admin support/help content controls
• Legal policy page management
• Admin Extensions area
• Installed extension management
• Extension status controls
• Extension package upload tools
• Signed extension package validation
• Extension install preview before applying files
• Extension documentation/reference links
• Admin Software Updates area
• Software version/status information
• Signed software update package upload tools
• Update package validation
• Update package review before installation
• Protected path/file validation for updates
• Optional database update review
• Update history tracking
• Schema repair/update utility
• Root-level customer documentation included
• Installation guide included
• Requirements guide included
• Configuration/support documentation included

Player Features

• Player registration and login
• Secure password reset
• Private player account dashboard
• Public player profiles
• Configurable public profile visibility
• Profile status updates
• Profile wall posts
• Avatar/profile display support
• Friends system
• Friend requests
• Members directory
• Online/offline player activity states
• Public activity feed
• Customer site title used in public activity wording
• Local ROM opening from the player’s own device
• Legal local-file confirmation flow
• Guest local play when enabled by admin
• Guest play limits when configured
• Private ROM files are not uploaded or stored by the server
• Registered player private ROM library
• Private ROM labels
• Local ROM metadata/hash recognition
• Same-file recognition for returning players
• Browser-based EmulatorJS player
• Multi-platform emulator/core support
• Responsive game player layout
• Desktop and mobile-friendly player pages
• Remote/second-screen controller support
• Cloud save support for registered players
• Battery save upload/load support where available
• Autosave support where configured
• Manual save/load support
• Continue-save flow
• Play session tracking
• Play time tracking
• Movement/action stat tracking
• Achievement unlocking for registered players
• Achievement progress tracking
• Public achievement display
• Global rank and XP progression
• Claimable level rewards
• Player rank card/progress display
• Leaderboards and player rankings
• Wallet coin balance
• Wallet coin purchase flow when enabled by the site owner
• Reward shop
• Collectible reward items
• Reward inventory
• Stacked reward quantities
• Account-bound reward ownership
• Reward showcase on account/profile pages
• Reward privacy controls
• Player-to-player reward trading
• Trade creation
• Trade matching
• Trade transaction history
• Reward gifting where enabled
• Player inbox
• System messages
• Message replies
• Message reporting
• Message deletion
• Player block/report safety tools
• Community forum
• Forum categories
• Forum topics and replies
• Player help/support pages
• Legal ROM usage guidance pages
• Privacy, acceptable use, DMCA and save-data policy pages
• Public FAQ
• Responsive frontend layout for desktop and mobile

Requirements

• PHP 8.1 or higher recommended
• MySQL 5.7+ or MariaDB 10.3+ recommended
• Apache or Nginx web server
• PHP PDO extension enabled
• PHP PDO MySQL extension enabled
• PHP JSON extension enabled
• PHP mbstring extension enabled
• PHP OpenSSL extension enabled
• PHP fileinfo extension enabled
• PHP session support enabled
• PHP ZIP extension recommended
• MySQL database and database user
• Writable permissions for configuration, uploads, cache/storage, and save-related folders where required by the installer
• Modern browser with JavaScript enabled
• HTTPS recommended for production sites, login sessions, wallet/payment configuration, and admin access

Recommended PHP Limits

• upload_max_filesize: 64M or higher
• post_max_size: 64M or higher
• memory_limit: 256M or higher
• max_execution_time: 120 seconds or higher

Higher limits may be useful if the site owner allows large local file handling, larger artwork uploads, or heavier save-state features.

Optional MySQL Setting for Large Save Data

For larger save-state storage, especially for systems such as N64 where save data can be larger, increasing MySQL/MariaDB max_allowed_packet may be required.
Recommended optional value:
max_allowed_packet = 64M
For heavier save-state usage, site owners may increase this further, for example:
max_allowed_packet = 128M
This setting is only needed if large save-state records fail to save or restore due to database packet-size limits. Standard installations may not need to change it.

Notes

ROMConsole does not include ROM files, commercial games, copyrighted game assets, or third-party game content. Site owners and players are responsible for using only content they have the legal right to use.

Installation Instructions

1. Download and extract the ROMConsole ZIP package.
2. Upload all ROMConsole files to your web server. You can install ROMConsole in your domain root, for example: <a href="https://yourdomain.com/">https://yourdomain.com/</a> Or inside a subfolder, for example: <a href="https://yourdomain.com/romconsole/">https://yourdomain.com/romcons...</a>
3. Create a new MySQL database from your hosting control panel.
4. Create or assign a MySQL database user with full permissions for that database.
5. Open the installer in your browser. Example: <a href="https://yourdomain.com/install/">https://yourdomain.com/install...</a> Or, if installed in a subfolder: <a href="https://yourdomain.com/romconsole/install/">https://yourdomain.com/romcons...</a>
6. Follow the installer steps. The installer will ask for:
   • database host
   • database name
   • database username
   • database password
   • admin username
   • admin password
   • site URL / installation path if required
   ###li/li###
7. After installation is complete, log in to the admin panel. Example: <a href="https://yourdomain.com/admin/">https://yourdomain.com/admin/</a>
8. Complete the main admin setup areas:
   • SEO and Branding
   • Legal and Footer
   • User Registration
   • Wallet Settings
   • Rewards
   • Support / Help Centre
   • Player settings and privacy options where applicable
9. Check file permissions if uploads, branding images, cache, or save-related folders do not work correctly.
10. For production sites, enable HTTPS and confirm the public site, admin panel, login, account pages, player page, rewards, wallet, trading, profiles, and support pages load correctly.

Post-Installation Checklist

After installing ROMConsole, check the following:

• Admin login works
• Public homepage loads
• Player registration works if enabled
• Login/logout works normally
• SEO title/meta output is correct
• Logo and favicon display correctly
• Legal/footer links display correctly
• Wallet page loads
• Rewards page loads
• Trading page loads
• Account page loads
• Profile page loads
• Player page loads
• Support page loads
• Manual Schema Repair / Force Update tool is accessible from admin if needed

Updating Configuration

Most site settings can be changed from the admin panel.
Use Admin settings for:

• site title
• SEO description and keywords
• logo and favicon
• Open Graph / social images
• legal/footer text and links
• registration controls
• wallet/payment configuration
• support/help content
• reward and player-related settings

Do not manually edit generated configuration files unless you understand the server path and database settings.

Important Notes

ROMConsole does not include ROM files, commercial games, copyrighted game artwork, or third-party game assets.
Site owners and players are responsible for using only ROM files and content they have the legal right to use.
Private local ROM files are selected from the player’s own device where supported. ROMConsole is provided as a self-hosted platform and player/account system.