MameCloudRom Version 1.0

MameCloudRom v1.0 has been released, offering a virtual file system for MAME ROM management on Windows. Key features include a Lazy Download mechanism that fetches missing ROMs from a remote server, customizable path prefixes for file organization, and a dynamic routing engine. Enhanced stability, multi-language support, and a detailed downloader with progress indicators are also included. The setup is simplified through an interactive script that configures the environment. Importantly, MCR serves as a proof-of-concept for VFS architecture, without providing copyrighted ROMs, placing the responsibility on users for legal file access. It 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 launched. MameCloudRom (MCR) is a Windows virtual file system (using WinFsp) designed for managing MAME ROMs. It features a Lazy Download mechanism: when MAME requests a ROM that isn’t available locally, MCR automatically fetches it from a configured remote server and serves it seamlessly.

MameCloudRom Changelog:
This marks the significant Production Release of MCR, delivering unparalleled flexibility and remarkable stability to users.
🛠 Major New Features
Custom Path Prefixes: Complete control over remote directory structures. Users can now set custom folder prefixes for .zip (-zp) and .7z (-7p) files (e.g., split/, standalone/, or any site-specific path).
Generic Routing Engine: Moved away from hardcoded structures to a dynamic, prefix-aware routing engine that accommodates any archival layout.
Extreme Stability (v0.2 Architecture): Incorporating the highly-reliable handle protection and permission logic from v0.2, ensuring 100% stability even with WinFsp 2025 and Windows File Explorer.
Multi-Language Support: Fully localized setup and configuration tools supporting English, Traditional Chinese (TW), and Simplified Chinese (CN).
⚙ Technical Enhancements
Detailed Downloader: Visual real-time progress bars via curl alongside precise file size (MB/KB) display.
Warning-Free Build: Entirely optimized C++ codebase with strict type safety and zero compiler warnings.
Dynamic Driver Alignment: setup.bat automatically synchronizes the correct winfsp-x64.dll from your local WinFsp installation, ensuring perfect version compatibility.
Audit Skip Optimization: MCR smartly distinguishes between MAME “auditing” and “launching,” so ROM scans won’t trigger unnecessary downloads.
📚 Documentation & User Experience
Interactive Setup: setup.bat conducts environment checks, WinFsp detection, and language selection all in one process.
Simplified Launch: Automatically creates mcr-run.bat to launch both the virtual drive and MAME together.
Clean Starting Point: Refreshed all documentation and repository history for a professional, content-agnostic initial release.
📦 Package Contents
mcr.exe: Core application tool.
setup.bat: One-click installer & environment check.
config.bat: Interactive configuration tool.
README.md, README-TW.md, README-CN.md: Multi-language documentation.
🚀 Quick Start
Download MameCloudRom.zip from the assets below.
Extract the archive to your desired directory.
Execute setup.bat and follow the interactive prompts to configure your Cache, Drive Letter, and Third-party ROM URL.
Run the created mcr-run.bat to start playing.
⭐ Support the Project
If you find this project useful, please give us a Star ⭐ on GitHub! It helps more players discover the project.
⚖ Legal Disclaimer & DMCA Policy
MameCloudRom (MCR) serves as a technical Proof-of-Concept (PoC) for exploring VFS architectures. No copyrighted ROM files or binaries are included.
Content Neutrality: MCR is strictly a “utility pipe” and does not differentiate between copyrighted or non-copyrighted material.
External Content: URLs provided in the documentation are intended for technical demonstration only. The developer does not provide or manage any ROM libraries.
User Responsibility: Users are fully responsible for ensuring they have the legal right to access any files they download.
Distributed under the MIT License.