Custom Cosmetics

Custom Cosmetics

Here are my links, it would mean a lot to me if you go a head and check them out:3

What is Custom Cosmetics?

This mod is a library, it by default comes with no custom cosmetics.

You must have the exact same cosmetics as another person otherwise you or they might we wearing the wrong thing!!

Guide to creating custom cosmetics

This tutorial will walk you through the step-by-step process of creating and exporting your own custom cosmetics for the game using Blender and Unity.

Prerequisites & Installation

Step 1: Install the Mod

Before starting, ensure you have the base mod installed. You can download it using your preferred mod manager (like Mod Manager or r2modman) or install it manually.

Step 1.1: Download the Blender Template

To ensure your custom 3D model fits perfectly, it is highly recommended to build it around the official reference template.

• Download the template here:
• Make sure not to export the model if you use this!!!

Step 2: Download Unity Hub

Unity Hub is required to manage your Unity versions and projects. If you don't have it, download and install it from the official Unity website.

Step 3: Install Unity 2022.3.10f1

Open Unity Hub, navigate to the Installs tab, and install version 2022.3.10f1. Note: Using the exact version is crucial to avoid compatibility and building errors.

Step 4: Install Git

The Unity package manager requires Git to fetch the toolkit. Ensure Git is installed on your system. If not, download it from

Setting Up Your Unity Project

Step 5: Create a New Project

• Open Unity Hub.
• Click New Project.
• Select the URP (Universal Render Pipeline) template.
• Name your project anything you like and click Create project.

Step 6: Install the Custom Cosmetics Package

Once your project opens, you need to import the official toolkit via Git URL:

• In the top menu, go to Window > Package Manager.
• Click the + (plus) icon in the top-left corner of the Package Manager window.
• Select Add package from git URL...
• Paste the following URL and click Add:

Importing and Preparing Assets

Step 7: Import Your Model and Textures

Drag and drop your custom 3D model file (e.g.,.fbx or.obj) and its corresponding texture files directly into the Project window (Assets folder) inside Unity.

Step 8: Preview in the Scene

Drag your model from the Project window into the SampleScene hierarchy. This allows you to verify that the model, textures, and materials are rendering exactly how you want them to look.

Configuring the Cosmetic

Step 9: Create a Cosmetic Definition

• Right-click anywhere in your Project window (Assets folder).
• Navigate to Create > Custom Cosmetics > Cosmetic Definition.

Step 10: Name the Asset

Give the newly created Cosmetic Definition file a recognizable name.

Step 11: Set the Cosmetic ID

Select the Cosmetic Definition asset and look at the Inspector window on the right:

• Locate the Cosmetic ID field.
• Enter a unique file and internal identifier (e.g., atomic-mushroom). Use lowercase letters and hyphens for best practice.

Step 12: Assign Your 3D Models

In the Inspector, you will see slots for Head, Body, and Face:

• Drag your model from the Project asset folder into the slot corresponding to where it belongs on the character.

Note: You do not need to fill all three slots. Only use multiple slots if you are creating a complex, multi-part cosmetic.*

Building and Testing In-Game

Step 13: Build the Cosmetic

With your Cosmetic Definition asset selected, click the Build Cosmetic button in the Inspector. This will compile your asset and output the final file, typically to your desktop.

Step 14: Install the Custom Cosmetic

Locate the generated cosmetic file on your desktop and drag it into your game's BepInEx/plugins folder.

Step 15: Enable Developer Tools

To easily adjust the cosmetic position in