Stack recipes

A stack is a whole character card, the NFT people bought. An element is one transparent layer of it. A stack recipe lists exactly which elements a card uses, in which order and with which colour changes. With recipes, bWalletX can melt an NFT into one card per element, and the Forge can rebuild it exactly.

Ninja Punk Girls Series 2 is the reference collection: 3,334 recipes, downloadable as one file: s2/v2/recipes.json (3.3 MB, { "recipes": { "0009": { … } } }). Any collection with layered art can publish recipes in this format.

Files

<collection>/
  collection.json        canvas size, element list, how to identify minted NFTs
  recipes/NNNN.json      one per card, NNNN = card number
  elements/<file>.png    the layers

Every element is a full-card transparent image in register: drawn at 0,0, it lands exactly where it belongs. Stacking the layers in order is the card. Elements are never cropped, scaled or moved.

A recipe

{
  "n": 9,
  "name": "Naora",
  "team": "Ueno Octos",
  "scene":  ["ZZ_005_.png", "001_003_Graded_Dirt.png", "W_007_[Banner]<3>{x}.png"],
  "girl":   ["U_005_[Weapon]<Rocket_Launcher>.png", "T_018_[Hair]<Spotty_Bunches>((RGB)){x}.png"],
  "emblem": "00_006_{x}DICE2.png",
  "hues":   { "T_018_[Hair]<Spotty_Bunches>((RGB)){x}.png": -102.0 },
  "stats":  { "strength": 5, "speed": 5, "skill": 5, "stamina": 12, "stealth": 7, "style": 4 }
}

field	meaning
scene	background, dirt, banner, decals, back to front
girl	the character’s layers, back to front. These become element cards when melted
emblem	team emblem
hues	colour spin in degrees for a layer; missing or 0 means none
stats	card stats (NPG Series 2 names the last one sexiness; new issues use style)

scene and girl are separate so a character can be cut out on her own (transparent) for games, avatars and wallet cards.

Build the card

1. Empty canvas (NPG: 961 × 1441).
2. Draw each scene file, then each girl file, at 0,0, full size.
3. Spin a layer’s colour by hues[file] first.
4. Draw the frame: interface, logo, number, name, stats.

Colour spin: convert RGB to HSV with hue on a 0–255 scale (as Python’s PIL does), add round(deg / 360 × 255) to the hue (wrapping at 256), convert back. Saturation, brightness and transparency don’t change.

Melting

Melting a stack NFT gives its owner one element card per girl layer, each with its spin. The stack is burned or locked in a way the server can check, so it can’t be melted twice. New stacks are made from element cards in the Forge.

Status

• ✓ Format written (draft v1)
• ✓ NPG Series 2: all 3,334 recipes, rebuilt cards match the minted ones to about 3–6 levels out of 255
• ✓ NPG Series 2 recipes published for download
• ◻ Melting NPG stacks into element cards (Series 1 cards melt into the redrawn Series 1 element set)
• ◻ Recipes for other collections

Related: Identifying RelayX NFTs maps each minted NFT to its card number.