# 👑 MORGANA SANDBOX ENGINE v4.0 [The Monolithic Offline AI Playground]
The era of predefined, rigid setups is officially over. Version 4.0 transforms the framework into a fully dynamic, image-agnostic AI Sandbox core. Named in honor of the dark, gothic elegance of Morgana, this engine breathes life into ANY companion entirely by extracting prompt tokens, workflows, and character data directly from your active root PNG file!
> "I am absolutely shocked by what the AI can achieve here — the way the engine dynamically adapts and generates everything offline is just incredibly cool!"
---
### 💻 Technical Architecture & Release Concept
During a deep architectural refactor, the entire codebase has been completely overhauled. The engine has been stripped of all internet-dependent libraries, network clutter, and file duplication, unifying the complete backend application layer into a single, high-performance offline monolithic core dima_v2.py).
The system is fully autonomous and operates 100% locally. A smart auto-date-modified parser automatically scans the root folder upon initialization, extracting the character's Identity and ComfyUI node network on the fly. This gives the user complete freedom to morph the sandbox world simply by swapping a single PNG asset in the root directory, completely eliminating manual backend file modification.
In live auto-chat mode, a non-destructive 512x512 latent shield is enforced. It dynamically intercepts empty latent node calls and optimizes them, preventing melted human anatomy, body duplication, and distorted faces while leaving native step counts, CFG scales, and custom planners of advanced architectures (Flux / Create) fully intact.
Description
### 🚀 What's New in v4.0 [The Refactor Changelog]:
🧚 *Flagship Morgana & Roxy Presets**: Includes ready-to-play prompt-baked character profiles. Want to switch worlds? Just drop your chosen PNG into the root folder!
🕒 *Smart Date-Modified Parser**: The launcher automatically detects the latest added or modified .png file in your root workspace. No manual file renaming or root cleaning required!
🛑 *Agnostic Non-Destructive Latent Shield**: In live auto-chat mode, the backend automatically overrides generation nodes to 512x512, completely preventing melted faces and broken human anatomy while boosting generation speeds to mere seconds.
🧠 *Flux & Create2 Architecture Support**: The step/sampler data is left completely untouched during engine injections, meaning your advanced Flux workflows, custom schedulers, and native parameters remain perfectly intact.
🔌 *ComfyUI Portable Autohook**: No more missing global Python interpreter crashes! The setup .bat files automatically trace parent paths, hook into your isolated python_embeded folders, and execute flawlessly.
💬 *Smart Dialog Sentence Filter**: The code now uses regular expressions to isolate strictly the final photographic description line, purging direct speech, names, and quotation marks before injecting text blocks into ComfyUI. No prompt pollution, ever.
---
### ⚙️ Quick Launch Protocol (How to Play):
1. Ensure your local ComfyUI is actively running in the background on port 8188.
2. Keep your preferred character PNG file directly inside the game root directory.
3. Run *1_Setup_Studio.bat** to let the internal diagnostics verify Pillow libraries, lock your active character, and compile the uncensored sandbox-brain via Ollama.
4. Run *2_Run_Studio.bat** to boot up the production ASGI cluster. The engine will automatically open a dedicated browser app container on *http://127.0.0.1:8000**.