tileset

Generate terrain atlases and compile them into native Godot TileSet resources.

531|45|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/RandallLiuXin/GodotMaker --skill tileset
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tileset
Source: https://github.com/RandallLiuXin/GodotMaker/tree/main/skills/assets/tileset
Command: npx skills add https://github.com/RandallLiuXin/GodotMaker --skill tileset

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Building a reusable Godot TileSet by hand requires painting dozens of autotile transition slots, configuring peering bits, and writing .tres resources manually, which is error-prone and slow. This Skill automates the full pipeline from a text brief and optional art references to a validated, native Godot TileSet.

Core Features & Use Cases

  • Fixed Autotile Profiles: Supports the versioned marching_squares_15 (4x4 grid, Match Corners) and blob_47 (8x6 grid, Match Corners and Sides) terrain profiles with deterministic slot coordinates and peering bits.
  • Provider-Based Art Generation: Generates the source terrain materials through native, Codex, Gemini, or OpenAI image providers with full provenance tracing and controlled claim of generated images.
  • L0-L4 Validation Ladder: Validates the request contract, atlas integrity, compilation, headless Godot loading, and structural equivalence of the loaded TileSet against the generated recipe.
  • Use Case: A game developer needs a shoreline terrain set for a 2D prototype. They supply a brief naming the foreground water and background sand materials, select blob_47, and receive a compiled .tres TileSet plus atlas ready to reference from any TileMap.

Quick Start

Ask the agent to generate a Godot TileSet with asset_type tileset, a stable asset_id, a brief describing the terrain, and a spec choosing either the marching_squares_15 or blob_47 autotile profile with tile size and terrain materials.

Frequently Asked Questions about tileset

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a Godot TileSet from a text brief?

Provide an ASSET_REQUEST.json with asset_type tileset, a stable asset_id, a brief, and a spec containing autotile_profile, tile_size, and terrain materials. The skill generates the atlas through an image provider, composes the fixed profile slots, and compiles a native .tres TileSet.

What is the difference between marching_squares_15 and blob_47 autotile profiles?

marching_squares_15 uses a 4x4 atlas with 15 painted slots and Match Corners mode, suited for rule-based roads, floors, and walls. blob_47 uses an 8x6 atlas with 47 slots and Match Corners and Sides mode, suited for natural ground, caves, and shorelines with detailed inner and outer corners.

Which image generation providers does the TileSet skill support?

The skill supports native, codex, gemini, and openai providers, and the selected provider never falls back to another. Codex generation requires a provider trace plan and a controlled claim step before the image enters the project.

Can this skill create or paint a TileMap in Godot?

No. The skill only produces a reusable TileSet library resource (.tres) plus its atlas. Creating or painting a TileMap that consumes the TileSet is explicitly outside its scope and is the caller's responsibility.

Why does TileSet validation fail at L1 or L3?

L1 fails when the atlas file is missing, empty, or outside the allowed output directory. L3 fails when headless Godot cannot load the compiled .tres as a TileSet, usually indicating a compilation or resource structure problem that requires repairing the art or recipe and re-running validation.

Does the TileSet skill support animated tiles or occlusion layers?

No. The skill explicitly does not support animated TileSets, occlusion, or alternative terrain modes. Physics, navigation, and custom data can only be declared through semantic_metadata on named roles such as foreground_full or foreground_isolated.