Back to Node List

Rule Tile Pack

rule_tile_pack

Builds a RuleTileSet and sheet image from tile images.

Reviewed
Guide available
The node name and summary are available in English. Port, parameter, and article details are currently shown in Japanese.

Input Ports

NameTypeDescription
ルールタイルセット
tile_set
RuleTileSet
すでに作ってあるルールタイルセットです。接続すると、この内容を並べ直します。
タイル画像一覧
tiles
List<Image>
まだタイルセットにしていないタイル画像一覧です。タイルセット入力がない時に使います。
アニメフレーム
animation_frames
List<Image>
アニメーションタイル1枚として追加するフレーム画像一覧です。水面・炎などに使います。複数のアニメタイルはこのノードを数珠つなぎにして足します。

Output Ports

NameTypeDescription
ルールタイルセット
tile_set
RuleTileSet
ルールタイル系ノードへ渡せるタイルセットです。
ルールタイルアトラス
atlas
RuleTileAtlas
タイル画像を1枚に並べた情報です。アニメタイルは先頭フレームを代表画像に使います。
スプライトシート
spritesheet
SpriteSheet
同じ並び画像を、スプライトシート系ノードにも渡せる形にしたものです。
画像
image
Image
全タイルを1枚に並べた画像です。アニメタイルは先頭フレームを表示します。全フレーム出力にはRule Animation Renderを使います。
タイル数
tile_count
Int
タイルセットに含まれるタイル数です。
列数
columns
Int
並べた画像の横方向の数です。
行数
rows
Int
並べた画像の縦方向の数です。
概要
summary
Text
作成結果の短いまとめです。

Parameters

NameTypeDefaultRangeDescription / Options
タイルセット名
tileset_name
Text
Rule Tiles

画像一覧からタイルセットを作る時の名前です。

セル幅
cell_width
Int
00–2048

0 の時は最初のタイル画像から幅を推定します。

セル高さ
cell_height
Int
00–2048

0 の時は最初のタイル画像から高さを推定します。

グリッド種別
grid_kind
Enum
Orthogonal

このタイルセットを、普通の正方形マップ用にするか、アイソメ用にするかです。

  • 直交Orthogonal
  • アイソダイヤIsometricDiamond
描画順
render_order
Enum
RightDown

タイルを重ねて描く時、どの方向へ順番に描くかです。

  • 右下RightDown
  • 右上RightUp
  • 左下LeftDown
  • 左上LeftUp
列数
columns
Int
00–4096

横に何枚並べるかです。0 の時は自動で決めます。

アニメフレーム時間(ms)
animation_frame_ms
Int
1201–5000

アニメフレーム入力から作るタイルの1フレームあたりの時間です。

アニメ位相
animation_phase
Enum
Global

アニメタイルの位相の合わせ方です。

  • 全セル同期Global
    全セルが同じタイミングで切り替わります。
  • セル毎にずらすCellSeeded
    セルごとに位相をずらします(再評価してもちらつきません)。水面向きです。
配置順
fill_order
Enum
RowMajor

タイルを右へ並べるか、下へ並べるかです。

  • 右へRowMajor
  • 下へColumnMajor

Overview

Creates a RuleTileSet and a single-image atlas from a list of tile images. It packages tiles drawn or processed in the graph into a form usable by rule-tile nodes and Tiled export.

Usage tips

  • The entry point for custom-image rule tiles is tile images bundled with list_create → rule_tile_pack → rule_canvas.tile_set.
  • For the regular Wang16 or Blob47 image counts used by autotiles, autotile_from_parts / autotile_from_template are better upstream tools. This node packages any number of images.
  • Use the atlas output together with tiled_tileset_export.
  • Animated tiles use their first frame as the representative image in the atlas and sprite sheet. Use rule_animation_render when you need every frame.

Related nodes

  • rule_canvas / rule_render — consume tile_set
  • tiled_tileset_export — exports the atlas
  • autotile_from_parts / autotile_from_template — generate autotile images
  • rule_tile_merge — combines tile sets

What this node does

From a tile-image list or existing rule tile set, creates the RuleTileSet used by rule-tile nodes plus a RuleTileAtlas, sprite sheet, and image containing every tile. It replaces the legacy Tile Atlas Pack.

Key settings

ID Name Description
tileset_name Tile-set name Name used when building from an image list.
cell_width / cell_height Cell width/height At 0, inferred from the first tile image.
grid_kind Grid kind Orthogonal / isometric diamond.
render_order Render order Direction used when layering tiles.
columns Columns Number of sheet columns; 0 is automatic.
fill_order Fill order Whether tiles advance rightward or downward.

Example wiring

RuleTilePack.tile_set -> RuleCanvas.tile_set
RuleTilePack.tile_set -> TiledTilesetExport.tile_set
RuleTilePack.atlas    -> TiledTilesetExport.atlas
Back to Node List
Rule Tile Pack — PixPipeline Node Reference