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 → summer:asset-pipeline/asset-strategy (image-to-3D).
• The user wants a unique mural / non-tiling artwork → summer:2d-assets/concept-art or summer:2d-assets/character-portrait.
• The user wants a skybox / 360° environment → summer: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

summer_search_assets(query=" 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:

, 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."

3. Generate

summer_generate_image(
  prompt="weathered red brick wall, seamless tileable texture, top-down view, uniform lighting, no perspective, no shadows, no specific objects, square format, photographic detail",
  model="nano-banana-2",
  style="realistic",
  options={
    image_size: "square_hd",
    negative_prompt: "perspective, vanishing point, directional shadow, vignette, single feature, scene context, sky, sun"
  }
)

style: "realistic" is the right default for textures (most are aiming for photographic surface). Switch to "none" for stylized/painterly.

4. Import to project

summer_import_from_url(url="", path="res://art/textures/brick_red.png")

In the import dock, set:

• Repeat: Enabled (REQUIRED for tiling).
• Filter: Linear with mipmaps (smoother at distance).
• Mipmaps: Enabled (textures viewed at angle need mipmaps).
• Compress: VRAM Compressed for ship; Lossless while iterating.

5. Verify the seam

Before wiring into a scene, view the texture tiled. Quick check: in the editor's filesystem dock, right-click the texture → preview → set repeat 4×4 mentally. Or apply to a PlaneMesh with uv_scale = (4, 4) and look from above.

If you see a grid of identical "interest features" (a chip, a stain, a bright pixel) repeating, the tile has a hotspot — regenerate with stronger negative on "single feature."

If you see hard horizontal/vertical seams, the edges don't match — regenerate with extra emphasis on seamless or run the texture through a seamless-tile filter (Photoshop "Offset" + heal, GIMP "Make Seamless", or Aseprite's Tiled Mode).

6. Wire onto geometry

On a PlaneMesh (floor/ceiling):

summer_add_node(parentPath="/root/Level", type="MeshInstance3D", name="Floor")
summer_set_resource_property(nodePath="/root/Level/Floor", resourceProperty="mesh", value="")
summer_set_prop(path="/root/Level/Floor", property="mesh:size", value="Vector2(20, 20)")

Then create a StandardMaterial3D, set albedo_texture to the imported texture, and crank uv1_scale so each tile covers ~1m of world space:

summer_set_resource_property(
  nodePath="/root/Level/Floor",
  resourceProperty="material_override",
  subProperty="albedo_texture",
  value="res://art/textures/brick_red.png"
)
summer_set_resource_property(
  nodePath="/root/Level/Floor",
  resourceProperty="material_override",
  subProperty="uv1_scale",
  value="Vector3(20, 20, 1)"
)

uv1_scale = (20, 20, 1) on a 20m plane means the texture tiles 20× across — each tile covers 1m².

On a CSGBox3D (walls):

summer_add_node(parentPath="/root/Level", type="CSGBox3D", name="WallNorth")
summer_set_prop(path="/root/Level/WallNorth", property="size", value="Vector3(10, 3, 0.3)")

Then attach the same material with uv1_scale tuned to wall dimensions.

Prompt patterns

| Goal | Prompt that works | Why | |---|---|---| | Brick wall | weathered red brick wall, seamless tileable texture, top-down view, uniform lighting, no perspective, no shadows, no specific objects, square, photographic | Top-down + uniform lighting kill perspective seams | | Grass ground | dense fresh grass, seamless tileable texture, top-down view, uniform lighting, no shadows, no flowers, no patches, square | "No flowers, no patches" kills hotspot features | | Wood floor | oak wood floor planks, seamless tileable, top-down view, uniform lighting, no perspective, no nails, no knots emphasized, square | "No knots emphasized" kills the ONE bright knot per tile | | Stone tiles | cobblestone path, seamless tileable, top-down, uniform lighting, no shadows, no moss patches, square, photographic | "No moss patches" kills hotspot | | Metal panel | industrial metal floor panel, seamless tileable, top-down, uniform lighting, no rust hotspots, no scratches concentrated, square | Diffuse rust spreads across the tile instead of clumping | | Sand / dirt | dry desert sand, seamless tileable, top-down view, uniform soft lighting, no footprints, no rocks, no shadows, square | Negative space is ideal for tiling | | Stylized painterly grass | stylized painterly grass, Studio Ghibli, seamless tileable, top-down, uniform lighting, no specific blades emphasized, square (style: "none") | Style preset would fight the painterly direction | | Sci-fi panel | sci-fi metal floor panel with subtle glowing seams, seamless tileable, top-down, uniform lighting, square, the glowing seams form a regular grid that aligns with tile edges | Make the seams part of the design |

