diff --git a/tools/retro-diffusion/lora-triggers.md b/tools/retro-diffusion/lora-triggers.md new file mode 100644 index 0000000..28cbcb1 --- /dev/null +++ b/tools/retro-diffusion/lora-triggers.md @@ -0,0 +1,73 @@ +# Retro Diffusion style LoRAs — trigger-word reference + +Local record of the RD style-LoRA trigger words, for reproducible ComfyUI +ideation prompts without round-tripping to comfy-dev. Canonical source is +`catalog/loras.yaml` on the ComfyUI box (irv-ml1); this is m03-dev's working +copy (from comfy-dev, thread 01M01PKJ5EAR…, 2026-08-15). + +**Licensing (operator directive):** these weights are copyrighted, +licensed-for-use, **not-for-export** — fleet-internal only, no +redistribution / publish / serve. Ideation OUTPUT stays `_ph` placeholder +per the game asset policy. This file records trigger STRINGS (not weights), +but treat the whole capability as internal. + +**How triggers work:** prepend the trigger token to the prompt to activate +the LoRA's trained style. Coverage = share of the LoRA's training captions +that led with that token (higher = more reliable). Derived from each LoRA's +kohya `ss_tag_frequency`. + +## Reliable (coverage ≥ 85%) + +| ComfyUI `lora_name` | trigger | coverage | +|---|---|---| +| `rd/1bit.safetensors` | `pixel1biticons` | 100% | +| `rd/flatshading.safetensors` | `pixelflat64` | 100% | +| `rd/frontfacing.safetensors` | `pixelfurniture64` | 100% | +| `rd/gameboy.safetensors` | `gameboy64` | 100% | +| `rd/gameboyadvance.safetensors` | `gba64` | 100% | +| `rd/gamecharacters.safetensors` | `duelystchar` | 100% | +| `rd/gameicons.safetensors` | `pixelicons64` | 100% | +| `rd/isometric.safetensors` | `isometric` | 100% | +| `rd/modern.safetensors` | `svportrait64` | 85% | +| `rd/neogeo.safetensors` | `neogeo64` | 100% | +| `rd/nes.safetensors` | `nes64` | 94% | +| `rd/playstation.safetensors` | `psone` | 100% | +| `rd/snes.safetensors` | `snes64` | 87% | +| `rd/tiling.safetensors` | `pixelmcblocks64` | 100% | +| `rd/tiling16.safetensors` | `pixelmcblocks64` | 99% | +| `rd/tiling32.safetensors` | `pixelmcblocks64` | 100% | +| `rd/topdown.safetensors` | `pixelbuildings64` | 94% | + +## Weak-but-distinctive (verify on first use) + +| ComfyUI `lora_name` | trigger | coverage | +|---|---|---| +| `rd/simplegeometric.safetensors` | `pixelflatoutlined` | 38% (coined token, likely real) | + +## No trigger — style-from-weights, just load + +- `rd/gamecharactersanime.safetensors` +- `rd/gamecharactersretro.safetensors` +- `rd/industrial.safetensors` +- `rd/nashorkimitems.safetensors` +- `rd/segagenesis.safetensors` +- `rd/uipanel.safetensors` + +(24 total: 17 reliable + 1 weak + 6 untriggered.) + +## Gotchas + +- **All three `tiling*` LoRAs share `pixelmcblocks64`** — the token does NOT + encode tile size (the weights do). Do NOT substitute `pixelmcblocks16/32`. +- **`isometric` / `psone` triggers disagree with their vendor stems** + (`isopixel64-v2`, `psone64-v1`). Caption token recorded here leads 100%; + if either underperforms, try the stem form as a fallback. + +## For the U R M03 first batch + +Likely-relevant: `duelystchar` (gamecharacters) and `gamecharactersretro` / +`gamecharactersanime` (no trigger) for M03/grunt/burster sprites; +`frontfacing` (`pixelfurniture64` — note: furniture-trained, verify on a +character) and `topdown` (`pixelbuildings64`) for camera; console-palette +LoRAs (`nes64`, `gameboy64`, …) for the hi-bit palette exploration. +Render at 512, downscale to 32/48px targets (model resolution floor).