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/README.md +1 -1
- package/dist/cli.js +2017 -782
- package/dist/cli.js.map +1 -1
- package/dist/client/gallery.js +18 -7
- package/dist/index.cjs +1740 -588
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +2239 -359
- package/dist/index.d.ts +2239 -359
- package/dist/index.js +1629 -503
- package/dist/index.js.map +1 -1
- package/docs/CLI.md +77 -5
- package/docs/ENDPOINTS.md +132 -9
- package/docs/GENERATORS.md +88 -6
- package/docs/MANIFEST.md +27 -6
- package/docs/PIXELLAB.md +93 -7
- package/docs/REVISIONS.md +70 -5
- package/docs/TILES.md +30 -6
- package/package.json +1 -1
- package/schema/manifest.schema.json +147 -1
- package/schema/recipe.schema.json +39 -0
- package/skills/pixelkiln/SKILL.md +1 -1
- package/skills/pixelkiln/references/pixellab-roadmap.md +138 -12
- package/skills/pixelkiln/references/pixellab.md +117 -26
- package/skills/pixelkiln/references/revisions.md +14 -2
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) |
|
|
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 (
|
|
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,
|
|
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
|
|
193
|
-
`pixelkiln
|
|
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`, `
|
|
11
|
-
`animate-skeleton`, `interpolate`, and `edit-animation`,
|
|
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`,
|
|
61
|
-
frame set (or a character's directions) it offers
|
|
62
|
-
`reduce-colors`, and `correct-pixelart`, which take the whole
|
|
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`,
|
|
41
|
-
|
|
42
|
-
|
|
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
|
|
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
|
@@ -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
|