$git clone https://github.com/VedantRGosavi/UE5-MCPUE5-MCP (Model Control Protocol) is designed to integrate AI-driven automation into Blender and Unreal Engine 5 (UE5) workflows. This project builds upon BlenderMCP to provide an end-to-end pipeline for AI-driven game level creation, enh
| 1 | # UE5-MCP (Model Control Protocol) |
| 2 | UPDATE: unfortunately we didnt move forward with the project due to time constraints. Feel free to use the docs. |
| 3 | ## Overview |
| 4 | |
| 5 | UE5-MCP (Model Control Protocol) is designed to integrate AI-driven automation into Blender and Unreal Engine 5 (UE5) workflows. This project builds upon [BlenderMCP](https://github.com/ahujasid/blender-mcp) to provide an end-to-end pipeline for AI-driven game level creation, enhancing level design, asset management, and gameplay programming. |
| 6 | |
| 7 | ## Features |
| 8 | |
| 9 | - **AI-Driven Scene Generation** (via BlenderMCP): |
| 10 | - Text-to-Scene conversion in Blender |
| 11 | - Image-to-Scene reference-based generation |
| 12 | - Material and texture management |
| 13 | - Automated scene composition |
| 14 | - PolyHaven asset integration |
| 15 | - **Unreal Engine Integration**: |
| 16 | - Automated scene import |
| 17 | - Game level conversion |
| 18 | - Material and lighting transfer |
| 19 | - Level optimization utilities |
| 20 | - Blueprint-based scene manipulation |
| 21 | - **Asset Management & Creation**: |
| 22 | - Generates and modifies 3D models, textures, and materials using AI |
| 23 | - Workflow automation for asset transfers between Blender and UE5 |
| 24 | - **Gameplay Programming & Debugging**: |
| 25 | - Assists in Blueprint scripting |
| 26 | - Performance profiling |
| 27 | - Automated debugging for UE5 |
| 28 | |
| 29 | ## Prerequisites |
| 30 | |
| 31 | - Blender (latest stable version) |
| 32 | - Unreal Engine 5 (UE5) |
| 33 | - Python 3.x |
| 34 | - Required Python packages (specified in `dependencies.md`) |
| 35 | |
| 36 | ## Installation |
| 37 | |
| 38 | 1. Clone the repository: |
| 39 | ```bash |
| 40 | git clone https://github.com/your-repo/UE5-MCP.git |
| 41 | ``` |
| 42 | 2. Install dependencies: |
| 43 | ```bash |
| 44 | pip install -r requirements.txt |
| 45 | ``` |
| 46 | 3. Configure settings (refer to `configurations.md`) |
| 47 | 4. Run MCP within Blender or UE5 as per the workflow instructions (`workflow.md`) |
| 48 | |
| 49 | ## Usage |
| 50 | |
| 51 | - For **Blender**: Use Blender-MCP to automate scene creation and asset generation |
| 52 | - For **Unreal Engine 5**: Utilize UE5-MCP for automated level design, asset integration, and debugging |
| 53 | - For **AI Integration**: Check `ai_integration.md` for available AI-powered automation features |
| 54 | |
| 55 | For detailed commands and parameters, refer to `commands.md`. |
| 56 | |
| 57 | ## Contributing |
| 58 | |
| 59 | See `CONTRIBUTING.md` for contributing guidelines and best practices. |
| 60 | |
| 61 | ## License |
| 62 | |
| 63 | Refer to `LICENSE.md` for licensing details. |
| 64 | |
| 65 | ## Troubleshooting |
| 66 | |
| 67 | If you encounter issues, check `troubleshooting.md` or submit an issue on GitHub. |
| 68 | |
| 69 | ## Contact |
| 70 | |
| 71 | Vedant Gosavi |
| 72 | Aditya Mhambrey |
| 73 | Charles Green |
| 74 | |
| 75 | ## Acknowledgments |
| 76 | |
| 77 | - BlenderMCP project contributors |
| 78 | - Unreal Engine community |
| 79 | - [Additional acknowledgments] |