**NOTE: You run the risk of being moderated if your projects on fxhash are not properly labeled. If your project uses a template like the one used in this guide, you must state very clearly as such.**&#x20;

fxhash rules. It's a marketplace that offers a unique minting experience that only works with generative types of NFTs. Unfortunately, this means that most people lack the skills to take advantage of such a great platform. The bottleneck for most people is the coding knowledge required, but thanks to [@PureSpider](https://twitter.com/PureSpider) and his template we can actually launch an entire generative PFP project for the cost of a single mint on fxhash.&#x20;

Before we proceed, please have the [README.md](https://github.com/PureSpider/fxhash-pfp/blob/master/README.md) file for extra notes and reference. Between the README file and this guide, you should have few problems following along.

## Prerequisites

1\. Get [Node.js](https://nodejs.org/en/) installed

2\.  Download t[he template from GitHub](https://github.com/PureSpider/fxhash-pfp/archive/refs/heads/master.zip) & unzip it 🤐

3\. The layers for your project, organized into the correct folders & named correctly ✍️

4\. If you plan on minting your generative token then fxhash needs to be open! Check the status and schedule here ➡️ [opening schedule](https://www.fxhash.xyz/community/opening-schedule)

### Get Node.js 📖

The first thing we need to do is [install Node.js](https://nodejs.org/en/). It is a pretty straightforward operation. But what is Node.js, actually? It's a package manager for Javascript libraries and tries to make things easier for developers. If you want to learn more than my layman's explanation I'd just check [the about page](https://nodejs.org/en/about/).

### Get PureSpider's Template 🕷️

Download [this .zip file](https://github.com/PureSpider/fxhash-pfp/archive/refs/heads/master.zip) from Spider's GitHub profile and extract it somewhere convenient for yourself. Inside the .zip there are several folders, all of which we can ignore except for the folder named 'public'. Inside of public is a 'layers' folder. This is where all o your image files will reside. 🆒

### Layers upon layers

If you need help on preparing your layers then you're probably better off looking at [an article like this](https://medium.com/web-design-web-developer-magazine/how-to-prepare-artwork-for-a-generative-nft-programmer-970adf59c042), since that's just a little too far outside of my range to offer up meaningful advice on it. I can, however, talk about how the rarity percentages work.

Inside the layers folder you should have 1 folder for each category or group of traits. In our example we have 9 different ones: background, capes, body, dots, eyes, mouth, hair, and two different accessories. The numbers determine the order, so double zero is first, 01 is second, and so on. That's all there is to that.

![](ipfs://QmSULDrCbegYpVRcKMXoGPTqkPc9qRjpuhrUyeici4BizG)

The trait for "capes" is hidden from the feature section underneath.

![](ipfs://QmWdRUWGuXomTYtLb66kZwL5ZSXNUmnuYXHQPXMhytJND3)

The other thing to note is that the folder for Dots is actually named "03-hide-Dots" - **hide** is a keyword that will exclude those traits from showing up on the list, but still want to include it. You know the hide function is working if you don't see it listed as an attribute on fxhash, like how the capes feature is excluded in the above photo.

### How do we determine the rarities of individual traits?

We do that by naming the individual files with a number at the beginning. The numbers themselves don't have to add up to anything specific since they're all relative to each other. If you have two traits, 1-White.png and 100-Blue.png, the Blue version will show up (on average) 100 times more often than the White version. The larger the number, the more often it will show up compared to a smaller number. Adjust accordingly. &#x20;

### Let's generate a GENTK

So now we need to generate the .zip file to upload to fxhash so we can test it. This is where the magic happens. But all we need to do is run the 'generate.sh' (Mac/Linux) or 'generate.bat' (Windows) script and it should create you a zipped file in the 'dist-zipped' folder. The whole process should only take a few seconds.

You should be able to simply open the .sh file and run it, but I would sometimes run into problems getting it to work. @PureSpider has the fix for that too though, and we just need to run a simple chmod command.

```js
chmod +x generate.sh
```

![](ipfs://QmURXzQ1d5aNfgePLhTfyD84U2yMH6toFvo3hJc52Awnff)

Try this if your generate.sh file is giving you trouble.

If that's too intimidating you can try downloading the generate.sh that I've chmod'd already and [uploaded to IPFS](https://gateway.pinata.cloud/ipfs/QmRyGDMRAxvzCn1SsgPCnAQhKChuztwVHtSjNcNU3dKbKk). Delete generate.sh, download the linked file, and put it in the same spot.

If you find yourself unable to use the generate.sh file, then it's a very simple fix to run the command ourselves. We just need to navigate to the correct folder in our terminal and run a couple commands.

1\. npm install

2\. npm run build

![](ipfs://QmaNk8vgi5MppuVvvBNudVjJgJtVByA4ALoo7fnWb9KA1F)

You can ignore the warnings that may appear when running the install command. It's okay for our purposes.

### Test it!

Now you can head over to the sandbox on fxhash and try it out! Upload your .zip file and you can select the "try new hash" button to have it reload with a new iteration. If everything looks good, you're now ready to mint.

Going through the minting process is pretty similar to a non-fxhash platform outside of a couple things that may throw you off. I would just check the docs on fxhash, specifically the 'How to publish (mint) a GT' section. That whole page is filled with well written information.

### Summary

I hope this helped remove some of the mystery surrounding fxhash mints. It's exciting to level the playing field a little bit and allow someone who knows zero code at all to participate on a platform that requires it. Will we see an influx of PFP projects originating on fxhash now?&#x20;

If any of these directions need to be clarified, please let me know so I can do so. This will be revised as needed. And send some love to @PureSpider for making all of this possible. *He's included on 50% of all royalties for this fx(text) piece.*


This guide will explain how to use the template that PureSpider developed to make generative PFP styled projects possible on fxhash without writing any code. This guide was originally posted on TEZ.INK.

growing photographer, exploring NFTs, DeFi, and generative/AI artworks. (@klickdotdev)

How To: Launch a No-Code PFP Project on fxhash

Written by

Editions

Share

Details

stay ahead with our newsletter