🎨
MYTY
MYTY Kit
MYTY Kit
  • 👋Before you begin
    • GM, MYTY! 👐
    • What is MYTY Kit?
    • MYTY Kit System Requirements
    • Prerequisites
    • MYTY Kit Glossary
  • ✍️Getting started
    • 1. Prepare Illustration PSB
      • Key Requirements
      • Basics of Avatar Animation
      • Recommended PSB file structure for Trait Mapper
    • 2. Trait Mapping
      • Guide to MYTY Kit Trait Mapper
      • New Field: Token ID
    • 3. Install Unity
    • 4. Import MYTY Kit
    • 5. Import 2D Avatar Assets
  • 🔮Make animation
    • 6. Before Rigging
    • 7. Rigging in Sprite Editor
      • Mesh in Unity
    • 8. MYTY Kit Controllers
      • Bone 1D Controller
      • Bone 2D Controller
      • Sprite 1D Range Controller
      • Sprite 2D Nearest Controller
      • Rigged Sprite 2D Nearest Controller
    • 9. Apply Motion Tracking
      • Character Movement
      • Bone Motion Adapters
        • Bone2D
        • BoneTiltOrPosition
        • EyeBlink & EyeBlinkAll
        • EyeBrow & EyeBrowAll
        • Pupil & PupilAll
      • Sprite Motion Adapters
        • EyeBlink & EyeBlinkAll
        • EyeBrow & EyeBrowAll
        • MouthSprite
      • Advanced documentation
        • Mapper & Reducer
        • Stabilizing method
    • 10. Set up AR Face Mode
    • Advanced Animation
      • Physics 2D
      • Sprite Masking
      • Idle Animation
  • 🤹Connect with MYTY Metaverse
    • 11. Export MYTY Avatar
      • MYTY Avatar Viewer
      • Updates on File Export Format — Zip file
    • 12. Upload to Avatar Manager
  • 🗒️Appendix
    • 😄Mediapipe Extension
    • 🎨MotionAdaptorPalette
  • 🗂️MISC
    • About Us
    • Troubleshooting & FAQ
    • Change Log
    • License
      • License.md
    • Legacy Documentation
      • [v0.1.0] 4. Import MYTY Kit
      • [v0.1.0] 6. Before Rigging
      • [v0.1.0] 9. Apply Motion Tracking
      • [v.0.1.0] 11. Export MYTY Avatar
Powered by GitBook
On this page
  • Avatar Trait Mapping in MYTY Kit
  • What is Avatar Trait?
  • What is Trait Mapping?
  • Why do we need a Trait Mapping file?
  • How to create a Trait Mapping file?
  • What is the specification of Trait Mapping file?
  • Is it possible to update the Trait Mapping file?
  1. Getting started

2. Trait Mapping

This function is ideally utilized for PFP projects that were created by Generative Art.

PreviousRecommended PSB file structure for Trait MapperNextGuide to MYTY Kit Trait Mapper

Last updated 2 years ago

MYTY Kit supports expressing multiple PFP Avatars from one AssetBundle file. It means that multiple PFP Avatars will share skeletons and animations defined. And this function can be supported through Trait Mapping file. Trait Mapping file has information about which image layers need to be included in each NFT.

Avatar Trait Mapping in MYTY Kit

What is Avatar Trait?

  • Every single NFT has its own traits, which represent the key characteristics of the PFP image of the NFT.

  • Based on the traits, we can imagine what the image of the NFT will look like.

  • As most of the PFP collections have been created by generative art algorithms, each NFT shares its traits with other NFTs in the collection.

What is Trait Mapping?

  • The Trait Mapping file has information about which image layers need to be included in each NFT.

  • MYTY Kit utilizes the Trait Mapping file to pile the selected image layers up and build the full image of each PFP avatar.

  • Avatar Selector enables us to display certain Avatar that we want to load, by updating the parameter Avatar ID included in Avatar Selector.

Why do we need a Trait Mapping file?

  • Basically, of course it is possible to create a PFP avatar that supports a single NFT.

  • In this case, if we want to create PFP Avatars for the collection level, we have to do the work 10k times repeatedly.

  • Using the Trait Mapping file, we only need to create skeletons just once (or several times at most), and each PFP Avatar will share the same skeletons.

  • The size of the Motion Adaption-related work and Controller-related work are also significantly reduced, if we use the Trait Mapping file.

  • In this case, the PSB file should consist of all the image layers of the whole collection.

How to create a Trait Mapping file?

  • You can either:

  1. Use MYTY's MYTY Kit Trait Mapper Web.

    Guide to MYTY Kit Trait Mapper Or,

  2. Manually create a Trait Mapping file

What is the specification of Trait Mapping file?

  • File Extension: JSON file

  • Sample file

  • File Format

[
	{
		"id": int,  // token ID
		"filename": string,  // file name of psd file
		"traits": List<string>  // array of full paths of image layers
	},
	...
]
  • Example JSON file

[
	{
		"id": 0,
		"filename": "CollectionName_A_v01.psb",
		"traits": [
			"Body/BlueAndYellowJacket",
			"Head/Tan",
			"Face/Eyes/BlackLeftEye",
			 ...
			"Hair/PurpleLong"
		]
	},
	{
		"id": 1,
		"filename": "CollectionName_A_v01.psb",
		"traits": [
			"Body/PurpleSweaterWithSatchel",
			"Head/Gradient2",
			"Face/Eyes/BlackLeftEye",
			 ...
			"Hair/WhiteBucketCap"
		]
	},
	...
	{
		"id": 9999,
		"filename": "CollectionName_B_v01.psb",
		"traits": [
			"Body/PinkFleece",
			"Head/Yellow",
			"Face/Eyes/BlackLeftEye",
			 ...
			"Hair/BlueMessy"
		]
	}
]

Is it possible to update the Trait Mapping file?

👉 After you imported the Trait Mapping file to the Unity Project:

👉 After you exported Asset Bundle of the collection:

The method 5. Import 2D Avatar Assets loads the Trait Mapping file and the file is used to create .

It is never recommended to update the Trait Mapping file. We recommend building another project using the new Trait Mapping file. However, if it is inevitable, please contact .

You have to update the Unity Project first. Please contact . After the update, you need to export Asset Bundle again.

Have a question or an idea? If you have a question to ask or an idea to share, participate in the . We’d love to hear from you.

✍️
Avatar Selector
MYTY Kit Community
MYTY Kit Community
😄
MYTY Kit Community
240KB
ghostTraits.json.zip
archive
Trait Mapping file of Ghostsproject collection
Traits of Doodle #7973 displayed in Opensea
Using the Trait Mapping file, MYTY Kit piles the selected image layers up and shows the appearance of each PFP Avatar