Bad prompts (and why)

| Bad | Failure mode | |---|---| | brick wall | No "seamless," no "top-down." Returns a 3D-photographed wall with perspective and a corner. Useless for tiling. | | seamless brick wall in a dungeon at night | Scene context bakes shadows and ambience that won't tile. | | tileable grass with flowers and rocks | Hotspot features. Each tile has the SAME flower. Visible repeat. | | seamless wood floor (not specifying square / top-down) | Often returns floor-from-eye-level with perspective. | | pbr wood floor texture | "PBR" implies a material set (albedo + normal + roughness). The model only outputs albedo. Generate albedo, derive maps separately. |

Anti-patterns

• Skipping Repeat: Enabled on import. Default is Repeat: Disabled. The texture stretches across the whole surface instead of tiling. Looks blurry at distance.
• Not tuning uv1_scale. Default scale of (1, 1, 1) on a 20m floor means the 1m-real texture is stretched to 20m. Always scale to physical sizing.
• Hotspot features that scream "repeated tile." Regenerate with stronger negative on single-feature words.
• Generating PBR sets with one image. Diffusion outputs albedo only. For normals/roughness, use a derivation tool or hand-author. Don't claim it's PBR-ready when it's not.
• Forgetting mipmaps. Tileable textures viewed at distance need mipmaps; without them, you get shimmering moire.
• Using textures with directional shadow baked in. Even subtle shadow stripes when tiled. Always demand "uniform lighting."

Edge cases

• User wants normal map / roughness / AO too. Generation today produces albedo only. Use Materialize (free) or MaterialMaker (open source) to derive a normal from the albedo. Hand-paint roughness if the surface is heterogeneous (wood = low roughness on knots, high on grain). Set the user's expectation: AI gives albedo; PBR is a follow-up step.
• Texture must tile in only one direction (e.g., a brick wall that runs horizontally but not vertically). Generate 1024×1024 seamless, then crop to your actual aspect; the horizontal tile remains seamless. Or: prompt tileable horizontally only, distinct top and bottom edges for ceiling-to-floor walls.
• Texture must read at very low resolution (mobile, distant LOD). Generate at square_hd, downscale on import via Compress: VRAM Compressed. Avoid generating at low resolution — model quality drops.
• User wants animated water / lava texture. Generate a still tileable texture and use a ShaderMaterial with UV scrolling to animate. Don't try to generate frames.
• Visible seam after generation. Run through GIMP Filters → Map → Make Seamless or open in Aseprite, set Tiled mode, paint over the seam manually. AI-generated tileables often need a 5-minute touch-up.

Fallback (no MCP)

Print the call:

summer_generate_image(
  prompt=" seamless tileable texture, top-down view, uniform lighting, no perspective, no shadows, no specific objects, square",
  model="nano-banana-2",
  style="realistic",
  options={ image_size: "square_hd", negative_prompt: "perspective, directional shadow, single feature, scene context" }
)

Tell the user to run via the Summer dashboard, then summer_import_from_url to res://art/textures/.png, set Repeat: Enabled, and tune uv1_scale to physical size.

If MCP is offline entirely: AmbientCG and Polyhaven offer free CC0 PBR texture sets that often beat AI for realism. For stylized, hand-author in Aseprite/Krita with tile-mode preview.

Handoff

After the texture is wired:

• More textures in the same biome → re-invoke this skill, hold style/lighting consistent.
• Apply to a procedurally-built level → summer:scene-composition for CSG and modular wall kits.
• PBR set with normals/roughness → out of MCP scope today; user runs derivation in MaterialMaker.
• Skybox for the level's environment → summer:2d-assets/skybox-panorama.

See also

• summer:asset-pipeline/asset-strategy — meta-router and 3D pipeline.
• summer:2d-assets/skybox-panorama — sky/environment counterpart.
• summer:scene-composition — applying textures to CSG and MeshInstance3D.
• references/mcp-tools-reference.md — summer_generate_image schema.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: SummerEngine
• Source: SummerEngine/summer-engine-agent
• License: MIT
• Homepage: https://summerengine.com/

Install and usage instructions live in the source repository linked above.