MameCloudRom Version 1.0

MameCloudRom v1.0 has been released as a Windows virtual file system for managing MAME ROMs. It features a Lazy Download mechanism that automatically fetches missing ROMs from a remote server. Major updates include customizable path prefixes, a dynamic routing engine, and enhanced stability using v0.2 architecture. It supports multiple languages and offers real-time download progress. Key improvements enhance installation ease with an interactive setup process and clean documentation. The project serves as a proof-of-concept for VFS architectures, with users responsible for ensuring legal access to downloaded files. MameCloudRom is distributed under the MIT License.

(HEY YOU!! We hope you enjoy! We try not to run ads. So basically, this is a very expensive hobby running this site. Please consider joining us for updates, forums, and more. Network w/ us to make some cash or friends while retro gaming, and you can win some free retro games for posting. Okay, carry on 👍)

MameCloudRom v1.0 has been released. MameCloudRom (MCR) is a Windows virtual file system (utilizing WinFsp) for managing MAME ROMs. It features a Lazy Download system: when MAME looks for a ROM not stored locally, MCR will automatically fetch it from a designated remote server and provide it seamlessly.

MameCloudRom Changelog:
This marks the official Production Release of MCR, offering unparalleled flexibility and exceptional stability for users.
🛠 Major New Features
Custom Path Prefixes: Users can establish custom folder prefixes for .zip (-zp) and .7z (-7p) files, allowing for complete control over remote directory structures (e.g., split/, standalone/, or any site-specific path).
Generic Routing Engine: Transitioned from hardcoded structures to a dynamic, prefix-aware routing engine compatible with various archival layouts.
Extreme Stability (v0.2 Architecture): Incorporating reliable handle protection and permission logic from v0.2 to guarantee total stability even with WinFsp 2025 and Windows File Explorer.
Multi-Language Support: Fully localized setup and configuration tools available in English, Traditional Chinese (TW), and Simplified Chinese (CN).
⚙ Technical Improvements
Detailed Downloader: Features real-time visual progress bars via curl along with precise file size (MB/KB) displays.
Warning-Free Build: C++ codebase optimized for strict type safety, resulting in zero compiler warnings.
Dynamic Driver Alignment: The setup.bat file automatically syncs the correct winfsp-x64.dll from your local WinFsp installation to ensure version compatibility.
Audit Skip Optimization: MCR intelligently differentiates between MAME “auditing” and “launching,” preventing unnecessary downloads during ROM scans.
📚 Documentation & UX
Interactive Setup: The setup.bat script manages environment checks, WinFsp detection, and language selection in a single process.
Simplified Launch: mcr-run.bat is auto-generated to launch both the virtual drive and MAME together.
Clean Start: All documentation and repository history have been updated for a polished, content-neutral initial release.
📦 Package Contents
mcr.exe: The core application tool.
setup.bat: A one-click installer & environment checker.
config.bat: An interactive configuration tool.
README.md, README-TW.md, README-CN.md: Documentation in multiple languages.
🚀 Quick Start
Download MameCloudRom.zip from the assets below.
Extract the contents to your desired directory.
Run setup.bat and follow the interactive instructions to configure your Cache, Drive Letter, and Third-party ROM URL.
Execute the generated mcr-run.bat to start playing.
⭐ Support the Project
If you find this project beneficial, please give us a Star ⭐ on GitHub! It aids more players in discovering the project.
⚖ Legal Disclaimer & DMCA Policy
MameCloudRom (MCR) serves as a technical Proof-of-Concept (PoC) for investigating VFS architectures. No copyrighted ROM files or binaries are included.
Content Neutrality: MCR functions solely as a “utility pipe” and does not differentiate between copyrighted and non-copyrighted content.
External Content: Example URLs in the documentation are strictly for technical demonstration purposes. The developer does not offer or maintain any ROM libraries.
User Responsibility: Users must ensure they have the legal right to access any files downloaded.
Distributed under the MIT License.