Back to Node List

Model Array

model_array

Creates linear, grid, or radial part instances while sharing immutable mesh and material assets.

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
モデル
model
Model
Required
メッシュブーリアンを行わず組み立てるポリゴンモデルです。

Output Ports

NameTypeDescription
モデル
model
Model
組み立てたゲーム向けポリゴンモデルです。

Parameters

NameTypeDefaultRangeDescription / Options
配列モード
mode
Enum
Linear

配列の配置方式です。

  • 直線Linear
  • グリッドGrid
  • 円形Radial
個数
count
Int
31–256

直線または円形配列の個数です。

列数
count_x
Int
31–64

グリッドの列数です。グリッドの総インスタンス数は256以下です。

行数
count_y
Int
31–64

グリッドの行数です。グリッドの総インスタンス数は256以下です。

X間隔
spacing_x
Float
1-256–256 / step 0.05

直線配列のインスタンスごとのx移動量、またはグリッドの列間隔です。

グリッドY間隔
spacing_y_mode
Enum
LinkToX

グリッドの行間隔をX間隔へ連動するか、Y間隔で個別指定するかを選びます。

  • Xに連動LinkToX
    グリッドの行間隔にX間隔を使います。
  • 個別指定Custom
    グリッドの行間隔にY間隔の値をそのまま使います。0も指定できます。
  • 旧式(0で連動)LegacyZeroLinks
    v1グラフ移行用の互換モードです。0はX間隔へ連動し、非0はその値を使います。
Y間隔
spacing_y
Float
0-256–256 / step 0.05

直線配列のインスタンスごとのy移動量、またはグリッドY間隔が個別指定のときの行間隔です。Xに連動中のGridではこの値を使いません。

Z間隔
spacing_z
Float
0-256–256 / step 0.05

直線・円形ではインスタンスごと、グリッドでは(列+行)ごとに加算するz間隔です。

半径
radius
Float
20–256 / step 0.05

円形配列の半径です。

開始角度
start_angle
Angle
0— / step 1

z軸まわりの開始角度です。

範囲角度
sweep_angle
Float
360-360–360 / step 1

円形配列の範囲角度です。

個別回転
rotate_instances
Bool
true

円形配列の各インスタンスを配置角度に合わせてz回転します。

Overview

Duplicates and arranges a model in a line, grid, or circle. Repeating elements such as fences, rows of pillars, and floor tiles are placed as instances that share their mesh and texture, keeping the model lightweight without duplicating data.

Usage tips

  • This is the Model counterpart to solid_array. Use it for repeated copies of the same part, such as fences, colonnades, and rows of spikes.
  • Because the instances share their source, replacing the original part's texture immediately updates the entire arrangement.
  • The instancing structure is preserved through model_gltf_export, keeping the asset efficient in the target engine.
  • A Grid is limited to 256 total instances (columns × rows). Changing one count updates the other count's available maximum. Saved or connected values over the limit produce a clear error instead of silently returning a partial grid.
  • Grid Y Spacing can follow Spacing X for square cells or use the literal Spacing Y value. Custom mode accepts zero, so rows can intentionally share one Y position. Link to X mode does not use the displayed Spacing Y value. Migrated v1 graphs with a connected Spacing Y use Legacy Zero-Link mode to preserve their behavior.
  • Spacing Z advances per instance in Linear and Radial modes. In Grid mode it uses (column + row) × Spacing Z. Exactly coincident instances show a Z-fighting warning.

Related nodes

  • solid_array — the equivalent for the pixel-art image workflow
  • model_box / model_cylinder / model_pyramid — base primitives to duplicate
  • model_gltf_export — exports the arrayed model
Back to Node List
Model Array — PixPipeline Node Reference