mGBA-js Enhanced Maps

Community-contributed AI-enhanced maps for mGBA-js, the GBA emulator with AI-powered map enhancement.

What is this?

This repository hosts AI-enhanced versions of VGMaps game maps that can be automatically downloaded and applied in mGBA-js for parallax 2.5D rendering effects.

How to Use

1. Load a GBA ROM in mGBA-js
2. Press C to open the Community Browser
3. Browse available styles for your game
4. Click Download to cache the map set locally
5. Click Apply to use the enhanced maps

How to Contribute

Option 1: Using mGBA-js Export

1. Enhance maps in mGBA-js using ComfyUI integration
2. Press C and click "Upload Your Maps"
3. Fill in the style name and description
4. Download the packaged files
5. Submit a Pull Request with your files

Option 2: Manual Contribution

1. Fork this repository
2. Create a new folder in sets/ with format: GAMECODE_style_###
3. Add your enhanced map images (WebP format recommended)
4. Add a metadata.json with map info
5. Update manifest.json to include your set
6. Submit a Pull Request

Directory Structure

enhanced-maps/
├── manifest.json          # Main index of all available sets
├── README.md
└── sets/
    └── BZ5E_fantasy_001/  # Example set
        ├── metadata.json  # Set metadata
        ├── preview.webp   # 256x256 preview thumbnail
        ├── map_0.webp     # Enhanced map images
        ├── map_1.webp
        └── ...

metadata.json Format

{
  "id": "BZ5E_fantasy_001",
  "gameCode": "BZ5E",
  "name": "FFV Fantasy Remaster",
  "prompt": "fantasy adventure scene, highly detailed...",
  "style": "fantasy",
  "author": "YourName",
  "version": 1,
  "maps": [
    { "id": "0", "name": "World Map", "width": 4096, "height": 4096 },
    { "id": "1", "name": "Tule Village", "width": 512, "height": 512 }
  ]
}

Available Styles

Style	Description
Fantasy Remaster	Detailed fantasy illustrations with rich colors
Watercolor Art	Soft watercolor painting style
Anime Style	Clean anime/manga inspired artwork
Realistic	Photorealistic interpretation
Oil Painting	Classical oil painting style

Supported Games

See manifest.json for the full list of supported game codes.

Guidelines

• Image Format: WebP recommended for best compression
• Resolution: Match or exceed original VGMaps resolution
• Quality: Ensure consistent style across all maps in a set
• Naming: Use descriptive set names and accurate game codes
• Preview: Include a 256x256 preview thumbnail

License

All contributions are shared under CC BY-NC-SA 4.0.

Original VGMaps images are property of their respective creators at vgmaps.com.