pixelkiln 0.88.0 → 0.89.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/docs/PIXELLAB.md CHANGED
@@ -71,11 +71,11 @@ unapproved files. See [Manifest quality profiles](./MANIFEST.md#quality-profiles
71
71
  | `pixflux` | You need a closed palette or a full-bleed background | 1 generation |
72
72
  | `1dir` | You need references or several candidates for human review | 10 to 25 generations |
73
73
  | `tiles` | You need ground variations or a connected structural set | 10 to 25 generations |
74
- | `terrain` | You need a two-terrain Wang tileset (grass to water, floor to cliff) | 10 to 25 generations (unmeasured) |
74
+ | `terrain` | You need a two-terrain Wang tileset (grass to water, floor to cliff), sets that share a terrain, or a sidescroller platform set | sidescroller 3 (measured); top-down Pro 15 or 25, standard up to 4 (PixelLab's quote) |
75
75
  | `isometricTile` | You need one standalone isometric tile, 16 to 64px | 1 generation (measured once) |
76
- | `imagePro` | You need a larger or non-square scene, up to 792 wide and 688 tall | 10 to 25 generations |
76
+ | `imagePro` | You need a larger or non-square scene, up to 792 wide and 688 tall, optionally held to the style's `palette` | 10 to 25 generations |
77
77
  | `imageProFlash` | You need a still on the Pro Flash model, optionally styled from one image, 16 to 256px | 5 to 9 generations (provisional quote) |
78
- | `vfx` | You need an animated effect (spell, hit, explosion, aura), on its own or around a sprite | free (rendered, not generated) |
78
+ | `vfx` | You need an animated effect (spell, hit, explosion, aura), on its own or around a sprite | free from presets and parts; 1 to 28 when described to PixelLab's artist (lite measured at 1) |
79
79
  | `character` | You need a character in 4 or 8 directions, with states, loops, portraits, or outfits | See [Characters](./CHARACTERS.md) |
80
80
  | `objectPro` | You need a prop or creature with rotations, states, or loops but no character rig | about 6 at 64px (unmeasured) |
81
81
  | `uiAsset` | You need a UI panel composited from pieces and named elements, 192px and up | 20 generations (measured once) |
@@ -100,6 +100,91 @@ beside the submit-time `cost` estimate a wave budget spends against;
100
100
  `pixelkiln history`, `plan --json`, and the gallery show both when they
101
101
  differ (docs/ENDPOINTS.md, "Limits and billing").
102
102
 
103
+ ## What changed in PixelLab 0.4.130
104
+
105
+ PixelLab 0.4.130 (October 2026) added four things. PixelKiln covers each:
106
+
107
+ - **Tileset Pro.** Top-down Pro sets take roundness, connected diagonals, an
108
+ uneven boundary, and edge slope, and sets can share a terrain. These are
109
+ `terrain` style fields plus an asset's `connect`; see the
110
+ [manifest reference](./MANIFEST.md). Sidescroller sets use
111
+ `terrainOrientation: "sidescroller"`. The public API has no Pro mode for
112
+ sidescrollers yet.
113
+ - **A target palette for Create Image Pro.** An `imagePro` style's `palette`
114
+ now reaches PixelLab, which draws every pixel from it. `maxColors` caps
115
+ each image and `paletteName` names the palette.
116
+ - **VFX in the API.** A `vfx` block with a `description` asks PixelLab's
117
+ effects artist for the effect, at 1 generation and up. Presets, parts, and
118
+ recipes still render free on the workbench. See
119
+ [Generator selection](./GENERATORS.md#described-effects-the-paid-vfx-artist).
120
+ - **Normal maps.** A `normal-map` revision makes one for a sprite or a whole
121
+ loop at 0.5 generations, and `pixelkiln normal-map` does it for a loose
122
+ file. See [Controlled asset revisions](./REVISIONS.md#normal-maps).
123
+
124
+ Three have been billed live once each: a sidescroller set (3 generations),
125
+ a lite described effect (1, its quote), and an 8-frame normal map strip
126
+ (0.5). Top-down Pro prices and the palette use PixelLab's published
127
+ prices.
128
+
129
+ ## Learn from PixelLab's tutorials
130
+
131
+ PixelLab's YouTube channel teaches its web app, not PixelKiln, but most of
132
+ its advice carries over. Two recent videos changed what we recommend.
133
+
134
+ ### Pro tilesets
135
+
136
+ [PixelLab Pro Tilesets: Full Guide](https://www.youtube.com/watch?v=MbkqpDUFkEg)
137
+ covers the `terrain` generator's endpoint.
138
+
139
+ - End each terrain on the word "texture": `1). deep ocean water texture 2).
140
+ plain smooth sand texture`. Without it, Pro sometimes scatters rocks,
141
+ shells, or plants over the sand.
142
+ - Keep terrain prompts short and put style words in the style's
143
+ `promptPrefix` or `promptSuffix`. Color, season, and outline words
144
+ ("autumn", "frosty", "bold black outlines") change a set more than mood
145
+ words do.
146
+ - On Pro, `terrainTransitionSize` is wall height. 0 is flat ground, 0.25 a
147
+ low bank, and 0.5 or 1 a full wall in a 25-tile set.
148
+ - `terrainRaggedness` roughens the border; 0.8 gives a marsh edge.
149
+ `terrainSpreadX` and `terrainSlopeSize` no longer change anything, because
150
+ PixelLab's Pro pipeline stopped reading them.
151
+ - For clean 45° paths and coastlines, set `terrainConnectDiagonals: true`
152
+ and `terrainRoundness: 2`. That is the video's "Connect diagonal corners"
153
+ checkbox with roundness at 45°.
154
+ - To paint ocean, sand, and grass on one map, chain sets with `connect`:
155
+ the sand-to-grass set's lower terrain is the ocean-to-sand set's upper.
156
+ Every pair of terrains that touch needs its own set, or they meet with a
157
+ hard edge.
158
+ - `terrainOrientation: "sidescroller"` makes platform sets: `1). mossy stone
159
+ bricks texture 2). green grass texture`. The video's Pro sidescroller, at
160
+ 64px with a taller top layer, is only in PixelLab's web app.
161
+
162
+ ### Animated effects
163
+
164
+ [How to Make Animated Pixel Art VFX in PixelLab](https://www.youtube.com/watch?v=t8FIMv-8QpI)
165
+ generates effects instead of rendering them. The `vfx` generator is free and
166
+ renders the same pixels every time, so try it first. Generate when the
167
+ effect is a drawn thing or a character's own motion, like a water hammer
168
+ that bursts into a splash or a sword that turns into lightning.
169
+
170
+ 1. Draw a sheet of effects with one `imagePro` call. List one effect per
171
+ frame in the prompt; a 64×64 canvas returns 16 candidates to pick from.
172
+ 2. Animate the pick with an `animate-pixminimax` revision. Describe the
173
+ motion, not the look, and ask a loop to return to its first state.
174
+ 3. Pin an ending with `lastFrame` when the motion should land somewhere. An
175
+ ice crystal can grow from a few blue pixels, or a `"engine": "pro-flash"`
176
+ edit of the same sprite can be the ending it transforms into.
177
+ 4. Clean up. `driftThreshold` or a `reduce-colors` revision fixes
178
+ frame-to-frame color flicker, and `correct-pixelart` or `pixelkiln edit`
179
+ removes stray pixels. Check whether a loop's last frame repeats its
180
+ first.
181
+
182
+ Pad a growing effect onto a larger canvas before animating it, since a
183
+ revision animates its parent at the parent's own size. Long PixMiniMax clips
184
+ can also cost more than `plan` says: PixelLab prices a 40-frame 64×64 clip
185
+ at 6 generations, and PixelKiln estimates 3. Set `--budget` with that gap in
186
+ mind.
187
+
103
188
  ## Account workflows
104
189
 
105
190
  The PixelLab adapter supports `balance`, `adopt`, `salvage`, `tag`, and the
@@ -183,14 +268,15 @@ inpainting, whole-image editing, and skeleton-driven animation (posing a
183
268
  reference image frame-by-frame from a supplied keypoint skeleton, not a text
184
269
  description) are the `revision` asset shape, not the `character` generator;
185
270
  see [Controlled asset revisions](./REVISIONS.md). The same revision shape
186
- animates, interpolates, recolors, and cleans up any asset, a whole character
187
- or loop at once where the endpoint takes a set; `pixelkiln estimate-skeleton`
271
+ animates, interpolates, recolors, cleans up, and makes normal maps for any
272
+ asset, a whole character or loop at once where the endpoint takes a set; `pixelkiln estimate-skeleton`
188
273
  starts a skeleton file from an image. Pro Flash stills are the
189
274
  `imageProFlash` generator, and Pro Flash edit and inpaint are a revision's
190
275
  `"engine": "pro-flash"`. Object Creator is the
191
276
  `objectPro` generator, UI panels and elements are `uiAsset` and `uiElement`,
192
- and fonts and unzooming reference art are the standalone `pixelkiln font` and
193
- `pixelkiln unzoom` commands. Map Workshop
277
+ and fonts, unzooming reference art, and normal maps for loose files are the
278
+ standalone `pixelkiln font`, `pixelkiln unzoom`, and `pixelkiln normal-map`
279
+ commands. Map Workshop
194
280
  scene composition (placing objects and characters into a map, in-scene
195
281
  inpainting, export) is a separate PixelLab product surface this adapter does
196
282
  not model at all — including PixelKiln's own `map` generator, which is
package/docs/REVISIONS.md CHANGED
@@ -7,8 +7,9 @@ dependencies before submission, and records the lineage in the lockfile.
7
7
 
8
8
  The manifest and pipeline are provider-neutral. ComfyUI, PixelLab and Scenario implement
9
9
  it; PixelLab covers `image-to-image`, `inpaint`, `reduce-colors`,
10
- `correct-pixelart`, `remove-background`, `animate`, `animate-pixminimax`,
11
- `animate-skeleton`, `interpolate`, and `edit-animation`, not `outpaint` (its API has no
10
+ `correct-pixelart`, `remove-background`, `normal-map`, `animate`,
11
+ `animate-pixminimax`, `animate-skeleton`, `interpolate`, and `edit-animation`,
12
+ not `outpaint` (its API has no
12
13
  canvas-expansion endpoint). ComfyUI covers every mode generically except the
13
14
  five frame-set modes (`animate`, `animate-pixminimax`, `animate-skeleton`,
14
15
  `interpolate`, `edit-animation`), which need an ordered frame set its
@@ -57,9 +58,11 @@ input to the provider workflow, not a cross-model quality guarantee.
57
58
  committed asset's drawer and use "+ New revision" under "Revisions from this
58
59
  asset" to create a child of it. On a PixelLab sprite the mode picker offers
59
60
  `image-to-image`, `inpaint`, `animate`, `animate-pixminimax`, `interpolate`,
60
- `reduce-colors`, `correct-pixelart`, and `remove-background`; on a PixelLab
61
- frame set (or a character's directions) it offers `edit-animation`,
62
- `reduce-colors`, and `correct-pixelart`, which take the whole set. ComfyUI
61
+ `reduce-colors`, `correct-pixelart`, `remove-background`, and `normal-map`;
62
+ on a PixelLab frame set (or a character's directions) it offers
63
+ `edit-animation`, `reduce-colors`, and `correct-pixelart`, which take the whole
64
+ set, plus `normal-map` on an animation loop. `normal-map` is hidden in a style
65
+ that sets `enforcePalette` or `quality`. ComfyUI
63
66
  sprites get `image-to-image` and `inpaint`; other providers get
64
67
  `image-to-image`. The form asks only for the new asset id, the instruction or
65
68
  motion, and the mode's own options (strength, frames, fps, colours,
@@ -233,6 +236,59 @@ generation.
233
236
  or `complex` (slower, for detailed edges). `description` is an optional hint
234
237
  naming the foreground. Both are rejected on other modes, as is `strength`.
235
238
 
239
+ ### Normal maps
240
+
241
+ `normal-map` calls PixelLab's `/normal-map` and returns the parent's normal
242
+ map, so a game engine can light the sprite. The map is the parent's size: RGB
243
+ is the way each pixel faces, and alpha is 255 where the sprite shows and 0
244
+ elsewhere. It is a background job, and costs 0.5 generation per call,
245
+ charged only when the map is delivered (PixelLab's documented price; not yet
246
+ measured here).
247
+
248
+ ```jsonc
249
+ {
250
+ "styles": {
251
+ "lit": { "generator": "map", "outDir": "art/normals" }
252
+ },
253
+ "assets": {
254
+ "hero-walk-east-normals": {
255
+ "prompt": "normal map",
256
+ "styles": ["lit"],
257
+ "revision": { "mode": "normal-map", "from": "hero-walk-east", "fromStyle": "chars", "convention": "opengl" }
258
+ }
259
+ }
260
+ }
261
+ ```
262
+
263
+ - `convention` is `opengl` (PixelLab's default: green up, for Godot, Unity,
264
+ and Phaser) or `directx` (green down, for Unreal). It is rejected on other
265
+ modes and enters the spec hash only when set. `strength` is refused.
266
+ - The parent must be a PNG, 8 to 512 pixels per side; both are checked at
267
+ plan time.
268
+ - **A loop goes as one strip.** When the parent is an animation (its
269
+ `-frame-NN.png` members), every frame is laid left to right in one image
270
+ and sent with `frames: N`, up to 32. PixelLab shapes the first frame and
271
+ carries it to the rest, so the light holds steady across the loop instead
272
+ of flickering. The returned strip is cut back into `-frame-NN.png` files
273
+ under the parent's roles, keeping its playback rate. A whole loop is one
274
+ call, so it costs 0.5 too.
275
+ - **A character's directions are refused.** They are separate views, not
276
+ frames of one motion: sent as a strip, each would be shaped from the first
277
+ direction, and one call per direction would put several paid jobs behind
278
+ one lock entry with no way to recover half of them. Make one `normal-map`
279
+ revision per direction, each from an asset whose `source` is that
280
+ direction's file.
281
+ - **A normal map is lighting data, not art.** Its colours are directions, so
282
+ palette snapping or the quality gate's grid repair would wreck it. A
283
+ `normal-map` revision in a style that sets `enforcePalette` or `quality` is
284
+ refused at plan time; put it in a style without either (as `lit` above) and
285
+ name the parent's style with `fromStyle`. A `mirror` of a normal map is
286
+ refused too: flipping the pixels leaves every red channel pointing the old
287
+ way.
288
+
289
+ For a loose file outside the manifest, `pixelkiln normal-map` does the same
290
+ job (see [CLI](./CLI.md#normal-map)).
291
+
236
292
  ### Revising a whole set at once
237
293
 
238
294
  Both modes also take a parent that is a **set** rather than one image: a
@@ -272,6 +328,8 @@ its playback rate.
272
328
  rather than being sent as if it belonged.
273
329
  - Members must all be the same size. `reduce-colors`' 512×512 limit is for the
274
330
  whole call: sixteen 64×64 frames fit, five 256×256 do not.
331
+ - `normal-map` takes an animation loop as one strip but refuses a set of
332
+ directions (see [Normal maps](#normal-maps)).
275
333
  - Every other mode except `edit-animation` (below) reads exactly one image and
276
334
  refuses a set parent at plan time, naming the modes that take one.
277
335
 
@@ -660,6 +718,13 @@ further — there is nothing to ask.
660
718
  CLI-only-and-never-in-the-submission-path decision. Same unverified-live
661
719
  caveat as `animate`/`animate-pixminimax`, sourced from the live
662
720
  `animate_with_skeleton_v3` MCP tool schema rather than an observed call.
721
+ - `normal-map` calls `/normal-map` (PixelLab 0.4.130), a background job whose
722
+ map is `last_response.image`; a loop's frames go and come back as one
723
+ horizontal strip, cut into per-frame files on poll. See
724
+ [Normal maps](#normal-maps). Measured once through `pixelkiln normal-map`:
725
+ an 8-frame strip billed exactly 0.5 generations and came back the same
726
+ size with matching alpha (docs/ENDPOINTS.md). The revision mode shares
727
+ that request but has not run live itself.
663
728
 
664
729
  - The mask convention is fixed, not graph-defined like ComfyUI's: white marks
665
730
  the area to generate, black the area to preserve. There is no way to flip it.
package/docs/TILES.md CHANGED
@@ -37,9 +37,10 @@ renumbered by array position.
37
37
 
38
38
  ### The `terrain` generator's shape
39
39
 
40
- `terrain` (`/create-tileset`, [`docs/GENERATORS.md`](GENERATORS.md)) is a
41
- different PixelLab endpoint from `tiles`' `tileFeature: "tileset"` above, and
42
- its response carries no `tile_rules` bitmask at all. Instead each tile names
40
+ `terrain` (`/create-tileset`, or `/create-tileset-sidescroller` for a
41
+ sidescroller set; [`docs/GENERATORS.md`](GENERATORS.md)) is a different
42
+ PixelLab endpoint from `tiles`' `tileFeature: "tileset"` above, and its
43
+ response carries no `tile_rules` bitmask at all. Instead each tile names
43
44
  which terrain occupies its four corners directly:
44
45
 
45
46
  ```jsonc
@@ -50,12 +51,21 @@ which terrain occupies its four corners directly:
50
51
  "terrainTiles": [
51
52
  { "role": "tile-00-none", "corners": { "NW": "upper", "NE": "upper", "SW": "upper", "SE": "upper" } },
52
53
  { "role": "tile-01-nw-ne-sw-se", "corners": { "NW": "lower", "NE": "lower", "SW": "lower", "SE": "lower" } }
53
- ]
54
+ ],
55
+ // Each terrain's base tile id; a connected set sends one of these.
56
+ "terrainIds": { "lower": "<uuid>", "upper": "<uuid>" }
54
57
  }
55
58
  }
56
59
  }
57
60
  ```
58
61
 
62
+ A sidescroller set names its terrains `["central", "background"]` while its
63
+ corners still say `lower` (the platform) and `upper` (empty air; the
64
+ all-`upper` tile is blank). PixelKiln records the corner vocabulary,
65
+ `["lower", "upper"]`, as `terrainTypes` so masks match, and keeps
66
+ PixelLab's names as `providerTerrainTypes` beside `view: "side"`. In Tiled
67
+ and Godot the platform is terrain 0.
68
+
59
69
  `normalizeTerrainTiles()` (`src/pipeline/tileset-export.ts`) turns this into
60
70
  the same `NormalizedTileRules` shape `tileRules` would have produced directly:
61
71
  `ruleType: "corner"`, `arity: 4`, `terrains` from `terrainTypes`, and a mask
@@ -70,9 +80,15 @@ role — correct here because `terrainTiles` and the output list are pushed in
70
80
  the same loop, but worth knowing if either is ever reordered independently.
71
81
 
72
82
  A tile whose corner is `"transition"` (the extra ring PixelLab adds at
73
- `terrainTransitionSize: 1`) has no bit of its own in a two-terrain corner
83
+ `terrainTransitionSize: 1`, or 0.5 on Pro) has no bit of its own in a two-terrain corner
74
84
  mask; it is folded into whichever of `terrains[0]`/`terrains[1]` it isn't.
75
85
 
86
+ That 25-tile layout covers 21 distinct corner combinations. Four
87
+ wall-continuation tiles share their corners with a twin and differ only in
88
+ `pattern_4x4`, which PixelLab says is the field to match on. PixelKiln
89
+ stores each tile's `pattern4x4` but builds masks from `corners`, so each
90
+ twin pair gets the same mask.
91
+
76
92
  ## Command
77
93
 
78
94
  ```bash
@@ -205,7 +221,15 @@ isometric-corner-names bug; the counts alone did not.
205
221
  placement semantics would have to be invented.
206
222
  - A `terrain` asset's `"transition"` corners collapse into a two-color mask
207
223
  (see above); the cliff-tier 25-tile set exports, but its middle transition
208
- ring is not distinguished from the two named terrains in Tiled/Godot.
224
+ ring is not distinguished from the two named terrains in Tiled/Godot, and
225
+ its four wall-continuation twins export with duplicate masks.
226
+ - A `terrain` set exports alone. A connected set (`connect` in the
227
+ manifest, `lower_base_tile_id`/`upper_base_tile_id` in the API) shares a
228
+ terrain with another set, the way PixelLab's
229
+ [Pro tilesets guide](https://www.youtube.com/watch?v=MbkqpDUFkEg) paints
230
+ ocean, sand, grass, path, and cliffs on one map, but each set still
231
+ exports as its own two-terrain Tiled Wang set or Godot terrain set.
232
+ PixelKiln does not merge connected sets into one engine terrain set yet.
209
233
  - Godot edge/side masks on an isometric or oblique tile remain generic- or
210
234
  Tiled-only; see Godot 4 above.
211
235
  - Export never changes source PNGs or the lockfile.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pixelkiln",
3
- "version": "0.88.0",
3
+ "version": "0.89.0",
4
4
  "description": "Manifest-driven pixel-art generation, review, recovery, and packaging with deterministic provenance.",
5
5
  "type": "module",
6
6
  "sideEffects": false,
@@ -234,6 +234,28 @@
234
234
  "minimum": 0,
235
235
  "maximum": 1
236
236
  },
237
+ "terrainRoundness": {
238
+ "type": "number",
239
+ "minimum": 0,
240
+ "maximum": 2
241
+ },
242
+ "terrainBoundaryAmplitude": {
243
+ "type": "number",
244
+ "minimum": 0,
245
+ "maximum": 0.3
246
+ },
247
+ "terrainBoundarySeed": {
248
+ "type": "integer",
249
+ "minimum": 0
250
+ },
251
+ "terrainStepSlope": {
252
+ "type": "number",
253
+ "minimum": 0,
254
+ "maximum": 2
255
+ },
256
+ "terrainConnectDiagonals": {
257
+ "type": "boolean"
258
+ },
237
259
  "terrainTransitionSize": {
238
260
  "type": "number",
239
261
  "minimum": 0,
@@ -246,6 +268,13 @@
246
268
  "high top-down"
247
269
  ]
248
270
  },
271
+ "terrainOrientation": {
272
+ "type": "string",
273
+ "enum": [
274
+ "top-down",
275
+ "sidescroller"
276
+ ]
277
+ },
249
278
  "isometricTileSize": {
250
279
  "type": "number",
251
280
  "enum": [
@@ -383,6 +412,16 @@
383
412
  },
384
413
  "default": []
385
414
  },
415
+ "paletteName": {
416
+ "type": "string",
417
+ "minLength": 1,
418
+ "maxLength": 100
419
+ },
420
+ "maxColors": {
421
+ "type": "integer",
422
+ "minimum": 2,
423
+ "maximum": 64
424
+ },
386
425
  "enforcePalette": {
387
426
  "type": "boolean",
388
427
  "default": false
@@ -693,6 +732,28 @@
693
732
  "minimum": 0,
694
733
  "maximum": 1
695
734
  },
735
+ "terrainRoundness": {
736
+ "type": "number",
737
+ "minimum": 0,
738
+ "maximum": 2
739
+ },
740
+ "terrainBoundaryAmplitude": {
741
+ "type": "number",
742
+ "minimum": 0,
743
+ "maximum": 0.3
744
+ },
745
+ "terrainBoundarySeed": {
746
+ "type": "integer",
747
+ "minimum": 0
748
+ },
749
+ "terrainStepSlope": {
750
+ "type": "number",
751
+ "minimum": 0,
752
+ "maximum": 2
753
+ },
754
+ "terrainConnectDiagonals": {
755
+ "type": "boolean"
756
+ },
696
757
  "terrainTransitionSize": {
697
758
  "type": "number",
698
759
  "minimum": 0,
@@ -705,6 +766,13 @@
705
766
  "high top-down"
706
767
  ]
707
768
  },
769
+ "terrainOrientation": {
770
+ "type": "string",
771
+ "enum": [
772
+ "top-down",
773
+ "sidescroller"
774
+ ]
775
+ },
708
776
  "isometricTileSize": {
709
777
  "type": "number",
710
778
  "enum": [
@@ -842,6 +910,16 @@
842
910
  },
843
911
  "default": []
844
912
  },
913
+ "paletteName": {
914
+ "type": "string",
915
+ "minLength": 1,
916
+ "maxLength": 100
917
+ },
918
+ "maxColors": {
919
+ "type": "integer",
920
+ "minimum": 2,
921
+ "maximum": 64
922
+ },
845
923
  "enforcePalette": {
846
924
  "type": "boolean",
847
925
  "default": false
@@ -1017,7 +1095,8 @@
1017
1095
  "animate-pixminimax",
1018
1096
  "animate-skeleton",
1019
1097
  "interpolate",
1020
- "edit-animation"
1098
+ "edit-animation",
1099
+ "normal-map"
1021
1100
  ]
1022
1101
  },
1023
1102
  "from": {
@@ -1119,6 +1198,13 @@
1119
1198
  "complex"
1120
1199
  ]
1121
1200
  },
1201
+ "convention": {
1202
+ "type": "string",
1203
+ "enum": [
1204
+ "opengl",
1205
+ "directx"
1206
+ ]
1207
+ },
1122
1208
  "description": {
1123
1209
  "type": "string",
1124
1210
  "minLength": 1
@@ -1585,6 +1671,66 @@
1585
1671
  "name": {
1586
1672
  "type": "string",
1587
1673
  "minLength": 1
1674
+ },
1675
+ "description": {
1676
+ "type": "string",
1677
+ "minLength": 1,
1678
+ "maxLength": 8000
1679
+ },
1680
+ "artist": {
1681
+ "type": "string",
1682
+ "enum": [
1683
+ "lite",
1684
+ "pro"
1685
+ ]
1686
+ }
1687
+ },
1688
+ "additionalProperties": false
1689
+ },
1690
+ "connect": {
1691
+ "type": "object",
1692
+ "properties": {
1693
+ "lower": {
1694
+ "type": "object",
1695
+ "properties": {
1696
+ "of": {
1697
+ "type": "string",
1698
+ "minLength": 1
1699
+ },
1700
+ "terrain": {
1701
+ "type": "string",
1702
+ "enum": [
1703
+ "lower",
1704
+ "upper"
1705
+ ]
1706
+ }
1707
+ },
1708
+ "required": [
1709
+ "of",
1710
+ "terrain"
1711
+ ],
1712
+ "additionalProperties": false
1713
+ },
1714
+ "upper": {
1715
+ "type": "object",
1716
+ "properties": {
1717
+ "of": {
1718
+ "type": "string",
1719
+ "minLength": 1
1720
+ },
1721
+ "terrain": {
1722
+ "type": "string",
1723
+ "enum": [
1724
+ "lower",
1725
+ "upper"
1726
+ ]
1727
+ }
1728
+ },
1729
+ "required": [
1730
+ "of",
1731
+ "terrain"
1732
+ ],
1733
+ "additionalProperties": false
1588
1734
  }
1589
1735
  },
1590
1736
  "additionalProperties": false
@@ -309,6 +309,28 @@
309
309
  "minimum": 0,
310
310
  "maximum": 1
311
311
  },
312
+ "terrainRoundness": {
313
+ "type": "number",
314
+ "minimum": 0,
315
+ "maximum": 2
316
+ },
317
+ "terrainBoundaryAmplitude": {
318
+ "type": "number",
319
+ "minimum": 0,
320
+ "maximum": 0.3
321
+ },
322
+ "terrainBoundarySeed": {
323
+ "type": "integer",
324
+ "minimum": 0
325
+ },
326
+ "terrainStepSlope": {
327
+ "type": "number",
328
+ "minimum": 0,
329
+ "maximum": 2
330
+ },
331
+ "terrainConnectDiagonals": {
332
+ "type": "boolean"
333
+ },
312
334
  "terrainTransitionSize": {
313
335
  "type": "number",
314
336
  "minimum": 0,
@@ -321,6 +343,13 @@
321
343
  "high top-down"
322
344
  ]
323
345
  },
346
+ "terrainOrientation": {
347
+ "type": "string",
348
+ "enum": [
349
+ "top-down",
350
+ "sidescroller"
351
+ ]
352
+ },
324
353
  "isometricTileSize": {
325
354
  "type": "number",
326
355
  "enum": [
@@ -458,6 +487,16 @@
458
487
  },
459
488
  "default": []
460
489
  },
490
+ "paletteName": {
491
+ "type": "string",
492
+ "minLength": 1,
493
+ "maxLength": 100
494
+ },
495
+ "maxColors": {
496
+ "type": "integer",
497
+ "minimum": 2,
498
+ "maximum": 64
499
+ },
461
500
  "enforcePalette": {
462
501
  "type": "boolean",
463
502
  "default": false
@@ -119,7 +119,7 @@ Read only the reference needed for the current decision:
119
119
 
120
120
  - For PixelLab configuration, generators (including `uiElement` for single UI
121
121
  pieces, `imageProFlash` for styled stills, and `vfx` for animated effects), costs, alpha behavior,
122
- account operations, or the `unzoom`, `pixelate`, `vfx`, `font`, `estimate-skeleton`, and
122
+ account operations, or the `unzoom`, `pixelate`, `normal-map`, `vfx`, `font`, `estimate-skeleton`, and
123
123
  `skeleton-preview` utilities, read [references/pixellab.md](references/pixellab.md). For a
124
124
  PixelLab style aimed at a specific resolution or fidelity tier (retro,
125
125
  high-detail, or matching an existing set's look), read