maple-background

What problem does it solve?

Generate authentic MapleStory map backgrounds from reference assets to save time and ensure pixel-accurate aesthetics for content creators.

Core Features & Use Cases

• Input parsing for base map name or ID and optional variation parameters (time of day, weather, expanded area)
• Reference collection workflow using maplestory map renders as inputs to ensure authentic style
• Automated background generation that preserves MapleStory's tile style using the Nano Banana Pro workflow
• Output registration and storage in background/index.json with metadata for easy reuse
• Support for multiple aspect ratios (16:9, 9:16, 1:1) and variant naming conventions

Quick Start

Provide a base map reference and optional variation to generate a MapleStory-like background and save it to background/ with an index entry.