docs: document Minecraft skin template issue and fix
The skins generated in previous session don't follow correct Minecraft UV template format. They're character illustrations instead of proper skin templates and won't work when uploaded to minecraft.net. Created comprehensive fix documentation and Gemini prompt for regeneration. Related: Tasks #61-64 (Trinity Minecraft skins) Created by: The Chronicler #36
This commit is contained in:
Claude
194
docs/tasks/trinity-minecraft-skins/TEMPLATE-ISSUE-FIX.md
Normal file
194
docs/tasks/trinity-minecraft-skins/TEMPLATE-ISSUE-FIX.md
Normal file
@@ -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
|
||||
|
||||
💙🔥❄️
|
||||
Reference in New Issue
Block a user