# capitanbeto1/encoder-base64-mundo-gaturro-items-swf architecture

> Architecture diagram of the GitHub repository capitanbeto1/encoder-base64-mundo-gaturro-items-swf, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf
- Repository: https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf

## Overview

MG Items is a Windows desktop tool for finding Mundo Gaturro assets in game SWFs, modifying or assembling them, and delivering the resulting Encode through Fiddler and NPC Lola. The main workflow runs from search and selection, through preview/customization and Encode generation, to game-cache and Fiddler setup. The README also describes image search, saved Looks and Prendas, actions, shops, portals, minigames, and environment checks. Some backend wiring is documented but not excerpted, so those links cite the README or indexed references; uncertain links are omitted.

Main entry points: [`src/mgitems/nucleo`](https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/tree/main/src/mgitems/nucleo) (UI backend), [`src/mgitems/nucleo/swfs.py`](https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/nucleo/swfs.py) (SWF reader), [`src/mgitems/nucleo/entrega.py`](https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/nucleo/entrega.py) (Game preparation), [`src/mgitems/app.py`](https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/app.py) (Desktop controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop app"]
  node_app["Desktop controller<br/>[app.py]"]
  node_ui["Web interface"]
  node_core["UI backend"]
  node_environment["Setup checks<br/>[entorno.py]"]
end

subgraph group_assets["Game assets"]
  node_catalog[("SWF catalog<br/>[catalogo.py]")]
  node_swfs["SWF reader<br/>[swfs.py]"]
  node_swfparse["SWF parser<br/>[swf.py]"]
  node_categories["Asset classification<br/>[categorias.py]"]
  node_image_search["Image search<br/>[busqueda.py]"]
  node_ffdec["FFDec exporter<br/>[ffdec.py]"]
end

subgraph group_editing["Item editing"]
  node_inventory["Item list<br/>[items.py]"]
  node_preview["Avatar preview<br/>[imagenes.py]"]
  node_personalize["Piece customization<br/>[personalizar.py]"]
  node_garments["Garment modification<br/>[prendas.py]"]
  node_looks["Look builder<br/>[looks.py]"]
  node_behaviors["Item behaviors<br/>[npcs.py]"]
  node_actions["Action definitions<br/>[acciones.py]"]
  node_saved[("Saved designs<br/>[guardados.py]")]
end

subgraph group_delivery["Game delivery"]
  node_encode["Encode generation<br/>[encodes.py]"]
  node_delivery_prep["Game preparation<br/>[entrega.py]"]
  node_cache[("Game cache<br/>[cache_juego.py]")]
end

subgraph group_integrations["External integrations"]
  node_cdn(("Game CDN"))
  node_fiddler["Fiddler"]
  node_game(("Mundo Gaturro"))
  node_lola(("NPC Lola"))
end

node_user(("Player"))

node_user -->|"uses"| node_ui
node_ui -.->|"submits requests"| node_app
node_app -->|"initializes"| node_core
node_app -.->|"serves interface"| node_ui
node_user -->|"checks setup"| node_environment
node_core -->|"queries"| node_catalog
node_catalog -->|"downloads catalog"| node_cdn
node_swfs -->|"reads catalog"| node_catalog
node_swfs -.->|"downloads SWFs"| node_cdn
node_swfs -.->|"parses SWFs"| node_swfparse
node_swfs -.->|"classifies assets"| node_categories
node_core -->|"opens SWFs"| node_swfs
node_core -->|"searches images"| node_image_search
node_image_search -->|"fetches model data"| node_cdn
node_core -.->|"manages selection"| node_inventory
node_core -->|"renders preview"| node_preview
node_preview -->|"exports artwork"| node_ffdec
node_core -.->|"validates edits"| node_personalize
node_core -.->|"tricks garments"| node_garments
node_core -->|"builds Looks"| node_looks
node_core -->|"configures behaviors"| node_behaviors
node_core -->|"configures actions"| node_actions
node_core -->|"loads saved designs"| node_saved
node_core -->|"generates Encode"| node_encode
node_user -->|"adds to game"| node_delivery_prep
node_delivery_prep -->|"configures rule"| node_fiddler
node_delivery_prep -->|"clears cache"| node_cache
node_delivery_prep -->|"reopens game"| node_game
node_game -->|"visits"| node_lola
node_lola -->|"delivers Encode"| node_game

click node_app "https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/app.py"
click node_ui "https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/tree/main/src/mgitems/ui/js"
click node_core "https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/tree/main/src/mgitems/nucleo"
click node_environment "https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/entorno.py"
click node_catalog "https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/catalogo.py"
click node_swfs "https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/nucleo/swfs.py"
click node_swfparse "https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/swf.py"
click node_categories "https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/categorias.py"
click node_image_search "https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/busqueda.py"
click node_ffdec "https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/ffdec.py"
click node_inventory "https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/items.py"
click node_preview "https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/nucleo/imagenes.py"
click node_personalize "https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/personalizar.py"
click node_garments "https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/prendas.py"
click node_looks "https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/nucleo/looks.py"
click node_behaviors "https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/nucleo/npcs.py"
click node_actions "https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/acciones.py"
click node_saved "https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/guardados.py"
click node_encode "https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/nucleo/encodes.py"
click node_delivery_prep "https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/nucleo/entrega.py"
click node_cache "https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/cache_juego.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_ui,node_core,node_environment toneBlue
class node_catalog,node_swfs,node_swfparse,node_categories,node_image_search,node_ffdec toneAmber
class node_inventory,node_preview,node_personalize,node_garments,node_looks,node_behaviors,node_actions,node_saved toneMint
class node_encode,node_delivery_prep,node_cache toneRose
class node_cdn,node_fiddler,node_game,node_lola,node_user toneIndigo
```

## Components

### Desktop app

- [Desktop controller](https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/app.py): `src/mgitems/app.py`
- [Web interface](https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/tree/main/src/mgitems/ui/js): `src/mgitems/ui/js`
- [UI backend](https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/tree/main/src/mgitems/nucleo): `src/mgitems/nucleo`
- [Setup checks](https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/entorno.py): `src/mgitems/entorno.py`

### Game assets

- [SWF catalog](https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/catalogo.py): `src/mgitems/catalogo.py`
- [SWF reader](https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/nucleo/swfs.py): `src/mgitems/nucleo/swfs.py`
- [SWF parser](https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/swf.py): `src/mgitems/swf.py`
- [Asset classification](https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/categorias.py): `src/mgitems/categorias.py`
- [Image search](https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/busqueda.py): `src/mgitems/busqueda.py`
- [FFDec exporter](https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/ffdec.py): `src/mgitems/ffdec.py`

### Item editing

- [Item list](https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/items.py): `src/mgitems/items.py`
- [Avatar preview](https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/nucleo/imagenes.py): `src/mgitems/nucleo/imagenes.py`
- [Piece customization](https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/personalizar.py): `src/mgitems/personalizar.py`
- [Garment modification](https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/prendas.py): `src/mgitems/prendas.py`
- [Look builder](https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/nucleo/looks.py): `src/mgitems/nucleo/looks.py`
- [Item behaviors](https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/nucleo/npcs.py): `src/mgitems/nucleo/npcs.py`
- [Action definitions](https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/acciones.py): `src/mgitems/acciones.py`
- [Saved designs](https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/guardados.py): `src/mgitems/guardados.py`

### Game delivery

- [Encode generation](https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/nucleo/encodes.py): `src/mgitems/nucleo/encodes.py`
- [Game preparation](https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/nucleo/entrega.py): `src/mgitems/nucleo/entrega.py`
- [Game cache](https://github.com/capitanbeto1/encoder-base64-mundo-gaturro-items-swf/blob/main/src/mgitems/cache_juego.py): `src/mgitems/cache_juego.py`

### External integrations

- **Game CDN**
- **Fiddler**
- **Mundo Gaturro**
- **NPC Lola**

### Other components

- **Player**

## Connections

- Player → Web interface: uses
- Web interface → Desktop controller: submits requests
- Desktop controller → UI backend: initializes (evidence: `src/mgitems/app.py`)
- Desktop controller → Web interface: serves interface
- Player → Setup checks: checks setup
- UI backend → SWF catalog: queries (evidence: `src/mgitems/nucleo/__init__.py`)
- SWF catalog → Game CDN: downloads catalog
- SWF reader → SWF catalog: reads catalog (evidence: `src/mgitems/nucleo/swfs.py`)
- SWF reader → Game CDN: downloads SWFs
- SWF reader → SWF parser: parses SWFs (evidence: `src/mgitems/nucleo/swfs.py`)
- SWF reader → Asset classification: classifies assets (evidence: `src/mgitems/nucleo/swfs.py`)
- UI backend → SWF reader: opens SWFs (evidence: `src/mgitems/nucleo/__init__.py`)
- UI backend → Image search: searches images (evidence: `src/mgitems/nucleo/__init__.py`)
- Image search → Game CDN: fetches model data
- UI backend → Item list: manages selection (evidence: `src/mgitems/nucleo/swfs.py`)
- UI backend → Avatar preview: renders preview (evidence: `src/mgitems/nucleo/__init__.py`)
- Avatar preview → FFDec exporter: exports artwork (evidence: `src/mgitems/nucleo/imagenes.py`)
- UI backend → Piece customization: validates edits (evidence: `src/mgitems/nucleo/swfs.py`)
- UI backend → Garment modification: tricks garments (evidence: `src/mgitems/nucleo/swfs.py`)
- UI backend → Look builder: builds Looks (evidence: `src/mgitems/nucleo/__init__.py`)
- UI backend → Item behaviors: configures behaviors (evidence: `src/mgitems/nucleo/__init__.py`)
- UI backend → Action definitions: configures actions (evidence: `src/mgitems/nucleo/__init__.py`)
- UI backend → Saved designs: loads saved designs (evidence: `src/mgitems/app.py`)
- UI backend → Encode generation: generates Encode (evidence: `src/mgitems/nucleo/__init__.py`)
- Player → Game preparation: adds to game
- Game preparation → Fiddler: configures rule
- Game preparation → Game cache: clears cache
- Game preparation → Mundo Gaturro: reopens game
- Mundo Gaturro → NPC Lola: visits
- NPC Lola → Mundo Gaturro: delivers Encode
