<aside> 🔑 Before reading this article, please make sure you have read the following articles

What’s Composable NFT

Add Asset Entry

Mint

Transfer NFT

</aside>

Catalog is a prerequisite for realizing composable NFT. In the following instructions, "Blueprint = Catalog".

Create Catalog

1. Click "Create" in header, and then click "Create CATALOG" on the new page.

   

2. In general, you can directly click "Create" to quickly create a Catalog and modify it later:

   • Metadata URI of Catalog: Similar to Collection Metadata, you can also set Metadata for Catalog, but note that Lightm has some recommended configurations for Catalog Metadata to improve the readability of Catalog: Recommended allocation way for Part ID of Catalog
   • Type of Catalog: Your composable NFT blueprint may be a 2D picture, music, or 3d-model, please fill in according to the specific situation

   The above two data can be modified later, so there is no need to worry about filling in mistakes. In the instructions, we directly configure the Metadata of the Catalog (we use the Catalog metadata format recommended by Lightm, which is why the Preview displays LIGHTM_CATALOG is detected to be open).

   

   

3. After the Catalog is created, copy the Catalog address to the search box, or find the Catalog you created through "My NFT".

   • Search

     

   • My NFT

     

4. We will use this Catalog as a Lightm Logo blueprint, first, click "Add Parts”

   

   We will add 3 Part:

   • 1 FIXED skeleton
   • 2 equippable SLOT

   Next, we explain each attribute of a single Part:

   • “Part Class ID”/”Part Sub ID”: Lightm uses Recommended allocation way for Part ID of Catalog by default to help users classify Part IDs.
   • “Metadata URI”: Means Metadata of Part, different type of Part’s Metadata has different function:
     • FIXED : mediaUri in Metadata will be the basis for rendering by Lightm renderer
     • SLOT: Metadata is used to store Slot description, mediaUri is invalid
   • "Z": Instructs the renderer to render the Part at the rendering level, the larger the Z, the higher the layer
   • “Part Type”：2 type, one is FIXED ，one is SLOT
     • When the Part Type is SLOT, the user can configure "Equippable Addresses", which essentially refers to the slot whitelist, indicating which NFTs under the Collection can be equipped to the SLOT

5. Click "Add", wait for a while (you need to wait for the off-chain Squid Indexer to synchronize the latest data), click the refresh button, and you can see the newly added Part

   Then we set the 2 SLOTs as Public, allowing any NFT under Collection to be equipped to these 2 slots. (Note: Please configure according to your own needs. In order to simplify the explanation process, a more convenient solution is adopted here)

   

Add CatalogRelatedAsset to Token and finish equiping

1. Enter the Collection detail page where CatalogRelatedAsset needs to be added, click "Add Asset Entry" and check "Is Catalog Related Asset", there will be 4 items to fillin:

   ---

   • "Catalog Address" and "Part IDs": These two fill-in items form a group. Enter the Catalog Address to specify the address of the blueprint, and then select the part that you want to be instantiated as an Asset in the drop-down selection box of Part IDs
   • "Target Catalog Address" and "Target Slot ID": These two fill-in items form a group. Enter the Target Catalog Address to specify the address of the target blueprint, and then select the SLOT of the target blueprint instance in the drop-down list box of the Target Slot ID ID

   The first thing is to instantiate the CatalogRelatedAsset with the blueprint, only the CatalogRelatedAsset instantiated from the blueprint has the ability to equip or become an equipment item. (Note: We can instantiate a CatalogRelatedAsset that has both features, so that we can achieve nested equipment, but this attempt is not made in this example)

   1. First, we instantiate an Asset with equip capabilities. After entering the address of the blueprint, select all Parts in the blueprint.

      

   2. Then we instantiate 2 equipment item Assets one after another, pointing to 2 slots respectively.

      

      

   3. We Mint 3 empty NFTs in advance. Then we add Asset#1 to NFT#1, Asset#2 to NFT#2, and Asset#3 to NFT#3.

      

   4. Send NFT#2 and NFT#3 to NFT#1, and let NFT#1 accept them.

   5. Then, turn on "Equip Mode". Equip NFT#2 and NFT#3 under the currently selected CatalogRelatedAsset of NFT#1, and we can preview the current equipment effect in real time. When you are sure everything is ready, click "Confirm".

      

      

      

   6. Success.