feat(gamedev): ronda 1 — pixelize + luma→alpha + export-godot (grupo gamedev)
Tres funciones CPU-only del lote gamedev 2D + 2 helpers puros + grupo de capacidad: - comfyui_pixelize_image_py_ml (impure): Fase 2 pixelart — downscale nearest + cuantizacion a N colores / paleta fija (game-boy/pico-8/nes) + re-upscale nearest. - comfyui_matting_luma_to_alpha_py_ml (impure): frame VFX sobre negro -> RGBA por luminancia ponderada (translucidos con additive blend). - comfyui_export_asset_to_godot_py_pipelines (impure): puente ComfyUI -> Godot 4 — copia a res://assets/<dir> por kind + .import por tipo + filtro Nearest si pixelart + reimport headless best-effort. Compone los 2 helpers puros. - godot_map_asset_dir_py_core, godot_clean_asset_name_py_core (pure): nucleos reutilizables del pipeline. - docs/capabilities/gamedev-2d.md + INDEX: grupo nuevo gamedev. Tests 33/33 verdes (offline PIL/numpy). Golden real verificado: asset de ~/ComfyUI/output -> /tmp/godot_test_proj con .import correcto y reimport headless real de Godot 4.7. Sin GPU, sin red, sin tocar proyectos del usuario. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -14,6 +14,7 @@ Indice de grupos de capacidades del registry. Cada grupo agrupa >=3 funciones qu
|
||||
|
||||
| Grupo | N | Que cubre |
|
||||
|---|---|---|
|
||||
| [gamedev](gamedev-2d.md) | 5 | Assets 2D para Godot: post-proceso (pixelize, luma->alpha) + puente de assets a proyectos Godot 4 (carpetas + .import + reimport headless) |
|
||||
| [registry](registry.md) | 17 | Auditoria y monitorizacion del propio registry: copied-code, uses-functions, unused, proposals, telemetria |
|
||||
| [systemd](systemd.md) | 14 | Generar, instalar, restart y status de unit files systemd via SSH (deploys a VPS) |
|
||||
| [ssh](ssh.md) | 19 | Operar hosts remotos via SSH: config, conn, ejecutar comandos, port-forward, deploys con SCP/rsync |
|
||||
|
||||
@@ -0,0 +1,72 @@
|
||||
# Capability group: `gamedev` — assets 2D para Godot (post-proceso + puente)
|
||||
|
||||
Cluster de funciones para producir y mover assets 2D de juego entre **ComfyUI**
|
||||
(generación) y **Godot 4** (consumo). Cubre el **post-proceso determinista** de los
|
||||
crudos generados (pixelizar, recortar a alpha) y el **puente de assets** que los
|
||||
coloca en un proyecto Godot con sus import settings correctos. Todas son CPU-only:
|
||||
ninguna toca la GPU ni descarga modelos.
|
||||
|
||||
Tag plano del grupo: `gamedev`. Filtro: `mcp__registry__fn_search query="" tag="gamedev"`.
|
||||
|
||||
Documento hermano del grupo `comfyui` (generación de imágenes/video/3D): este grupo
|
||||
empieza donde el crudo ya existe en `~/ComfyUI/output/`. Diseño del puente:
|
||||
`docs/comfyui-godot-integration.md`. Planes origen: `reports/0135` (pixelart),
|
||||
`reports/0140` (VFX), `reports/0137`/`0138` (puente Godot).
|
||||
|
||||
## Funciones del grupo
|
||||
|
||||
| ID | Firma corta | Qué hace |
|
||||
|---|---|---|
|
||||
| `comfyui_pixelize_image_py_ml` | `(src, dst, *, downscale=8, colors=16, palette=None, dither=False, upscale_back=True) -> dict` | Pixel-perfect: downscale nearest + cuantización a N colores o paleta fija (game-boy/pico-8/nes). Fase 2 pixelart. Impura (I/O). |
|
||||
| `comfyui_matting_luma_to_alpha_py_ml` | `(image_path, *, out_path=None, gamma=1.0, black_point=0.0, premultiply=False, luma_weights=(.299,.587,.114)) -> dict` | Frame VFX sobre negro -> RGBA usando luminancia como alpha (translúcidos con additive blend). Impura (I/O). |
|
||||
| `comfyui_export_asset_to_godot_py_pipelines` | `(asset_path, kind, godot_project, *, name=None, reimport=True, godot_bin=None) -> dict` | Copia el asset a `res://assets/<dir>/` por `kind` + escribe `.import` + filtro Nearest si pixelart + reimport headless. Pipeline impuro. |
|
||||
| `godot_map_asset_dir_py_core` | `(kind) -> str` | Mapea `kind` -> subcarpeta de `res://assets/`. Pura. |
|
||||
| `godot_clean_asset_name_py_core` | `(filename, *, override=None) -> str` | Normaliza el nombre `<prefijo>_NNNNN_.<ext>` a snake_case seguro para `res://`. Pura. |
|
||||
|
||||
## Ejemplo canónico end-to-end
|
||||
|
||||
Flujo: crudo generado en ComfyUI -> pixelizar -> exportar a Godot con Nearest.
|
||||
|
||||
```python
|
||||
import sys, os
|
||||
sys.path.insert(0, os.path.join(os.environ["HOME"], "fn_registry", "python", "functions"))
|
||||
from ml.comfyui_pixelize_image import comfyui_pixelize_image
|
||||
from ml.comfyui_matting_luma_to_alpha import comfyui_matting_luma_to_alpha
|
||||
from pipelines.comfyui_export_asset_to_godot import comfyui_export_asset_to_godot
|
||||
|
||||
OUT = os.path.expanduser("~/ComfyUI/output")
|
||||
PROJ = os.path.expanduser("~/gamedev/projects/crossy_road")
|
||||
|
||||
# 1. Pixelizar un sprite crudo (SDXL+pixel-art-xl) a 16 colores
|
||||
px = comfyui_pixelize_image(f"{OUT}/hero_00001_.png", "/tmp/hero_pixel.png",
|
||||
downscale=8, colors=16)
|
||||
|
||||
# 2. Exportarlo a Godot como pixelart (carpeta sprites/, filtro Nearest, reimport)
|
||||
exp = comfyui_export_asset_to_godot("/tmp/hero_pixel.png", "pixelart", PROJ)
|
||||
print(exp["dest_res_path"], exp["pixelart_filter_set"], exp["reimported"])
|
||||
|
||||
# Rama VFX: frame de humo sobre negro -> RGBA -> carpeta vfx/
|
||||
rgba = comfyui_matting_luma_to_alpha(f"{OUT}/vfx_loop_00007_.png", gamma=1.2, black_point=0.04)
|
||||
comfyui_export_asset_to_godot(rgba["out_path"], "vfx", PROJ)
|
||||
```
|
||||
|
||||
## Fronteras (qué NO cubre)
|
||||
|
||||
- **Generación**: este grupo no genera imágenes. La Fase 1 (SDXL + LoRA
|
||||
`pixel-art-xl`, AnimateDiff loop, etc.) vive en el grupo `comfyui` y necesita GPU.
|
||||
- **Montaje de spritesheet** (grid RGBA + JSON sidecar) y **builders de workflow**
|
||||
(pixelart/VFX-loop): pendientes de la ronda siguiente (planes `reports/0135` F3/F4
|
||||
y `reports/0140` F2/F3). Cuando se añadan, van a este mismo grupo.
|
||||
- **Paletas lospec por red** (`load_lospec_palette`): no incluido. `pixelize` usa
|
||||
paletas fijas embebidas (game-boy/pico-8/nes) o lista de hex, sin HTTP.
|
||||
- **TileSet / SpriteFrames `.tres`**: Godot no los deriva solos; `export_asset_to_godot`
|
||||
copia la textura y avisa, pero no genera el recurso (paso manual o futura función).
|
||||
|
||||
## Prerequisitos / notas
|
||||
|
||||
- **Godot CLI** para el reimport headless: autodetectado en PATH y en
|
||||
`~/godot/Godot_v4.7-stable_linux.x86_64`. Si falta, `export_asset_to_godot` deja el
|
||||
`.import` escrito y lo anota (no falla).
|
||||
- **Filtro Nearest (Godot 4)**: se setea global en `project.godot`
|
||||
(`default_texture_filter=0`), no por `.import`. La función lo asegura para pixelart.
|
||||
- CPU-only: Pillow + numpy del venv del registry. Cero VRAM, cero red.
|
||||
Reference in New Issue
Block a user