// Generate seamless tileable block textures for voxel games using nanobanana MCP. Use when: creating game textures, generating block assets, building texture atlases. Triggers: "generate texture", "create block texture", "voxel texture", "/voxel-texture"
| name | voxel-texture |
| description | Generate seamless tileable block textures for voxel games using nanobanana MCP. Use when: creating game textures, generating block assets, building texture atlases. Triggers: "generate texture", "create block texture", "voxel texture", "/voxel-texture" |
Generate professional seamless tileable block textures for voxel games using nanobanana MCP and ImageMagick processing.
⚠️ This skill REQUIRES the nanobanana MCP server.
If nanobanana MCP is unavailable:
The number one mistake: AI image generators often create 3D cube renders instead of flat tileable patterns.
Core principles to remember:
When invoked with a block type (e.g., "/voxel-texture dirt"):
Call mcp__nanobanana__generate_image with these parameters:
mcp__nanobanana__generate_image(
prompt="""Create a flat, seamless tileable {block_type} texture pattern for a voxel block game (top-down orthographic view, NOT a 3D cube).
The texture should be:
- A FLAT 2D pattern that tiles seamlessly on all edges
- {material_color_description}
- {material_pattern_description}
- Sharp, clean pixel art style suitable for 64x64 resolution
- Should look like looking straight down at a flat {material} surface, not a 3D object
- No perspective, no cube faces, no depth illusion
Style: Minecraft-style pixel art texture, flat top-down orthographic view, seamless edges for perfect tiling. This is a TEXTURE PATTERN, not a 3D rendered object.""",
aspect_ratio="1:1",
resolution="high",
model_tier="pro",
negative_prompt="3D render, cube, isometric, perspective, shadows, lighting effects, depth, dimensional, rendered object, 3D model, box, block shape, geometric solid",
output_path="/Users/probello/Repos/voxel-world/textures/{block_type}_64x64.png"
)
After generation completes, run the processing script:
/Users/probello/Repos/voxel-world/.claude/skills/voxel-texture/scripts/process_texture.sh {block_type}
The script will:
Examine the generated files:
{block_type}_64x64.png - Check if pattern is flat and clear (not 3D){block_type}_tiled_preview.png - Look for visible seams at edgesRed flags requiring regeneration:
After verification passes:
make sprite-gen to update UI spritesUse these descriptions when generating textures:
Why it's bad: Textures with cube perspective don't tile and look wrong on flat surfaces
How to avoid: Use strong negative prompts: 3D render, cube, isometric, perspective. Explicitly state "flat top-down view, NOT a 3D cube" in prompt. Regenerate if output shows any 3D characteristics.
Why it's bad: AI often generates 1408x768 or other non-square dimensions
How to avoid: Always run the processing script which checks and fixes dimensions. Use -filter point -resize 64x64! to force exact size.
Why it's bad: Default bilinear filter blurs pixel art, ruins crisp edges
How to avoid: The processing script always uses -filter point for nearest-neighbor sampling.
Why it's bad: ImageMagick may produce 64x63 or 63x64 without exact flag
How to avoid: The processing script always uses 64x64! (with exclamation) to force exact dimensions.
Why it's bad: Seams only visible when tiles repeat, single tile looks fine How to avoid: The processing script automatically creates 2x2 tiled preview for verification.
Why it's bad: "ice texture" produces wildly inconsistent results How to avoid: Use full structured prompt with color, pattern, and detail descriptions from the material descriptions above.
Why it's bad: Wastes time, produces unusable results, requires regeneration How to avoid: Check MCP availability FIRST at the beginning of this skill, stop if unavailable.
Solution:
model_tier="pro" for better prompt followingSolution:
Solution:
-filter point which prevents blurringSolution:
identify *_64x64.png in textures directory to verify ALL textures are exactly 64x64identify *_64x64.png | grep -v "64x64"(N*64)x64 dimensions where N = texture countTexture directory: /Users/probello/Repos/voxel-world/textures/
File naming:
{block_type}_64x64.png - Final game-ready 64x64 texture (REQUIRED){block_type}_tiled_preview.png - 2x2 tiling verification (RECOMMENDED)texture_atlas.png - Complete atlas with all textures horizontally concatenatedBefore proceeding to atlas integration, verify:
If any gate fails: Stop, fix the issue, and re-verify before proceeding.
The texture is not done until:
After texture generation and verification:
CLAUDE.md with new block type and atlas positionBlockType enum in src/chunk.rsshaders/common.glslsrc/ui/palette.rsmake sprite-gen to generate UI spriteBLOCK_FILES in src/gpu_resources.rsmake checkall to verify compilationSee CLAUDE.md for complete block addition workflow.