Sign up at Moralis
Once logged in on the admin panel, navigate to WEB3 API
Add your Moralis key .env
MORALIS=your-endpoint-key
You may want to read the original HashLips docs if you have not. You can understand how to pass in your own image layers for regenerative NFTs. The code comes with some boilperplate layers from HashLips that I have used.
To begin, run npm run build
or node index.js
Your images and jsons are now written to the moralisIPFS/build folder.
Ensure you have your own collection image and json in the 'collection#1' folder. You can rearrange the folder structure how you like, as long as the scripts are reading fine.
You need to upload images first, for the JSONs to read the image later.
*Run node moralisIPFS/scripts/collectionImage.js
to get the url of the image in console.
*Paste this link in line 25 of collectionJson.js
then run node moralisIPFS/scripts/collectionJson.js
.
*Now copy the log from collectionJson.js
and keep somewhere to put in your ERC721 contract contractUri
function for opensea.
You can do the same for the images721 and metadata721 scripts.
You will have to hard-code the number of generations in the numOfItems.js
. This is read from the images721 and metadata721 scripts.
After images721.js
logs, remember to grab your JSON links from the console for minting your nfts with.
Feel free to try my boilperplate for ERC721 OpenSea NFTs here
example image link for json script: 'ipfs://Qmbd46WBvCK33kuGcEb7LtQkWcXW3ygDEgBv5rdFvnJ7RX/collection-1/image.gif'
This video from Moralis played a part
All the code in these repos was created and explained by HashLips on the main YouTube channel.
To find out more please visit:
Create generative art by using the canvas api and node js. Before you use the generation engine, make sure you have node.js installed.
If you are cloning the project then run this first, otherwise you can download the source code on the release page and skip this step.
git clone https://github.com/HashLips/hashlips_art_engine.git
Go to the root of your folder and run this command if you have yarn installed.
yarn install
Alternatively you can run this command if you have node installed.
npm install
Create your different layers as folders in the 'layers' directory, and add all the layer assets in these directories. You can name the assets anything as long as it has a rarity weight attached in the file name like so: example element#70.png
. You can optionally change the delimiter #
to anything you would like to use in the variable rarityDelimiter
in the src/config.js
file.
Once you have all your layers, go into src/config.js
and update the layerConfigurations
objects layersOrder
array to be your layer folders name in order of the back layer to the front layer.
Example: If you were creating a portrait design, you might have a background, then a head, a mouth, eyes, eyewear, and then headwear, so your layersOrder
would look something like this:
const layerConfigurations = [
{
growEditionSizeTo: 100,
layersOrder: [
{ name: "Head" },
{ name: "Mouth" },
{ name: "Eyes" },
{ name: "Eyeswear" },
{ name: "Headwear" },
],
},
];
The name
of each layer object represents the name of the folder (in /layers/
) that the images reside in.
Optionally you can now add multiple different layerConfigurations
to your collection. Each configuration can be unique and have different layer orders, use the same layers or introduce new ones. This gives the artist flexibility when it comes to fine tuning their collections to their needs.
Example: If you were creating a portrait design, you might have a background, then a head, a mouth, eyes, eyewear, and then headwear and you want to create a new race or just simple re-order the layers or even introduce new layers, then you're layerConfigurations
and layersOrder
would look something like this:
const layerConfigurations = [
{
// Creates up to 50 artworks
growEditionSizeTo: 50,
layersOrder: [
{ name: "Background" },
{ name: "Head" },
{ name: "Mouth" },
{ name: "Eyes" },
{ name: "Eyeswear" },
{ name: "Headwear" },
],
},
{
// Creates an additional 100 artworks
growEditionSizeTo: 150,
layersOrder: [
{ name: "Background" },
{ name: "Head" },
{ name: "Eyes" },
{ name: "Mouth" },
{ name: "Eyeswear" },
{ name: "Headwear" },
{ name: "AlienHeadwear" },
],
},
];
Update your format
size, ie the outputted image size, and the growEditionSizeTo
on each layerConfigurations
object, which is the amount of variation outputted.
You can mix up the layerConfigurations
order on how the images are saved by setting the variable shuffleLayerConfigurations
in the config.js
file to true. It is false by default and will save all images in numerical order.
If you want to have logs to debug and see what is happening when you generate images you can set the variable debugLogs
in the config.js
file to true. It is false by default, so you will only see general logs.
If you want to play around with different blending modes, you can add a blend: MODE.colorBurn
field to the layersOrder options
object.
If you need a layers to have a different opacity then you can add the opacity: 0.7
field to the layersOrder options
object as well.
To use a different metadata attribute name you can add the displayName: "Awesome Eye Color"
to the options
object. All options are optional and can be addes on the same layer if you want to.
Here is an example on how you can play around with both filter fields:
const layerConfigurations = [
{
growEditionSizeTo: 5,
layersOrder: [
{ name: "Background" },
{ name: "Eyeball" },
{
name: "Eye color",
options: {
blend: MODE.destinationIn,
opacity: 0.2,
displayName: "Awesome Eye Color",
},
},
{ name: "Iris" },
{ name: "Shine" },
{ name: "Bottom lid", options: { blend: MODE.overlay, opacity: 0.7 } },
{ name: "Top lid" },
],
},
];
Here is a list of the different blending modes that you can optionally use.
const MODE = {
sourceOver: "source-over",
sourceIn: "source-in",
sourceOut: "source-out",
sourceAtop: "source-out",
destinationOver: "destination-over",
destinationIn: "destination-in",
destinationOut: "destination-out",
destinationAtop: "destination-atop",
lighter: "lighter",
copy: "copy",
xor: "xor",
multiply: "multiply",
screen: "screen",
overlay: "overlay",
darken: "darken",
lighten: "lighten",
colorDodge: "color-dodge",
colorBurn: "color-burn",
hardLight: "hard-light",
softLight: "soft-light",
difference: "difference",
exclusion: "exclusion",
hue: "hue",
saturation: "saturation",
color: "color",
luminosity: "luminosity",
};
When you are ready, run the following command and your outputted art will be in the build/images
directory and the json in the build/json
directory:
npm run build
or
node index.js
The program will output all the images in the build/images
directory along with the metadata files in the build/json
directory. Each collection will have a _metadata.json
file that consists of all the metadata in the collection inside the build/json
directory. The build/json
folder also will contain all the single json files that represent each image file. The single json file of a image will look something like this:
{
"dna": "d956cdf4e460508b5ff90c21974124f68d6edc34",
"name": "#1",
"description": "This is the description of your NFT project",
"image": "https://hashlips/nft/1.png",
"edition": 1,
"date": 1731990799975,
"attributes": [
{ "trait_type": "Background", "value": "Black" },
{ "trait_type": "Eyeball", "value": "Red" },
{ "trait_type": "Eye color", "value": "Yellow" },
{ "trait_type": "Iris", "value": "Small" },
{ "trait_type": "Shine", "value": "Shapes" },
{ "trait_type": "Bottom lid", "value": "Low" },
{ "trait_type": "Top lid", "value": "Middle" }
],
"compiler": "HashLips Art Engine"
}
You can also add extra metadata to each metadata file by adding your extra items, (key: value) pairs to the extraMetadata
object variable in the config.js
file.
const extraMetadata = {
creator: "Daniel Eugene Botha",
};
If you don't need extra metadata, simply leave the object empty. It is empty by default.
const extraMetadata = {};
That's it, you're done.
You might possibly want to update the baseUri and description after you have ran your collection. To update the baseUri and description simply run:
npm run update_info
Create a preview image collage of your collection, run:
npm run preview
In order to convert images into pixelated images you would need a list of images that you want to convert. So run the generator first.
Then simply run this command:
npm run pixelate
All your images will be outputted in the /build/pixel_images
directory.
If you want to change the ratio of the pixelation then you can update the ratio property on the pixelFormat
object in the src/config.js
file. The lower the number on the left, the more pixelated the image will be.
const pixelFormat = {
ratio: 5 / 128,
};
To see the percentages of each attribute across your collection, run:
npm run rarity
The output will look something like this:
Trait type: Bottom lid
{ trait: 'High', chance: '20', occurrence: '15% out of 100%' }
{ trait: 'Low', chance: '40', occurrence: '40% out of 100%' }
{ trait: 'Middle', chance: '40', occurrence: '45% out of 100%' }
Trait type: Iris
{ trait: 'Large', chance: '20', occurrence: '15% out of 100%' }
{ trait: 'Medium', chance: '20', occurrence: '15% out of 100%' }
{ trait: 'Small', chance: '60', occurrence: '70% out of 100%' }
Hope you create some awesome artworks with this code 👄