firefrost-operations-manual/docs/tasks/trinity-minecraft-skins/TEMPLATE-ISSUE-FIX.md

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:

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

💙🔥❄️