Tilemap Ruletile Createfromsegment

Tilemap RuleTile Create From Segment

Purpose

This skill creates Unity RuleTile TilingRules by first analyzing sprites using the sprite-segment-3x3grid skill, then converting the resulting text patterns into neighbor rule configurations. The user must specify Sprites or a Spritesheet input.

Workflow

Step 1: sprite-segment-3x3grid    Step 2: Create TilingRules
+--------------------------+      +--------------------------+
|  Analyze each Sprite     |      |  Parse text patterns     |
|  using color matching    |  ->  |  Map to neighbor rules   |
|  Output: text pattern    |      |  Sort by specificity     |
+--------------------------+      +--------------------------+

CRITICAL: Always run the sprite-segment-3x3grid skill first on each Sprite to generate the text pattern.

Step 1: Apply sprite-segment-3x3grid (Required)

For each Sprite in your texture, analyze it with sprite-segment-3x3grid:

string pattern = SpriteSegment3x3Grid.AnalyzeSpriteGrid(sprite, matchThreshold: 0.75f);

Pattern Output Format

Single-line text pattern: [TopRow] / [MiddleRow] / [BottomRow]

Each row contains 3 characters separated by spaces:

• X - Cell does NOT meet match threshold
• . - Cell MEETS match threshold (matches center color)
• * - Center cell (the tile itself)

Example: X X X / X * X / . . .

Step 2: Create TilingRules from Patterns

Symbol to Rule Mapping

Note: "DontCare" is not an explicit constant. A position is "don't care" when it is simply not included in the m_Neighbors and m_NeighborPositions lists.

Neighbor Position Mapping

Grid Layout:              Unity Vector3Int positions:
[0] [1] [2]  (Top)        (-1,1,0)  (0,1,0)  (1,1,0)
[3] [*] [5]  (Middle)     (-1,0,0)    ---    (1,0,0)
[6] [7] [8]  (Bottom)     (-1,-1,0) (0,-1,0) (1,-1,0)

Pattern Filtering

By default, detected patterns that do not match any entry in the Common Tile Patterns table are discarded. Only the 47 known patterns are kept. This prevents unexpected or noisy rules from appearing in the final RuleTile.

If the user explicitly asks to keep non-standard patterns, set filterToKnownPatterns: false to bypass this filtering.

Deduplication

Duplicate TilingRules with identical neighbor configurations are automatically removed. When multiple sprites produce the same pattern, only the first sprite encountered is kept.

Rule Sorting

Rules are sorted by specificity (number of This rules) in descending order. More specific rules are evaluated first.

Sprite Assignment

Each TilingRule is assigned at most 1 Sprite:

• Set m_Output to TilingRuleOutput.OutputSprite.Single
• Assign the sprite to m_Sprites[0]

The RuleTile's m_DefaultSprite is set to the sprite from the bottom-most (least specific) rule. Since rules are sorted by specificity descending, this is the last rule in the list. This sprite is used when no TilingRule matches.

Algorithm Summary

1. For each Sprite: Run sprite-segment-3x3grid and store the pattern
2. Filter: Discard patterns not in Common Tile Patterns (unless user opts out)
3. Deduplicate: Remove duplicate patterns (first sprite wins)
4. Parse: Split by / for rows, then by space for cells
5. Extract Neighbors: . -> add position with This (1); X -> skip
6. Create TilingRule: Populate m_Neighbors and m_NeighborPositions
7. Assign Sprite: Set single sprite output
8. Sort: Order by specificity descending
9. Apply: Add sorted rules to RuleTile asset
10. Default Sprite: Set m_DefaultSprite to the last (least specific) rule's sprite

Scripts

Implementation and usage examples are in the scripts/ folder:

Quick Usage

// Get sprites and create rules in one call
var rules = TilemapRuleTileCreateFromSegment.CreateRuleTileFromSprites(
    sprites, matchThreshold: 0.75f, colorTolerance: 0.04f);

// Apply to RuleTile
var ruleTile = ScriptableObject.CreateInstance<RuleTile>();
TilemapRuleTileCreateFromSegment.ApplyRulesToTile(ruleTile, rules);

Common Tile Patterns

Notes

• Always run sprite-segment-3x3grid first -- this skill depends on its output
• Rules are evaluated in order; first matching rule wins
• A rule with 0 This conditions matches any configuration (use as fallback)
• The center cell (*) is always ignored in neighbor calculations
• Unity's RuleTile supports up to 8 neighbors in a standard 3x3 grid
• For hexagonal or isometric grids, use HexagonalRuleTile or IsometricRuleTile

Prerequisites

• sprite-segment-3x3grid skill: generates the input patterns. It ships in this same plugin as sprite-segment-3x3grid, so it is always available — invoke it rather than treating it as an unmet dependency.
• com.unity.2d.tilemap.extras package: Required for RuleTile class

See Also

• sprite-segment-3x3grid - required prerequisite; generates the input patterns
• Packages/com.unity.2d.tilemap.extras/Runtime/Tiles/RuleTile/RuleTile.cs for RuleTile implementation
• Unity Manual: Rule Tile