diff --git a/docs/tasks/trinity-minecraft-skins/TEMPLATE-ISSUE-FIX.md b/docs/tasks/trinity-minecraft-skins/TEMPLATE-ISSUE-FIX.md new file mode 100644 index 0000000..1547f05 --- /dev/null +++ b/docs/tasks/trinity-minecraft-skins/TEMPLATE-ISSUE-FIX.md @@ -0,0 +1,194 @@ +# Minecraft Skin Template Issue - Task #61-64 Fix + +**Issue Discovered:** March 21, 2026 +**Discovered By:** Michael +**Created By The Guide:** March 20, 2026 (Chronicler #35) +**Status:** NEEDS REGENERATION + +--- + +## The Problem + +The Minecraft skins generated in the previous session (Tasks #62-64) **do not follow the correct Minecraft skin UV template format**. + +### What Was Generated (INCORRECT) +- Character sprite/illustration style +- Front-facing character image +- Does NOT follow Minecraft's skin UV mapping layout +- Will NOT work when uploaded to minecraft.net +- Looks like a normal illustration when viewed as a flat file + +### What's Needed (CORRECT) +- Minecraft skin UV template format (64x64 pixels) +- Specific layout where different regions map to body parts: + - Top section: Head (all 6 faces) + - Middle section: Body/torso (all 6 faces) + - Lower sections: Arms and legs (all faces) +- Looks "weird" when viewed flat (that's correct - it's a UV map!) +- Works when uploaded to minecraft.net + +--- + +## Root Cause + +**AI Image Generation Issue:** When The Guide asked Imagen 3 (via Gemini Pro) to generate "Minecraft skins," the AI interpreted this as "generate a character illustration" rather than "paint a design onto the Minecraft skin UV template." + +This is a common AI generation problem - the model doesn't understand the technical UV mapping requirements. + +--- + +## The Fix + +### Approach 1: Template-Based Generation (RECOMMENDED) + +**Steps:** +1. Provide Gemini with a **correct Minecraft skin template** as reference +2. Use explicit prompt: "Paint the design ONTO this exact template structure" +3. Emphasize: "Preserve the UV mapping layout, do not create a new illustration" +4. Generate with Nano Banana 2 Pro +5. Verify output matches template structure + +**Prompt:** See `/home/claude/GEMINI-MINECRAFT-SKIN-PROMPT.md` + +### Approach 2: Manual Skin Creation Tools + +If AI generation continues to fail: + +**Option A - Skin Editor Tools:** +- Use https://www.minecraftskins.com/skin-editor/ +- Use https://www.needcoolshoes.com/skin +- Paint the design manually onto the template + +**Option B - Desktop Skin Editors:** +- MCSkin3D (Windows/Mac/Linux) +- Skinseed (Mobile) +- NovaSkin Editor (Web-based) + +### Approach 3: Commission from Minecraft Skin Artist + +If needed for flagship branding quality: +- Fiverr/Upwork Minecraft skin artists +- Planet Minecraft skin creators +- Cost: $10-30 per skin typically + +--- + +## Character Specifications (For Regeneration) + +### The Wizard (Michael/Frost) - Steve Model +- **Element:** Frost/Ice +- **Colors:** Teal-blue (#4ECDC4), ice blue (#C7F0DB), silver +- **Design:** Hooded frost wizard robes with ice crystal patterns +- **Model:** Steve (classic arms) +- **File:** `the-wizard-frost-64x64.png` (needs regeneration) + +### The Emissary (Meg/Fire) - Alex Model +- **Element:** Fire/Flame +- **Colors:** Ember orange (#FF6B35), flame red (#C1121F), gold +- **Design:** Fire mage robes with flame patterns +- **Model:** Alex (slim arms) +- **File:** `the-emissary-fire-64x64.png` (needs regeneration) + +### The Catalyst (Holly/Arcane) - Alex Model +- **Element:** Arcane Storm (purple lightning) +- **Colors:** Deep purple (#6A0572), electric violet (#A64AC9), silver +- **Design:** Arcane robes with lightning/storm patterns +- **Model:** Alex (slim arms) +- **File:** `the-catalyst-arcane-64x64.png` (needs regeneration) + +--- + +## How to Verify Correct Template + +A valid Minecraft skin file will: + +✅ Be exactly 64x64 pixels +✅ Have head section in top-left (8x8 face, plus sides/top/bottom) +✅ Have body section in middle area +✅ Have arms in lower-left area +✅ Have legs in lower-right area +✅ Look "weird"/fragmented when viewed flat (this is correct!) +✅ Upload successfully to minecraft.net +✅ Render properly in-game when tested + +❌ Should NOT look like a front-facing character sprite +❌ Should NOT be a standalone illustration +❌ Should NOT ignore the UV template structure + +--- + +## Testing the Skins + +Once regenerated: + +1. **Upload to minecraft.net:** + - Go to https://www.minecraft.net/ + - Log in with your Minecraft account + - Profile → Upload Skin + - Select skin file + - Choose model (Steve or Alex) + +2. **Test in-game:** + - Launch Minecraft Java Edition + - Press F5 to see your character + - Verify skin displays correctly + - Check all angles (front, back, sides) + +3. **Test on server:** + - Join Firefrost server + - Have another player verify they can see your skin + - Take screenshot for documentation + +--- + +## Files to Update + +Once correct skins are generated: + +**Replace these files:** +``` +branding/minecraft-skins/the-wizard-frost-64x64.png +branding/minecraft-skins/the-emissary-fire-64x64.png +branding/minecraft-skins/the-catalyst-arcane-64x64.png +``` + +**Optional (128x128 HD versions):** +``` +branding/minecraft-skins/the-wizard-frost-128x128.png +branding/minecraft-skins/the-emissary-fire-128x128.png +branding/minecraft-skins/the-catalyst-arcane-128x128.png +``` + +**Commit message:** +```bash +git add branding/minecraft-skins/*.png +git commit -m "fix: regenerate Minecraft skins with correct UV template + +Previous skins were character illustrations, not proper Minecraft skin +templates. Regenerated using correct 64x64 UV mapping format. + +Fixes: Task #61-64 (Trinity Minecraft skins) +Created by: The Chronicler #36" +``` + +--- + +## Lessons Learned + +**For Future AI Skin Generation:** +1. Always provide a reference template image +2. Explicitly state "UV mapping" and "template structure" +3. Verify output matches template before committing +4. Test upload to minecraft.net as validation +5. Consider using specialized skin editor tools for precision work + +**For Documentation:** +- Include example of correct skin template in task documentation +- Add verification checklist to task README +- Document common AI generation pitfalls + +--- + +**Next Session Priority:** Regenerate all three skins with correct template format + +💙🔥❄️