From ee78b0ea5c8244efa2da6848d6013fcb25383472 Mon Sep 17 00:00:00 2001
From: bruceballad <bruceballad@gmail.com>
Date: Sun, 24 Oct 2021 12:00:44 +0200
Subject: [PATCH 01/12] resetNameIndex fix

[Fix] There is a small bug with resetNameIndex functionality that breaks the numbers when it is used after the second layer config set. Changing the "+=" to "=" at the line 556 seems to fix it.
---
 src/main.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/main.js b/src/main.js
index 34a7b2b20..aa6379ab2 100644
--- a/src/main.js
+++ b/src/main.js
@@ -553,7 +553,7 @@ const startCreating = async () => {
           if (layerConfigurations[layerConfigIndex].resetNameIndex) {
             _offset = layerConfigurations.reduce((acc, layer, index) => {
               if (index < layerConfigIndex) {
-                acc += layer.growEditionSizeTo;
+                acc = layer.growEditionSizeTo;
                 return acc;
               }
               return acc;

From 86fa0c0c6c1cdd63a828facf291093cf6f78bdbe Mon Sep 17 00:00:00 2001
From: bruceballad <bruceballad@gmail.com>
Date: Sun, 24 Oct 2021 12:18:29 +0200
Subject: [PATCH 02/12] Improvements

- [Added] The ability to add a suffix after the number in the edition name. Now, if there is a suffix, 'resetNameIndex=true' option adds the sub-index counter number after the suffix. So, you can form names like; "PREFIX #10 - SUFFIX #2". (If there is no suffix set, resetNameIndex works as originally intended)
- [Added] The ability to set custom descriptions for each layer config set.
- [Added] The ability to prepend custom descriptions for each layer config set. So, you can form unique descriptions like; "Item #10 is an art piece from Collection X".
- [Added] External_url config for OpenSea.
- [Added] Some sample extraAttributes to be used as templates based on OpenSea metadata-standards.
---
 src/main.js | 49 ++++++++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 44 insertions(+), 5 deletions(-)

diff --git a/src/main.js b/src/main.js
index aa6379ab2..3adb62d67 100644
--- a/src/main.js
+++ b/src/main.js
@@ -18,6 +18,7 @@ const {
   layersDir,
   format,
   baseUri,
+  baseExternalUrl,
   description,
   background,
   uniqueDnaTorrance,
@@ -91,7 +92,7 @@ const getElements = (path, layer) => {
       const extension = /\.[0-9a-zA-Z]+$/;
       const sublayer = !extension.test(i);
       const weight = getRarityWeight(i);
-
+    
       const blendMode = layer.blend != undefined ? layer.blend : "source-over";
       const opacity = layer.opacity != undefined ? layer.opacity : 1;
 
@@ -186,8 +187,15 @@ const drawBackground = () => {
 
 const addMetadata = (_dna, _edition, _prefixData) => {
   let dateTime = Date.now();
-  const { _prefix, _offset, _imageHash } = _prefixData;
-
+  const { 
+    _descriptionOverwrite,
+    _prependNameInDescription,
+    _prefix, 
+    _offset, 
+    _suffix,
+    _imageHash 
+  } = _prefixData;
+  
   const combinedAttrs = [...attributesList, ...extraAttributes()];
   const cleanedAttrs = combinedAttrs.reduce((acc, current) => {
     const x = acc.find((item) => item.trait_type === current.trait_type);
@@ -200,9 +208,18 @@ const addMetadata = (_dna, _edition, _prefixData) => {
 
   let tempMetadata = {
     dna: hash(_dna),
-    name: `${_prefix ? _prefix + " " : ""}#${_edition - _offset}`,
-    description: description,
+    
+    // New name builder. It can form names like; "PREFIX #10 - SUFFIX #2". - BB
+    name: `${_prefix ? _prefix + " " : ""}#${_suffix ? _edition : _edition - _offset}${_suffix ? " " + _suffix + (_offset>0 ? " #" + (_edition - _offset) : "") : ""}`, 
+    
+    // new description builder, it can prepends the asset name, AND overwrite the description for different layerConfigs. Can form unique descriptions like; "Item #10 is an art piece from Collection X". - BB
+    description: `${_prependNameInDescription ? `${_prefix ? _prefix + " " : ""}#${_suffix ? _edition : _edition - _offset}${_suffix ? " " + _suffix + (_offset>0 ? " #" + (_edition - _offset) : "") : ""}` : ""}${_descriptionOverwrite ? _descriptionOverwrite : description}`, 
+
+    // Adds external_url if the baseExternalUrl in config is not empty, combines it with edition numbers. - BB
+    ...(baseExternalUrl !== "" && { external_url: `${baseExternalUrl}${_edition}` }), 
+
     image: `${baseUri}/${_edition}${outputJPEG ? ".jpg" : ".png"}`,
+    
     ...(hashImages === true && { imageHash: _imageHash }),
     edition: _edition,
     date: dateTime,
@@ -542,11 +559,22 @@ const startCreating = async () => {
             }`
           );
           const _imageHash = hash(savedFile);
+
+          // if there's a descriptionOverwrite for the current layerConfig, then
+          // use that description in the assets - BB
+          const _descriptionOverwrite = layerConfigurations[layerConfigIndex].descriptionOverwrite
+            ? layerConfigurations[layerConfigIndex].descriptionOverwrite
+            : null;
+
+          // prependNameInDescription - BB
+          const _prependNameInDescription = layerConfigurations[layerConfigIndex].prependNameInDescription;
+
           // if there's a prefix for the current configIndex, then
           // start count back at 1 for the name, only.
           const _prefix = layerConfigurations[layerConfigIndex].namePrefix
             ? layerConfigurations[layerConfigIndex].namePrefix
             : null;
+
           // if resetNameIndex is turned on, calculate the offset and send it
           // with the prefix
           let _offset = 0;
@@ -559,9 +587,20 @@ const startCreating = async () => {
               return acc;
             }, 0);
           }
+
+          // if there's a suffix for the current configIndex, then
+          // add it after the counter number
+          // if resetNameIndex is on too, the resetted counter will be added after the suffix
+          const _suffix = layerConfigurations[layerConfigIndex].nameSuffix
+            ? layerConfigurations[layerConfigIndex].nameSuffix
+            : null;
+
           addMetadata(newDna, abstractedIndexes[0], {
+            _descriptionOverwrite, // BB
+            _prependNameInDescription, // BB
             _prefix,
             _offset,
+            _suffix,
             _imageHash,
           });
 

From 89b17cff7ec130d9ec25c451629687f106a9051b Mon Sep 17 00:00:00 2001
From: bruceballad <bruceballad@gmail.com>
Date: Sun, 24 Oct 2021 12:43:10 +0200
Subject: [PATCH 03/12] Improvements part-2

- [Added] The ability to add a suffix after the number in the edition name. Now, if there is a suffix, 'resetNameIndex=true' option adds the sub-index counter number after the suffix. So, you can form names like; "PREFIX #10 - SUFFIX #2". (If there is no suffix set, resetNameIndex works as originally intended)
- [Added] The ability to set custom descriptions for each layer config set.
- [Added] The ability to prepend custom descriptions for each layer config set. So, you can form unique descriptions like; "Item #10 is an art piece from Collection X".
- [Added] External_url config for OpenSea.
- [Added] Some sample extraAttributes to be used as templates based on OpenSea metadata-standards.
---
 src/config.js | 121 ++++++++++++++++++++++++++++++++++----------------
 1 file changed, 83 insertions(+), 38 deletions(-)

diff --git a/src/config.js b/src/config.js
index 7ad09cd56..a1400637e 100644
--- a/src/config.js
+++ b/src/config.js
@@ -9,21 +9,46 @@ const buildDir = path.join(basePath, "/build");
 const layersDir = path.join(basePath, "/layers");
 
 const description =
-  "This is the description of your NFT project, remember to replace this";
+  "Default Description";
 const baseUri = "ipfs://NewUriToReplace";
 
+const baseExternalUrl = "https://test.com/collection?asset="; //Base url for extelnal link under the image on OpenSea. The edition number will be appended. Leave empty "" to remove. - BB
+
 const outputJPEG = false; // if false, the generator outputs png's
 
 // if you use an empty/transparent file, set the name here.
 const emptyLayerName = "NONE";
 
-//IF you need a provenance hash, turn this on
+//IF you need a provenance hash, turn this on 
 const hashImages = true;
 
 const layerConfigurations = [
+
   {
-    growEditionSizeTo: 11,
-    // namePrefix: "Monkey", Use to add a name to Metadata `name:`
+    growEditionSizeTo: 10,
+    descriptionOverwrite: " with Unique Description For Layer Set A", // for layerSet spesific descriptions. Here, it is written in a way to suit the names that will be prepended.
+    prependNameInDescription: true, // add/prepend asset name to the description. - BB
+    namePrefix: "Monkey",
+    resetNameIndex: true, // this will start the count at #1 for this layerconfig
+    nameSuffix: "Set A", // add a suffix after the number. if resetNameIndex is on too, put the reseted counter after the suffix - BB
+    layersOrder: [
+      { name: "Back Accessory" },
+      { name: "Head" },
+      { name: "Clothes" },
+      { name: "Eyes" },
+      { name: "Hair" },
+      { name: "Head Accessory" },
+      { name: "Shirt Accessories" },
+    ],
+  },
+  
+  {
+    growEditionSizeTo: 20,
+    descriptionOverwrite: " with Unique Description For Layer Set A", // for layerSet spesific descriptions. Here, it is written in a way to suit the names that will be prepended.
+    prependNameInDescription: true, // add/prepend asset name to the description. - BB
+    namePrefix: "Monkey",
+    resetNameIndex: true, // this will start the count at #1 for this layerconfig
+    nameSuffix: "Set B", // add a suffix after the number. if resetNameIndex is on too, put the reseted counter after the suffix - BB
     layersOrder: [
       { name: "Back Accessory" },
       { name: "Head" },
@@ -34,19 +59,10 @@ const layerConfigurations = [
       { name: "Shirt Accessories" },
     ],
   },
-  // {
-  //   growEditionSizeTo: 10,
-  //   namePrefix: "Lion",
-  //   resetNameIndex: true, // this will start the Lion count at #1 instead of #6
-  //   layersOrder: [
-  //     { name: "Background" },
-  //     { name: "Hats" },
-  //     { name: "Male Hair" },
-  //   ],
-  // },
 ];
 
-/**
+
+/** 
  * Incompatible items can be added to this object by a files cleanName
  * This works in layer order, meaning, you need to define the layer that comes
  * first as the Key, and the incompatible items that _may_ come after.
@@ -59,7 +75,8 @@ const incompatible = {
   //   White: ["rare-Pink-Pompadour"],
 };
 
-/**
+
+/** 
  * Require combinations of files when constructing DNA, this bypasses the
  * randomization and weights.
  *
@@ -68,8 +85,10 @@ const incompatible = {
  * the items in the array are "required" items that should be pulled from folders
  * further in the stack
  */
+
 const forcedCombinations = {
-  floral: ["MetallicShades", "Golden Sakura"],
+  //    Force some layers if a certain layer is used.
+  //floral: ["MetallicShades", "Golden Sakura"],
 };
 
 const shuffleLayerConfigurations = false;
@@ -86,31 +105,56 @@ const background = {
   brightness: "80%",
 };
 
-const extraMetadata = {};
+const extraMetadata = {
+  // You can add extra info for your collection here. Such as the artist name.
+  "Artist": "A person",
+};
 
 const extraAttributes = () => [
+
+  //OpenSea Trait Types for rich data = https://docs.opensea.io/docs/metadata-standards
+  //These are just examples to show dynamic uses. Delete all these if they do not fiy in your project. 
+  {
+    display_type: "boost_percentage", // Boost trait with lightning icon. Number is shown with a % sign. Circle fill by the percentage.
+    trait_type: "Health",
+    value: Math.floor(Math.random() * 100),
+  },
+  {
+    display_type: "boost_number", // Boost trait with lightning icon. Number is shown with a + sign. Circle is filled.
+    trait_type: "Energy",
+    value: Math.floor(Math.random() * 100),
+  },
+  {
+    display_type: "number", // Appears in the "Stats" area with a large number. "Out of X" value is taken from the collection.
+    trait_type: "Mana",
+    value: Math.floor(Math.random() * 100),
+  },
+  {
+    //Integer value with no display_type set makes the trait appear in the "Rankings" area with a progress bar. Max value is taken from the collection.
+    trait_type: "Rank", 
+    value: Math.floor(Math.random() * 100),
+  },
+
+  {
+    //display_type date makes a date section appear in the right column near "Rankings" and "Stats."
+    display_type: "date", 
+    trait_type: "Birthday", 
+
+    // Give a random date between;
+	  // Unix Timestamp 1609455600 (GMT Thu Dec 31 2020 23:00:00 GMT+0000) and
+	  // Unix Timestamp 631148400 (GMT Sun Dec 31 1989 23:00:00 GMT+0000)
+	  value: (Math.floor( Math.random() * (1609455634 - 631148434) ) + 631148434)
+  },
+
+  {
+    //String value with no display_type set makes the trait appear in the "Properties" area like layers.
+    trait_type: "Familly",
+    value: `Familly #${ Math.floor(Math.random() * (6 - 1 + 1) ) + 1 }`, // Math.floor(Math.random() * (max - min + 1) ) + min; // min max included
+  }
+
   // Optionally, if you need to overwrite one of your layers attributes.
   // You can include the same name as the layer, here, and it will overwrite
-  //
-  // {
-  // trait_type: "Bottom lid",
-  //   value: ` Bottom lid # ${Math.random() * 100}`,
-  // },
-  // {
-  //   display_type: "boost_number",
-  //   trait_type: "Aqua Power",
-  //   value: Math.random() * 100,
-  // },
-  // {
-  //   display_type: "boost_number",
-  //   trait_type: "Health",
-  //   value: Math.random() * 100,
-  // },
-  // {
-  //   display_type: "boost_number",
-  //   trait_type: "Mana",
-  //   value: Math.floor(Math.random() * 100),
-  // },
+
 ];
 
 const rarityDelimiter = "#";
@@ -129,6 +173,7 @@ module.exports = {
   layersDir,
   format,
   baseUri,
+  baseExternalUrl,
   description,
   background,
   uniqueDnaTorrance,

From 8a78b3b289955efcd96d9b3553467386c86adf58 Mon Sep 17 00:00:00 2001
From: bruceballad <bruceballad@gmail.com>
Date: Sun, 24 Oct 2021 13:01:10 +0200
Subject: [PATCH 04/12] New removeMetadataContent utility

A new utility script to remove a top level data from metadata files. It is created by modifying removeTrait.js utility.

This utility can be used for removing unwanted top level data from json files.
You can remove a data you may not need in your project,  such as "dna" or "external_url".

Use by running the following command;
```
node utils/removeMetadataContent.js "Background"
```

or for additional logging, use with the `-d` flag
```
node utils/removeMetadataContent.js "Background" -d
```
---
 utils/removeMetadataContent.js | 80 ++++++++++++++++++++++++++++++++++
 1 file changed, 80 insertions(+)
 create mode 100644 utils/removeMetadataContent.js

diff --git a/utils/removeMetadataContent.js b/utils/removeMetadataContent.js
new file mode 100644
index 000000000..ee3617214
--- /dev/null
+++ b/utils/removeMetadataContent.js
@@ -0,0 +1,80 @@
+/* 
+---------------
+This utility can be used for removing unwanted data from json files such as "dna" or "external_url".
+Created by modifying removeTrait.js utility.
+
+Use by running the following command;
+```
+node utils/removeMetadataContent.js "Background"
+```
+
+or for additional logging, use with the `-d` flag
+```
+node utils/removeMetadataContent.js "Background" -d
+```
+
+- BB
+---------------
+*/
+
+
+"use strict";
+
+const isLocal = typeof process.pkg === "undefined";
+const basePath = isLocal ? process.cwd() : path.dirname(process.execPath);
+const fs = require("fs");
+const path = require("path");
+const { Command } = require("commander");
+const program = new Command();
+
+const chalk = require("chalk");
+const jsonDir = `${basePath}/build/json`;
+const metadataFilePath = `${basePath}/build/json/_metadata.json`;
+
+const getIndividualJsonFiles = () => {
+  return fs
+    .readdirSync(jsonDir)
+    .filter((item) => /^[0-9]{1,6}.json/g.test(item));
+};
+
+program
+  .argument("<target>")
+  .option("-d, --debug", "display some debugging")
+  .action((target, options, command) => {
+    const jsonFiles = getIndividualJsonFiles();
+    options.debug
+      ? console.log(
+          `Found ${jsonFiles.length} json files in "${jsonDir}" to process`
+        )
+      : null;
+
+    console.log(chalk.greenBright.inverse(`Removing ${target}`));
+    jsonFiles.forEach((filename) => {
+      // read the contents
+      options.debug ? console.log(`removing ${target} from ${filename}`) : null;
+      const contents = JSON.parse(fs.readFileSync(`${jsonDir}/${filename}`));
+
+      const hasTarget = contents.hasOwnProperty(target);
+
+      if (!hasTarget) {
+        console.log(chalk.yellow(`"${target}" not found in ${filename}`));
+      }
+      // remove the target from attributes
+
+      delete contents[target]
+
+      // write the file
+      fs.writeFileSync(
+        `${jsonDir}/${filename}`,
+        JSON.stringify(contents, null, 2)
+      );
+
+      options.debug
+        ? console.log(
+            hasTarget ? chalk.greenBright("Removed \n") : "…skipped \n"
+          )
+        : null;
+    });
+  });
+
+program.parse();

From 17fbecf3fe7bdbf8c7f451c0af4b4ed6aed15e70 Mon Sep 17 00:00:00 2001
From: bruceballad <bruceballad@gmail.com>
Date: Fri, 29 Oct 2021 12:58:47 +0200
Subject: [PATCH 05/12] Delete 3shadow?blend=multiply&opacity=50.png

This file name was preventing GitHub Desktop app from cloning the repo.
I know this name was experimental.
I could not try renaming it on the website too. So, I need to remove it for now.
---
 .../3shadow?blend=multiply&opacity=50.png       | Bin 33178 -> 0 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 delete mode 100644 layers/Clothes/Shirtthree#3/3shadow?blend=multiply&opacity=50.png

diff --git a/layers/Clothes/Shirtthree#3/3shadow?blend=multiply&opacity=50.png b/layers/Clothes/Shirtthree#3/3shadow?blend=multiply&opacity=50.png
deleted file mode 100644
index 88a1e2fea4a146fb2e56511d399d7c31439fb15d..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 33178
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


From f4656f6a9523b6bf6389e3830a9ee4d76302dea4 Mon Sep 17 00:00:00 2001
From: bruceballad <bruceballad@gmail.com>
Date: Fri, 29 Oct 2021 15:53:18 +0200
Subject: [PATCH 06/12] Changes based on the requests from nftchef

#config.js
-	The sample text of `const description =` property is returned to how it was previously.
-	`prependNameInDescription` property is removed as we now replace `{name}` key in the text for embeding names in the text anywhere we want, not only prepend.
-	The order of new properties added to the sample layer config groups are ordered for a better merge and easy reading.
-	Additional `extraAttributes` examples are removed.

#main.js
-	String combining in asset name and description texts are now all by the proper use of template strings.
-	The functions that asset names and descriptions are built are moved to a better place to reduce repeating codes.
-	Instead of passing `_prefix`, `_offset`, and `_suffix`, separately and using these during metadata writing, they are now being passed to metadata builder as just `_name`.
-	The check and switch for `_descriptionOverwrite` is now done before the description is passed to metadata builder as `_description`.
-	`_prependNameInDescription` propery is removed. Now names get embeded in the text with RegExp replacing the `{name}` key before passing the `_description` text to metadata.

#README.md
-	Explanations and examples for the new `suffix` and `descriptionOverwrite` properties are added. In the `# Name + Number prefix, suffix, and counter reset for configuration sets` section (the title is modified too).
-	A new section for `Remove Metadata Content` utility is added for directives on how to use this utility.

#3shadow_blend=multiply&opacity=50.png
-	This file name was preventing GitHub Desktop app from cloning the repo to a local disk. It was only removed for the cloning step. Now it is being added back to match the source.
---
 README.md                                     |  30 ++++++-
 .../3shadow_blend=multiply&opacity=50.png     | Bin 0 -> 33178 bytes
 src/config.js                                 |  77 ++++++------------
 src/main.js                                   |  43 +++++-----
 4 files changed, 74 insertions(+), 76 deletions(-)
 create mode 100644 layers/Clothes/Shirtthree#3/3shadow_blend=multiply&opacity=50.png

diff --git a/README.md b/README.md
index dc516c2e4..62055d4a3 100644
--- a/README.md
+++ b/README.md
@@ -102,9 +102,9 @@ HAIR
 
 Where the containing folder will define the traits _rarity_ and in the event that it is selected as part of the randomization, BOTH nested images will be included in the final result, in alphabetical oder–hence the 1, 2, numbering.
 
-# Name + Number prefix and reset for configuration sets
+# Name + Number prefix, suffix, and counter reset for configuration sets
 
-If you are using the generator with multiple `layerConfiguration` objects to generate different species/genders/types, it is possible to add a name prefix and a reset counter for the name, so the token names start at `1` for each type.
+If you are using the generator with multiple `layerConfiguration` objects to generate different species/genders/types, it is possible to add a name prefix and a suffix, as well as a reset counter for the names, so the token names start at `1` for each type.
 
 for example, if you are creating multiple animals, and each animal should start with `Animal #1`, but the token numbers should increment as normal, you can use the following `namePrefix` and `resetNameIndex` properties to acheive this.
 
@@ -112,6 +112,9 @@ for example, if you are creating multiple animals, and each animal should start
     growEditionSizeTo: 10,
     namePrefix: "Lion",
     resetNameIndex: true, // this will start the Lion count at #1 instead of #6
+    nameSuffix: "Set-A", // add a suffix after the number. if resetNameIndex is on too, put the reseted counter after the suffix
+    descriptionOverwrite: "Unique Description For Layer Set-A which {name} is a member of.", // LayerConfig spesific descriptions. Use {name} to embed asset names.
+    
     layersOrder: [
       { name: "Background" },
       { name: "Eyeball" },
@@ -122,6 +125,14 @@ for example, if you are creating multiple animals, and each animal should start
 
 You may choose to omit the `resetNameIndex` or set it to false if you would instead like each layer set to use the token (\_edition) number in the name–it does this by default.
 
+
+If you want each config set to have a sub group name other than the prefix, you can add it with `nameSuffix` property. And form a name like `Animal #5 Monkey`.
+If you use `resetNameIndex: true` propert together with `nameSuffix` property, you the reset counter will be added after the suffix name, and form a name like `Animal #5 - Monkey #3`.
+
+You can also set different descriptions for different layer configuration sets by using `descriptionOverwrite` property. Write a string that will overwrite the default description text only for the current layer set. 
+
+If you want you can embed the generated asset names into the description texts by writing `{name}` in the string and make each description unique. This method works for the default description text too. You can form unique descriptions such as; `Unique Description For Layer Set-A which "Animal #5 - Monkey #3" is a member of.`
+
 # Chance of "NONE" or skipping a trait
 
 If you would like any given layer or sublayer to have a chance at _rolling_ `NONE`, you can do this by adding a blank PNG to the folder, and giving it the name of `NONE` + the weight you would like to use for it's chance of being chosen–identical to any other layer.
@@ -292,6 +303,21 @@ If you would like to print additional logging, use the `-d` flag
 node utils/removeTrait.js "Background" -d
 ```
 
+# Remove Metadata Content
+
+If you need to remove an unwanted top-level data from json files such as `dna` or `external_url` you can use the `removeMetadataContent` util command.
+Note that, this utility is a bit different than `removeTrait` util, as you can delete a necessary line such as `name` or `image` too. So, use this with caution.  
+
+Use this util by running a command like the following;
+```
+node utils/removeMetadataContent.js "external_url"
+```
+
+If you would like to print additional logging, use the `-d` flag
+```
+node utils/removeMetadataContent.js "external_url" -d
+```
+
 # Randomly Insert Rare items - Replace Util
 
 If you would like to manually add 'hand drawn' or unique versions into the pool of generated items, this utility takes a source folder (of your new artwork) and inserts it into the `build` directory, assigning them to random id's.
diff --git a/layers/Clothes/Shirtthree#3/3shadow_blend=multiply&opacity=50.png b/layers/Clothes/Shirtthree#3/3shadow_blend=multiply&opacity=50.png
new file mode 100644
index 0000000000000000000000000000000000000000..88a1e2fea4a146fb2e56511d399d7c31439fb15d
GIT binary patch
literal 33178
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

literal 0
HcmV?d00001

diff --git a/src/config.js b/src/config.js
index 86a7c687c..5d03de35a 100644
--- a/src/config.js
+++ b/src/config.js
@@ -9,7 +9,7 @@ const buildDir = path.join(basePath, "/build");
 const layersDir = path.join(basePath, "/layers");
 
 const description =
-  "Default Description";
+  "This is the description of your NFT project, remember to replace this";
 const baseUri = "ipfs://NewUriToReplace";
 
 const baseExternalUrl = "https://test.com/collection?asset="; //Base url for extelnal link under the image on OpenSea. The edition number will be appended. Leave empty "" to remove. - BB
@@ -25,12 +25,11 @@ const hashImages = true;
 const layerConfigurations = [
 
   {
-    growEditionSizeTo: 10,
-    descriptionOverwrite: " with Unique Description For Layer Set A", // for layerSet spesific descriptions. Here, it is written in a way to suit the names that will be prepended.
-    prependNameInDescription: true, // add/prepend asset name to the description. - BB
+    growEditionSizeTo: 5,
     namePrefix: "Monkey",
     resetNameIndex: true, // this will start the count at #1 for this layerconfig
     nameSuffix: "Set A", // add a suffix after the number. if resetNameIndex is on too, put the reseted counter after the suffix - BB
+    descriptionOverwrite: "{name} with Unique Description For Layer Set A", // LayerConfig spesific descriptions. Use {name} to embed asset names.
     layersOrder: [
       { name: "Back Accessory" },
       { name: "Head" },
@@ -43,12 +42,12 @@ const layerConfigurations = [
   },
   
   {
-    growEditionSizeTo: 20,
-    descriptionOverwrite: " with Unique Description For Layer Set A", // for layerSet spesific descriptions. Here, it is written in a way to suit the names that will be prepended.
-    prependNameInDescription: true, // add/prepend asset name to the description. - BB
+    growEditionSizeTo: 10,
     namePrefix: "Monkey",
-    resetNameIndex: true, // this will start the count at #1 for this layerconfig
+    resetNameIndex: false, // this will start the count at #1 for this layerconfig
     nameSuffix: "Set B", // add a suffix after the number. if resetNameIndex is on too, put the reseted counter after the suffix - BB
+    descriptionOverwrite: "Description for {name} from Layer Set B", // LayerConfig spesific descriptions. Use {name} to embed asset names.
+    
     layersOrder: [
       { name: "Back Accessory" },
       { name: "Head" },
@@ -121,50 +120,28 @@ const extraMetadata = {
 };
 
 const extraAttributes = () => [
-
-  //OpenSea Trait Types for rich data = https://docs.opensea.io/docs/metadata-standards
-  //These are just examples to show dynamic uses. Delete all these if they do not fiy in your project. 
-  {
-    display_type: "boost_percentage", // Boost trait with lightning icon. Number is shown with a % sign. Circle fill by the percentage.
-    trait_type: "Health",
-    value: Math.floor(Math.random() * 100),
-  },
-  {
-    display_type: "boost_number", // Boost trait with lightning icon. Number is shown with a + sign. Circle is filled.
-    trait_type: "Energy",
-    value: Math.floor(Math.random() * 100),
-  },
-  {
-    display_type: "number", // Appears in the "Stats" area with a large number. "Out of X" value is taken from the collection.
-    trait_type: "Mana",
-    value: Math.floor(Math.random() * 100),
-  },
-  {
-    //Integer value with no display_type set makes the trait appear in the "Rankings" area with a progress bar. Max value is taken from the collection.
-    trait_type: "Rank", 
-    value: Math.floor(Math.random() * 100),
-  },
-
-  {
-    //display_type date makes a date section appear in the right column near "Rankings" and "Stats."
-    display_type: "date", 
-    trait_type: "Birthday", 
-
-    // Give a random date between;
-	  // Unix Timestamp 1609455600 (GMT Thu Dec 31 2020 23:00:00 GMT+0000) and
-	  // Unix Timestamp 631148400 (GMT Sun Dec 31 1989 23:00:00 GMT+0000)
-	  value: (Math.floor( Math.random() * (1609455634 - 631148434) ) + 631148434)
-  },
-
-  {
-    //String value with no display_type set makes the trait appear in the "Properties" area like layers.
-    trait_type: "Familly",
-    value: `Familly #${ Math.floor(Math.random() * (6 - 1 + 1) ) + 1 }`, // Math.floor(Math.random() * (max - min + 1) ) + min; // min max included
-  }
-
   // Optionally, if you need to overwrite one of your layers attributes.
   // You can include the same name as the layer, here, and it will overwrite
-
+  //
+  // {
+  // trait_type: "Bottom lid",
+  //   value: ` Bottom lid # ${Math.random() * 100}`,
+  // },
+  // {
+  //   display_type: "boost_number",
+  //   trait_type: "Aqua Power",
+  //   value: Math.random() * 100,
+  // },
+  // {
+  //   display_type: "boost_number",
+  //   trait_type: "Health",
+  //   value: Math.random() * 100,
+  // },
+  // {
+  //   display_type: "boost_number",
+  //   trait_type: "Mana",
+  //   value: Math.floor(Math.random() * 100),
+  // },
 ];
 
 const rarityDelimiter = "#";
diff --git a/src/main.js b/src/main.js
index 025d94cce..132964ca7 100644
--- a/src/main.js
+++ b/src/main.js
@@ -200,12 +200,9 @@ const drawBackground = () => {
 const addMetadata = (_dna, _edition, _prefixData) => {
   let dateTime = Date.now();
   const { 
-    _descriptionOverwrite,
-    _prependNameInDescription,
-    _prefix, 
-    _offset, 
-    _suffix,
-    _imageHash 
+    _name,
+    _description,
+    _imageHash,
   } = _prefixData;
   
   const combinedAttrs = [...attributesList, ...extraAttributes()];
@@ -221,11 +218,9 @@ const addMetadata = (_dna, _edition, _prefixData) => {
   let tempMetadata = {
     dna: hash(_dna),
     
-    // New name builder. It can form names like; "PREFIX #10 - SUFFIX #2". - BB
-    name: `${_prefix ? _prefix + " " : ""}#${_suffix ? _edition : _edition - _offset}${_suffix ? " " + _suffix + (_offset>0 ? " #" + (_edition - _offset) : "") : ""}`, 
+    name: _name, 
     
-    // new description builder, it can prepends the asset name, AND overwrite the description for different layerConfigs. Can form unique descriptions like; "Item #10 is an art piece from Collection X". - BB
-    description: `${_prependNameInDescription ? `${_prefix ? _prefix + " " : ""}#${_suffix ? _edition : _edition - _offset}${_suffix ? " " + _suffix + (_offset>0 ? " #" + (_edition - _offset) : "") : ""}` : ""}${_descriptionOverwrite ? _descriptionOverwrite : description}`, 
+    description: _description, 
 
     // Adds external_url if the baseExternalUrl in config is not empty, combines it with edition numbers. - BB
     ...(baseExternalUrl !== "" && { external_url: `${baseExternalUrl}${_edition}` }), 
@@ -586,15 +581,6 @@ const startCreating = async () => {
           );
           const _imageHash = hash(savedFile);
 
-          // if there's a descriptionOverwrite for the current layerConfig, then
-          // use that description in the assets - BB
-          const _descriptionOverwrite = layerConfigurations[layerConfigIndex].descriptionOverwrite
-            ? layerConfigurations[layerConfigIndex].descriptionOverwrite
-            : null;
-
-          // prependNameInDescription - BB
-          const _prependNameInDescription = layerConfigurations[layerConfigIndex].prependNameInDescription;
-
           // if there's a prefix for the current configIndex, then
           // start count back at 1 for the name, only.
           const _prefix = layerConfigurations[layerConfigIndex].namePrefix
@@ -621,12 +607,21 @@ const startCreating = async () => {
             ? layerConfigurations[layerConfigIndex].nameSuffix
             : null;
 
+
+          // New name builder. It can form names like; "PREFIX #10 - SUFFIX #2". - BB
+          //const _name = `${_prefix ? _prefix + " " : ""}#${_suffix ? _edition : _edition - _offset}${_suffix ? " " + _suffix + (_offset>0 ? " #" + (_edition - _offset) : "") : ""}`; 
+          const _name = `${_prefix ? `${_prefix} ` : ``}#${_suffix ? abstractedIndexes[0] : abstractedIndexes[0] - _offset}${_suffix ? ` ${_suffix}${layerConfigurations[layerConfigIndex].resetNameIndex ? ` #${abstractedIndexes[0] - _offset}` : ``}` : ``}`;
+          console.log("_offset: "+_offset);
+
+          // New description builder, it can embed the asset name, AND overwrite the description for different layerConfigs. 
+          // Can form unique descriptions like; "Item #10 is an art piece from Collection X".
+          const _description = (layerConfigurations[layerConfigIndex].descriptionOverwrite
+            ? layerConfigurations[layerConfigIndex].descriptionOverwrite
+            : description).replace(/{name}/g, _name);
+            
           addMetadata(newDna, abstractedIndexes[0], {
-            _descriptionOverwrite, // BB
-            _prependNameInDescription, // BB
-            _prefix,
-            _offset,
-            _suffix,
+            _name,
+            _description,
             _imageHash,
           });
 

From c9d4fa99d898a4e47dda36a0f6e3606fc115ecba Mon Sep 17 00:00:00 2001
From: bruceballad <bruceballad@gmail.com>
Date: Thu, 4 Nov 2021 00:32:06 +0100
Subject: [PATCH 07/12] small comment clean up.

Deleted a leftover comment line.
---
 src/main.js | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/src/main.js b/src/main.js
index a084c890f..de3c18303 100644
--- a/src/main.js
+++ b/src/main.js
@@ -634,8 +634,7 @@ const startCreating = async () => {
             : null;
 
 
-          // New name builder. It can form names like; "PREFIX #10 - SUFFIX #2". - BB
-          //const _name = `${_prefix ? _prefix + " " : ""}#${_suffix ? _edition : _edition - _offset}${_suffix ? " " + _suffix + (_offset>0 ? " #" + (_edition - _offset) : "") : ""}`; 
+          // New name builder. It can form names like; "PREFIX #10 - SUFFIX #2".
           const _name = `${_prefix ? `${_prefix} ` : ``}#${_suffix ? abstractedIndexes[0] : abstractedIndexes[0] - _offset}${_suffix ? ` ${_suffix}${layerConfigurations[layerConfigIndex].resetNameIndex ? ` #${abstractedIndexes[0] - _offset}` : ``}` : ``}`;
           console.log("_offset: "+_offset);
 

From 70b9cd4b5d02f44d5f778bab85c7678605c32739 Mon Sep 17 00:00:00 2001
From: bruceballad <bruceballad@gmail.com>
Date: Tue, 16 Nov 2021 13:51:54 +0100
Subject: [PATCH 08/12] Fix for using createPreviewCollage.js with JPEG outputs

Added a small check for the outputJPEG setting.
Now it can pull images with .jpg extension to create preview collage too.
---
 utils/createPreviewCollage.js | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/utils/createPreviewCollage.js b/utils/createPreviewCollage.js
index 724cda9a2..931f49e5e 100644
--- a/utils/createPreviewCollage.js
+++ b/utils/createPreviewCollage.js
@@ -8,7 +8,7 @@ const { createCanvas, loadImage } = require("canvas");
 const buildDir = `${basePath}/build`;
 
 console.log(path.join(basePath, "/src/config.js"));
-const { preview } = require(path.join(basePath, "/src/config.js"));
+const { preview, outputJPEG } = require(path.join(basePath, "/src/config.js"));
 
 // read json data
 const rawdata = fs.readFileSync(`${basePath}/build/json/_metadata.json`);
@@ -37,7 +37,7 @@ const saveProjectPreviewImage = async (_data) => {
   // Don't want to rely on "edition" for assuming index
   for (let index = 0; index < _data.length; index++) {
     const nft = _data[index];
-    await loadImage(`${buildDir}/images/${nft.edition}.png`).then((image) => {
+    await loadImage(`${buildDir}/images/${nft.edition}.${ outputJPEG ? `jpg` : `png` }`).then((image) => {
       previewCtx.drawImage(
         image,
         thumbWidth * (index % thumbPerRow),

From a4c6c8ddfa7f9fb5c3c0df936e9ac2ba24ef883a Mon Sep 17 00:00:00 2001
From: bruceballad <bruceballad@gmail.com>
Date: Tue, 16 Nov 2021 14:37:26 +0100
Subject: [PATCH 09/12] fix _offset console message + edition reports with name

Removed a leftover "_offset" console message while generating images.
Added "name" info in the "Created edition: #" messages in console for better reports. This will allow following prefix, suffix. and offset number changes while generating images.
---
 src/main.js | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/src/main.js b/src/main.js
index ccc71315e..b22ff5674 100644
--- a/src/main.js
+++ b/src/main.js
@@ -641,7 +641,6 @@ const startCreating = async () => {
 
           // New name builder. It can form names like; "PREFIX #10 - SUFFIX #2".
           const _name = `${_prefix ? `${_prefix} ` : ``}#${_suffix ? abstractedIndexes[0] : abstractedIndexes[0] - _offset}${_suffix ? ` ${_suffix}${layerConfigurations[layerConfigIndex].resetNameIndex ? ` #${abstractedIndexes[0] - _offset}` : ``}` : ``}`;
-          console.log("_offset: "+_offset);
 
           // New description builder, it can embed the asset name, AND overwrite the description for different layerConfigs. 
           // Can form unique descriptions like; "Item #10 is an art piece from Collection X".
@@ -657,7 +656,7 @@ const startCreating = async () => {
 
           saveMetaDataSingleFile(abstractedIndexes[0]);
           console.log(
-            `Created edition: ${abstractedIndexes[0]}, with DNA: ${hash(
+            `Created edition: ${abstractedIndexes[0]}, "${_name}" with DNA: ${hash(
               newDna
             )}`
           );

From a38859dc15e8762b08ac55ccaf2242f70f1597b7 Mon Sep 17 00:00:00 2001
From: bruceballad <bruceballad@gmail.com>
Date: Tue, 16 Nov 2021 21:25:24 +0100
Subject: [PATCH 10/12] Fix for using updateBaseUri.js with JPEG outputs

The baseUri util was always making the file extension in URLs ".png".
Added a small check for the outputJPEG setting.
Now it can update baseUri and write ".jpg" or ".png" based on the config outputJPEG setting.
---
 utils/updateBaseUri.js | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/utils/updateBaseUri.js b/utils/updateBaseUri.js
index 5d37318be..747617e44 100644
--- a/utils/updateBaseUri.js
+++ b/utils/updateBaseUri.js
@@ -6,14 +6,14 @@ const basePath = isLocal ? process.cwd() : path.dirname(process.execPath);
 const fs = require("fs");
 
 console.log(path.join(basePath, "/src/config.js"));
-const { baseUri } = require(path.join(basePath, "/src/config.js"));
+const { baseUri, outputJPEG } = require(path.join(basePath, "/src/config.js"));
 
 // read json data
 let rawdata = fs.readFileSync(`${basePath}/build/json/_metadata.json`);
 let data = JSON.parse(rawdata);
 
 data.forEach((item) => {
-  item.image = `${baseUri}/${item.edition}.png`;
+  item.image = `${baseUri}/${item.edition}.${ outputJPEG ? `jpg` : `png` }`;
   fs.writeFileSync(
     `${basePath}/build/json/${item.edition}.json`,
     JSON.stringify(item, null, 2)

From 064e4b74026dc2b17627229b2749ff81225c95c3 Mon Sep 17 00:00:00 2001
From: bruceballad <bruceballad@gmail.com>
Date: Sun, 21 Nov 2021 21:11:16 +0100
Subject: [PATCH 11/12] adds bypass DNA

manual update reflecting the last commit made by @nftchef

https://github.com/nftchef/hashlips_art_engine/commit/2e9d74e61ae2f60f1ce33558b59dcfc28056dd22
---
 README.md     | 15 ++++++++++++
 src/config.js |  7 +++++-
 src/main.js   | 63 ++++++++++++++++++++++++++++++++++++++++++++-------
 3 files changed, 76 insertions(+), 9 deletions(-)

diff --git a/README.md b/README.md
index afdfc7cc5..879b98676 100644
--- a/README.md
+++ b/README.md
@@ -119,6 +119,21 @@ HAIR
 
 Where the containing folder will define the traits _rarity_ and in the event that it is selected as part of the randomization, BOTH nested images will be included in the final result, in alphabetical oder–hence the 1, 2, numbering.
 
+### Options
+
+#### Exclude a layer from DNA
+
+If you want to have a layer _ignored_ in the DNA uniqueness check, you can set `bypassDNA: true` in the `options` object. This has the effect of making sure the rest of the traits are unique while not considering the `Background` Layers as traits, for example. The layers _are_ included in the final image.
+
+```js
+layersOrder: [
+      { name: "Background" },
+      { name: "Background" ,
+        options: {
+          bypassDNA: false;
+        }
+      },
+```
 
 ### Sublayer Options
 
diff --git a/src/config.js b/src/config.js
index 5d03de35a..0ba8e6537 100644
--- a/src/config.js
+++ b/src/config.js
@@ -31,7 +31,12 @@ const layerConfigurations = [
     nameSuffix: "Set A", // add a suffix after the number. if resetNameIndex is on too, put the reseted counter after the suffix - BB
     descriptionOverwrite: "{name} with Unique Description For Layer Set A", // LayerConfig spesific descriptions. Use {name} to embed asset names.
     layersOrder: [
-      { name: "Back Accessory" },
+      {
+        name: "Back Accessory",
+        options: {
+          bypassDNA: true,
+        },
+      },
       { name: "Head" },
       { name: "Clothes" },
       { name: "Eyes" },
diff --git a/src/main.js b/src/main.js
index b22ff5674..a27271ca5 100644
--- a/src/main.js
+++ b/src/main.js
@@ -200,6 +200,10 @@ const layersSetup = (layersOrder) => {
       ...(layerObj.display_type !== undefined && {
         display_type: layerObj.display_type,
       }),
+      bypassDNA:
+      layerObj.options?.["bypassDNA"] !== undefined
+        ? layerObj.options?.["bypassDNA"]
+        : false,
     };
   });
 
@@ -338,6 +342,45 @@ const constructLayerToDna = (_dna = [], _layers = []) => {
   return mappedDnaToLayers;
 };
 
+/**
+ * In some cases a DNA string may contain optional query parameters for options
+ * such as bypassing the DNA isUnique check, this function filters out those
+ * items without modifying the stored DNA.
+ *
+ * @param {String} _dna New DNA string
+ * @returns new DNA string with any items that should be filtered, removed.
+ */
+ const filterDNAOptions = (_dna) => {
+  const filteredDNA = _dna.filter((element) => {
+    const query = /(\?.*$)/;
+    const querystring = query.exec(element);
+    if (!querystring) {
+      return true;
+    }
+    const options = querystring[1].split("&").reduce((r, setting) => {
+      const keyPairs = setting.split("=");
+      return { ...r, [keyPairs[0]]: keyPairs[1] };
+    }, []);
+
+    return options.bypassDNA;
+  });
+
+  return filteredDNA;
+};
+
+/**
+ * Cleaning function for DNA strings. When DNA strings include an option, it
+ * is added to the filename with a ?setting=value query string. It needs to be
+ * removed to properly access the file name before Drawing.
+ *
+ * @param {String} _dna The entire newDNA string
+ * @returns Cleaned DNA string without querystring parameters.
+ */
+const removeQueryStrings = (_dna) => {
+  const query = /(\?.*$)/;
+  return _dna.replace(query, "");
+};
+
 const isDnaUnique = (_DnaList = [], _dna = []) => {
   let foundDna = _DnaList.find((i) => i.join("") === _dna.join(""));
   return foundDna == undefined ? true : false;
@@ -360,7 +403,8 @@ function pickRandomElement(
   dnaSequence,
   parentId,
   incompatibleDNA,
-  forcedDNA
+  forcedDNA,
+  bypassDNA
 ) {
   let totalWeight = 0;
   // Does this layer include a forcedDNA item? ya? just return it.
@@ -371,7 +415,7 @@ function pickRandomElement(
     debugLogs
       ? console.log(chalk.yellowBright(`Force picking ${forcedPick.name}/n`))
       : null;
-    let dnaString = `${parentId}.${forcedPick.id}:${forcedPick.filename}`;
+    let dnaString = `${parentId}.${forcedPick.id}:${forcedPick.filename}${bypassDNA}`;
     return dnaSequence.push(dnaString);
   }
 
@@ -401,7 +445,7 @@ function pickRandomElement(
     // If there is no weight, it's required, always include it
     // If directory has %, that is % chance to enter the dir
     if (element.weight == "required" && !element.sublayer) {
-      let dnaString = `${parentId}.${element.id}:${element.filename}`;
+      let dnaString = `${parentId}.${element.id}:${element.filename}${bypassDNA}`;
       dnaSequence.unshift(dnaString);
       return;
     }
@@ -411,7 +455,8 @@ function pickRandomElement(
         dnaSequence,
         `${parentId}.${element.id}`,
         incompatibleDNA,
-        forcedDNA
+        forcedDNA,
+        bypassDNA
       );
     }
     if (element.weight !== "required") {
@@ -464,7 +509,8 @@ function pickRandomElement(
             dnaSequence,
             `${parentId}.${currentLayers[i].id}`,
             incompatibleDNA,
-            forcedDNA
+            forcedDNA,
+            bypassDNA
           )
         );
       }
@@ -473,7 +519,7 @@ function pickRandomElement(
       if (currentLayers[i].name === emptyLayerName) {
         return dnaSequence;
       }
-      let dnaString = `${parentId}.${currentLayers[i].id}:${currentLayers[i].filename}`;
+      let dnaString = `${parentId}.${currentLayers[i].id}:${currentLayers[i].filename}${bypassDNA}`;
       return dnaSequence.push(dnaString);
     }
   }
@@ -505,7 +551,8 @@ const createDna = (_layers) => {
       layerSequence,
       layer.id,
       incompatibleDNA,
-      forcedDNA
+      forcedDNA,
+      layer.bypassDNA ? "?bypassDNA=true" : ""
     );
     const sortedLayers = sortLayers(layerSequence);
     dnaSequence = [...dnaSequence, [sortedLayers]];
@@ -661,7 +708,7 @@ const startCreating = async () => {
             )}`
           );
         });
-        dnaList.push(newDna);
+        dnaList.push(filterDNAOptions(newDna));
         editionCount++;
         abstractedIndexes.shift();
       } else {

From 3d139dc9af2c56d038656c195b2556825ab18efa Mon Sep 17 00:00:00 2001
From: bruceballad <bruceballad@gmail.com>
Date: Sun, 2 Jan 2022 05:30:06 +0100
Subject: [PATCH 12/12] Small Update

Just changed counter reset to 'true' for the second sample layerconfig set.
---
 .../3shadow_blend=multiply&opacity=50.png     | Bin 33178 -> 0 bytes
 package-lock.json                             | 220 ++++++++++++++++--
 package.json                                  |   5 +-
 src/config.js                                 |   2 +-
 4 files changed, 205 insertions(+), 22 deletions(-)
 delete mode 100644 layers/Clothes/Shirtthree#3/3shadow_blend=multiply&opacity=50.png

diff --git a/layers/Clothes/Shirtthree#3/3shadow_blend=multiply&opacity=50.png b/layers/Clothes/Shirtthree#3/3shadow_blend=multiply&opacity=50.png
deleted file mode 100644
index 88a1e2fea4a146fb2e56511d399d7c31439fb15d..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 33178
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

diff --git a/package-lock.json b/package-lock.json
index 4ba89076f..21bc8c80c 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "hashlips_art_engine",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
@@ -38,6 +38,14 @@
       "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-2.1.1.tgz",
       "integrity": "sha1-w7M6te42DYbg5ijwRorn7yfWVN8="
     },
+    "ansi-styles": {
+      "version": "4.3.0",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
+      "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==",
+      "requires": {
+        "color-convert": "^2.0.1"
+      }
+    },
     "aproba": {
       "version": "1.2.0",
       "resolved": "https://registry.npmjs.org/aproba/-/aproba-1.2.0.tgz",
@@ -57,6 +65,16 @@
       "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
       "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw=="
     },
+    "base64-js": {
+      "version": "1.5.1",
+      "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.5.1.tgz",
+      "integrity": "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA=="
+    },
+    "bn.js": {
+      "version": "5.2.0",
+      "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-5.2.0.tgz",
+      "integrity": "sha512-D7iWRBvnZE8ecXiLj/9wbxH7Tk79fAh8IHaTNq1RWRixsS02W+5qS+iE9yq6RYl0asXx5tw0bLhmT5pIfbSquw=="
+    },
     "brace-expansion": {
       "version": "1.1.11",
       "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.11.tgz",
@@ -66,6 +84,15 @@
         "concat-map": "0.0.1"
       }
     },
+    "buffer": {
+      "version": "6.0.3",
+      "resolved": "https://registry.npmjs.org/buffer/-/buffer-6.0.3.tgz",
+      "integrity": "sha512-FTiCpNxtwiZZHEZbcbTIcZjERVICn9yq/pDFkTl95/AxzD1naBctN7YO68riM/gLSDY7sdrMby8hofADYuuqOA==",
+      "requires": {
+        "base64-js": "^1.3.1",
+        "ieee754": "^1.2.1"
+      }
+    },
     "canvas": {
       "version": "2.8.0",
       "resolved": "https://registry.npmjs.org/canvas/-/canvas-2.8.0.tgz",
@@ -76,10 +103,14 @@
         "simple-get": "^3.0.3"
       }
     },
-    "charenc": {
-      "version": "0.0.2",
-      "resolved": "https://registry.npmjs.org/charenc/-/charenc-0.0.2.tgz",
-      "integrity": "sha1-wKHS86cJLgN3S/qD8UwPxXkKhmc="
+    "chalk": {
+      "version": "4.1.2",
+      "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
+      "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==",
+      "requires": {
+        "ansi-styles": "^4.1.0",
+        "supports-color": "^7.1.0"
+      }
     },
     "chownr": {
       "version": "2.0.0",
@@ -91,6 +122,24 @@
       "resolved": "https://registry.npmjs.org/code-point-at/-/code-point-at-1.1.0.tgz",
       "integrity": "sha1-DQcLTQQ6W+ozovGkDi7bPZpMz3c="
     },
+    "color-convert": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
+      "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",
+      "requires": {
+        "color-name": "~1.1.4"
+      }
+    },
+    "color-name": {
+      "version": "1.1.4",
+      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz",
+      "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA=="
+    },
+    "commander": {
+      "version": "8.3.0",
+      "resolved": "https://registry.npmjs.org/commander/-/commander-8.3.0.tgz",
+      "integrity": "sha512-OkTL9umf+He2DZkUq8f8J9of7yL6RJKI24dVITBmNfZBmri9zYZQrKkuXiKhyfPSu8tUhnVBB1iKXevvnlR4Ww=="
+    },
     "concat-map": {
       "version": "0.0.1",
       "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz",
@@ -106,11 +155,6 @@
       "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.3.tgz",
       "integrity": "sha512-ZQBvi1DcpJ4GDqanjucZ2Hj3wEO5pZDS89BWbkcrvdxksJorwUDDZamX9ldFkp9aw2lmBDLgkObEA4DWNJ9FYQ=="
     },
-    "crypt": {
-      "version": "0.0.2",
-      "resolved": "https://registry.npmjs.org/crypt/-/crypt-0.0.2.tgz",
-      "integrity": "sha1-iNf/fsDfuG9xPch7u0LQRNPmxBs="
-    },
     "debug": {
       "version": "4.3.2",
       "resolved": "https://registry.npmjs.org/debug/-/debug-4.3.2.tgz",
@@ -137,6 +181,48 @@
       "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-1.0.3.tgz",
       "integrity": "sha1-+hN8S9aY7fVc1c0CrFWfkaTEups="
     },
+    "eslint-plugin-es": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/eslint-plugin-es/-/eslint-plugin-es-3.0.1.tgz",
+      "integrity": "sha512-GUmAsJaN4Fc7Gbtl8uOBlayo2DqhwWvEzykMHSCZHU3XdJ+NSzzZcVhXh3VxX5icqQ+oQdIEawXX8xkR3mIFmQ==",
+      "requires": {
+        "eslint-utils": "^2.0.0",
+        "regexpp": "^3.0.0"
+      }
+    },
+    "eslint-plugin-node": {
+      "version": "11.1.0",
+      "resolved": "https://registry.npmjs.org/eslint-plugin-node/-/eslint-plugin-node-11.1.0.tgz",
+      "integrity": "sha512-oUwtPJ1W0SKD0Tr+wqu92c5xuCeQqB3hSCHasn/ZgjFdA9iDGNkNf2Zi9ztY7X+hNuMib23LNGRm6+uN+KLE3g==",
+      "requires": {
+        "eslint-plugin-es": "^3.0.0",
+        "eslint-utils": "^2.0.0",
+        "ignore": "^5.1.1",
+        "minimatch": "^3.0.4",
+        "resolve": "^1.10.1",
+        "semver": "^6.1.0"
+      },
+      "dependencies": {
+        "semver": {
+          "version": "6.3.0",
+          "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.0.tgz",
+          "integrity": "sha512-b39TBaTSfV6yBrapU89p5fKekE2m/NwnDocOVruQFS1/veMgdzuPcnOM34M6CwxW8jH/lxEa5rBoDeUwu5HHTw=="
+        }
+      }
+    },
+    "eslint-utils": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/eslint-utils/-/eslint-utils-2.1.0.tgz",
+      "integrity": "sha512-w94dQYoauyvlDc43XnGB8lU3Zt713vNChgt4EWwhXAP2XkBvndfxF0AgIqKOOasjPIPzj9JqgwkwbCYD0/V3Zg==",
+      "requires": {
+        "eslint-visitor-keys": "^1.1.0"
+      }
+    },
+    "eslint-visitor-keys": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-1.3.0.tgz",
+      "integrity": "sha512-6J72N8UNa462wa/KFODt/PJ3IU60SDpC3QXC1Hjc1BXXpfL2C9R5+AU7jhe0F6GREqVMh4Juu+NY7xn+6dipUQ=="
+    },
     "fs-minipass": {
       "version": "2.1.0",
       "resolved": "https://registry.npmjs.org/fs-minipass/-/fs-minipass-2.1.0.tgz",
@@ -150,6 +236,11 @@
       "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz",
       "integrity": "sha1-FQStJSMVjKpA20onh8sBQRmU6k8="
     },
+    "function-bind": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.1.tgz",
+      "integrity": "sha512-yIovAzMX49sF8Yl58fSCWJ5svSLuaibPxXQJFLmBObTuCr0Mf1KiPopGM9NiFjiYBCbfaa2Fh6breQ6ANVTI0A=="
+    },
     "gauge": {
       "version": "2.7.4",
       "resolved": "https://registry.npmjs.org/gauge/-/gauge-2.7.4.tgz",
@@ -178,6 +269,19 @@
         "path-is-absolute": "^1.0.0"
       }
     },
+    "has": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/has/-/has-1.0.3.tgz",
+      "integrity": "sha512-f2dvO0VU6Oej7RkWJGrehjbzMAjFp5/VKPp5tTpWIV4JHHZK1/BxbFRtf/siA2SWTe09caDmVtYYzWEIbBS4zw==",
+      "requires": {
+        "function-bind": "^1.1.1"
+      }
+    },
+    "has-flag": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz",
+      "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ=="
+    },
     "has-unicode": {
       "version": "2.0.1",
       "resolved": "https://registry.npmjs.org/has-unicode/-/has-unicode-2.0.1.tgz",
@@ -192,6 +296,16 @@
         "debug": "4"
       }
     },
+    "ieee754": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/ieee754/-/ieee754-1.2.1.tgz",
+      "integrity": "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA=="
+    },
+    "ignore": {
+      "version": "5.2.0",
+      "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.2.0.tgz",
+      "integrity": "sha512-CmxgYGiEPCLhfLnpPp1MoRmifwEIOgjcHXxOBjv7mY96c+eWScsOP9c112ZyLdWHi0FxHjI+4uVhKYp/gcdRmQ=="
+    },
     "inflight": {
       "version": "1.0.6",
       "resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz",
@@ -206,6 +320,14 @@
       "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
       "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ=="
     },
+    "is-core-module": {
+      "version": "2.8.0",
+      "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.8.0.tgz",
+      "integrity": "sha512-vd15qHsaqrRL7dtH6QNuy0ndJmRDrS9HAM1CAiSifNUFv4x1a0CCVsj18hJ1mShxIG6T2i1sO78MkP56r0nYRw==",
+      "requires": {
+        "has": "^1.0.3"
+      }
+    },
     "is-fullwidth-code-point": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-1.0.0.tgz",
@@ -219,6 +341,38 @@
       "resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz",
       "integrity": "sha1-u5NdSFgsuhaMBoNJV6VKPgcSTxE="
     },
+    "keccak": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/keccak/-/keccak-3.0.2.tgz",
+      "integrity": "sha512-PyKKjkH53wDMLGrvmRGSNWgmSxZOUqbnXwKL9tmgbFYA1iAYqW21kfR7mZXV0MlESiefxQQE9X9fTa3X+2MPDQ==",
+      "requires": {
+        "node-addon-api": "^2.0.0",
+        "node-gyp-build": "^4.2.0",
+        "readable-stream": "^3.6.0"
+      },
+      "dependencies": {
+        "readable-stream": {
+          "version": "3.6.0",
+          "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.0.tgz",
+          "integrity": "sha512-BViHy7LKeTz4oNnkcLJ+lVSL6vpiFeX6/d3oSH8zCW7UxP2onchk+vTGB143xuFjHS3deTgkKoXXymXqymiIdA==",
+          "requires": {
+            "inherits": "^2.0.3",
+            "string_decoder": "^1.1.1",
+            "util-deprecate": "^1.0.1"
+          }
+        }
+      }
+    },
+    "keccak256": {
+      "version": "1.0.6",
+      "resolved": "https://registry.npmjs.org/keccak256/-/keccak256-1.0.6.tgz",
+      "integrity": "sha512-8GLiM01PkdJVGUhR1e6M/AvWnSqYS0HaERI+K/QtStGDGlSTx2B1zTqZk4Zlqu5TxHJNTxWAdP9Y+WI50OApUw==",
+      "requires": {
+        "bn.js": "^5.2.0",
+        "buffer": "^6.0.3",
+        "keccak": "^3.0.2"
+      }
+    },
     "lru-cache": {
       "version": "6.0.0",
       "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-6.0.0.tgz",
@@ -287,11 +441,21 @@
       "resolved": "https://registry.npmjs.org/nan/-/nan-2.15.0.tgz",
       "integrity": "sha512-8ZtvEnA2c5aYCZYd1cvgdnU6cqwixRoYg70xPLWUws5ORTa/lnw+u4amixRS/Ac5U5mQVgp9pnlSUnbNWFaWZQ=="
     },
+    "node-addon-api": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/node-addon-api/-/node-addon-api-2.0.2.tgz",
+      "integrity": "sha512-Ntyt4AIXyaLIuMHF6IOoTakB3K+RWxwtsHNRxllEoA6vPwP9o4866g6YWDLUdnucilZhmkxiHwHr11gAENw+QA=="
+    },
     "node-fetch": {
       "version": "2.6.2",
       "resolved": "https://registry.npmjs.org/node-fetch/-/node-fetch-2.6.2.tgz",
       "integrity": "sha512-aLoxToI6RfZ+0NOjmWAgn9+LEd30YCkJKFSyWacNZdEKTit/ZMcKjGkTRo8uWEsnIb/hfKecNPEbln02PdWbcA=="
     },
+    "node-gyp-build": {
+      "version": "4.3.0",
+      "resolved": "https://registry.npmjs.org/node-gyp-build/-/node-gyp-build-4.3.0.tgz",
+      "integrity": "sha512-iWjXZvmboq0ja1pUGULQBexmxq8CV4xBhX7VDOTbL7ZR4FOowwY/VOtRxBN/yKxmdGoIp4j5ysNT4u3S2pDQ3Q=="
+    },
     "nopt": {
       "version": "5.0.0",
       "resolved": "https://registry.npmjs.org/nopt/-/nopt-5.0.0.tgz",
@@ -334,6 +498,11 @@
       "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz",
       "integrity": "sha1-F0uSaHNVNP+8es5r9TpanhtcX18="
     },
+    "path-parse": {
+      "version": "1.0.7",
+      "resolved": "https://registry.npmjs.org/path-parse/-/path-parse-1.0.7.tgz",
+      "integrity": "sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw=="
+    },
     "process-nextick-args": {
       "version": "2.0.1",
       "resolved": "https://registry.npmjs.org/process-nextick-args/-/process-nextick-args-2.0.1.tgz",
@@ -353,6 +522,20 @@
         "util-deprecate": "~1.0.1"
       }
     },
+    "regexpp": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/regexpp/-/regexpp-3.2.0.tgz",
+      "integrity": "sha512-pq2bWo9mVD43nbts2wGv17XLiNLya+GklZ8kaDLV2Z08gDCsGpnKn9BFMepvWuHCbyVvY7J5o5+BVvoQbmlJLg=="
+    },
+    "resolve": {
+      "version": "1.20.0",
+      "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.20.0.tgz",
+      "integrity": "sha512-wENBPt4ySzg4ybFQW2TT1zMQucPK95HSh/nq2CFTZVOGut2+pQvSsgtda4d26YrYcr067wjbmzOG8byDPBX63A==",
+      "requires": {
+        "is-core-module": "^2.2.0",
+        "path-parse": "^1.0.6"
+      }
+    },
     "rimraf": {
       "version": "3.0.2",
       "resolved": "https://registry.npmjs.org/rimraf/-/rimraf-3.0.2.tgz",
@@ -379,15 +562,6 @@
       "resolved": "https://registry.npmjs.org/set-blocking/-/set-blocking-2.0.0.tgz",
       "integrity": "sha1-BF+XgtARrppoA93TgrJDkrPYkPc="
     },
-    "sha1": {
-      "version": "1.1.1",
-      "resolved": "https://registry.npmjs.org/sha1/-/sha1-1.1.1.tgz",
-      "integrity": "sha1-rdqnqTFo85PxnrKxUJFhjicA+Eg=",
-      "requires": {
-        "charenc": ">= 0.0.1",
-        "crypt": ">= 0.0.1"
-      }
-    },
     "signal-exit": {
       "version": "3.0.4",
       "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-3.0.4.tgz",
@@ -434,6 +608,14 @@
         "ansi-regex": "^2.0.0"
       }
     },
+    "supports-color": {
+      "version": "7.2.0",
+      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz",
+      "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==",
+      "requires": {
+        "has-flag": "^4.0.0"
+      }
+    },
     "tar": {
       "version": "6.1.11",
       "resolved": "https://registry.npmjs.org/tar/-/tar-6.1.11.tgz",
diff --git a/package.json b/package.json
index fc0952f3b..1a7e7bb3c 100644
--- a/package.json
+++ b/package.json
@@ -18,7 +18,8 @@
     "build": "node index.js",
     "generate:solana": "node index.js && node utils/metaplex.js",
     "generate:cardano": "node index.js && node utils/cardano.js",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "preview": "node utils/createPreviewCollage.js"
   },
   "author": "Daniel Eugene Botha (HashLips), NFTChef",
   "license": "MIT",
@@ -29,4 +30,4 @@
     "eslint-plugin-node": "^11.1.0",
     "keccak256": "^1.0.3"
   }
-}
\ No newline at end of file
+}
diff --git a/src/config.js b/src/config.js
index 5e615f38d..f2cc24eea 100644
--- a/src/config.js
+++ b/src/config.js
@@ -49,7 +49,7 @@ const layerConfigurations = [
   {
     growEditionSizeTo: 10,
     namePrefix: "Monkey",
-    resetNameIndex: false, // this will start the count at #1 for this layerconfig
+    resetNameIndex: true, // this will start the count at #1 for this layerconfig
     nameSuffix: "Set B", // add a suffix after the number. if resetNameIndex is on too, put the reseted counter after the suffix - BB
     descriptionOverwrite: "Description for {name} from Layer Set B", // LayerConfig spesific descriptions. Use {name} to embed asset names.