tileable-texture

tileable-texture — Seamless Square That Repeats Cleanly

This skill generates a seamless square texture (typically 1024×1024) that tiles cleanly on all four edges with no visible seams. Output goes onto a PlaneMesh, CSGBox3D, or MeshInstance3D as a StandardMaterial3D albedo, often with uv_scale cranked up so a single tile covers a small area and the surface repeats it across a wall or floor.

The hard part is "seamless." Most diffusion models violate edge continuity by default — generate a brick wall and the bricks stop mid-row at the edge. This skill encodes the prompt suffix and the post-import verification that catches seams before they ship.

When to use

• "Generate a brick wall texture for this room."
• "I need a grass ground texture for the level."
• "Tileable wood-floor texture, 1024×1024."
• "Stone tile texture for the dungeon."
• "Sand / dirt / metal-panel — seamless."

When NOT to use

• The user wants a 3D-modeled wall with geometric brick relief → onyx:asset-pipeline/asset-strategy (image-to-3D).
• The user wants a unique mural / non-tiling artwork → onyx:2d-assets/concept-art or onyx:2d-assets/character-portrait.
• The user wants a skybox / 360° environment → onyx:2d-assets/skybox-panorama.
• The user wants a normal map / PBR material set — generation today is albedo-only. Normals must be derived (MaterialMaker, NormalMap-Online) or hand-authored.

Steps

1. Search for an existing texture

onyx_search_assets(query="<material> tileable", filter={ kind: "image" })

Texture libraries (AmbientCG, Polyhaven) often have free PBR sets that beat AI generation for realism. If the user wants photorealistic tiling, pause and suggest those.

2. Build the prompt — material + the seamless suffix

Pattern:

<material description>, seamless tileable texture, top-down view, uniform lighting, no perspective, no shadows, no edges, square format, no specific objects in frame

The load-bearing phrases are:

• seamless tileable texture — primes the model.
• top-down view — kills perspective convergence (which is the #1 source of visible seams).
• uniform lighting — kills directional shadows that bake into the tile and stripe across the surface when it repeats.
• no perspective, no shadows, no edges — explicit negation of common failure modes.
• no specific objects in frame — kills "interest" features the model adds (a single bright leaf, a chip in one brick) that scream "this is a repeating tile."