ComfyMCP Studio

# Changelog All notable changes to ComfyAI-MCP-GameAssets will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ## [Unreleased] - 2025-12-20 ### Added - **New Presets** (6 new style presets): - `effect` - VFX and particle effects (transparent background, glowing) - `magic_effect` - Fantasy magic/spell effects (ethereal, glowing particles) - `ui_button` - Game UI buttons (clean design, polished) - `ui_frame` - UI frames and panels (decorative borders, ornate edges) - `creature` - Fantasy creatures and monsters (full body, dynamic poses) - `topdown_creature` - Top-down creatures/enemies (orthographic view, no visible faces) - **Enhanced ControlNet Support**: - Apply ControlNet to both positive and negative conditioning for stronger viewpoint locking - Improved synthetic depth maps with beveled gradients and Gaussian blur for top-down shapes - Better character depth maps with detailed humanoid shapes (head/torso/arms/legs) - Increased default ControlNet strength from 0.8 to 0.95 - **Tool Enhancements**: - `batch_generate`: Added `seed` parameter for reproducible batch generation - `generate_topdown_asset`: Extended support for `creature` and `effect` asset types - Input validation for all tools (empty prompts/tile_types) - Improved error messages and backend status reporting - Enhanced docstrings with preset option listings - **Quality Improvements**: - Strengthened top-down prompts with explicit viewpoint constraints - Lowered CFG scale (6.0 → 5.0) for top-down presets to let ControlNet dominate - Enhanced negative prompts to prevent frontal views and equipment fragmentation - Better character generation constraints (single character, no duplicated parts) ### Fixed - **Critical Bug**: `UnboundLocalError` in `create_depth_map` box shape calculation - **ControlNet Workflow**: Fixed depth map size mismatch issues - **Syntax Errors**: Corrected indentation and syntax issues in ControlNet tools ### Changed - **Preset Categories**: Reorganized presets into logical groups (General, Top-down, Effects & UI, Creatures, Style-specific) - **Default Values**: Updated default ControlNet strength to 0.95 for better viewpoint consistency - **Documentation**: Complete README overhaul with comprehensive preset listings and testing examples ### Technical - **Backend Improvements**: Enhanced ComfyUI workflow building with dual ControlNet conditioning - **Image Processing**: Added bevel gradients and blur effects to synthetic depth maps - **Code Quality**: Improved error handling and validation throughout the codebase - **Test Scripts**: Updated with new preset options and better CLI arguments ### Documentation - **README.md**: Complete rewrite with 25+ presets documented, comprehensive testing examples - **Tool Documentation**: Enhanced docstrings with parameter options and examples - **Setup Guide**: Improved ComfyUI and ControlNet installation instructions ## [0.1.0] - 2025-12-15 ### Added - Initial release of ComfyAI-MCP-GameAssets MCP server - Core ComfyUI backend integration with SDXL/SD1.5 support - Basic generation tools: `generate_sprite`, `generate_icons`, `generate_tileset` - Character animation system using img2img for pose consistency - Initial ControlNet support for viewpoint control - Unity export functionality - Post-processing tools (resize, background removal, outline) - Preset system with 15+ optimized configurations - Test scripts for validation ### Technical - MCP server architecture using FastMCP - ComfyUI HTTP/WebSocket integration - Environment-based configuration system - Image processing utilities with PIL fallback - Depth map generation for ControlNet - Batch processing capabilities --- ## Version History - **v0.1.0**: Initial release with core ComfyUI integration - **Unreleased**: Major quality improvements, new presets, enhanced ControlNet support ## Contributing When adding new features, please update this changelog following the format above. ## Types of Changes - `Added` for new features - `Changed` for changes in existing functionality - `Deprecated` for soon-to-be removed features - `Removed` for now removed features - `Fixed` for any bug fixes - `Security` in case of vulnerabilities