How to make a cosmetic or skin
9 min readASA DevKit as of November 2026 (UE 5.8.1)
A skin goes over a player's armor, weapon, creature or structure. It uses ARK's custom cosmetic system, the official route. The look swaps on each player's machine; the server only passes a number along. A hat with a ready mesh takes me about half an hour.
- You'll make: a hat, armor, costume, creature, weapon or structure skin that shows in the Cosmetics menu
- Time: half an hour for a hat; longer for anything rigged
- Level: beginner for hats; intermediate for weapon and structure skins
- You'll need: a mod set up, its Mod Data Asset, a mesh, and Wildcard's sample closest to yours
Before you start:
- Have your mod set up (Your first mod), and know its Mod Data Asset (How ARK finds your content).
- A rigged armor or costume mesh is made the same way as armor: How to make armor, steps 4 and 5.
- Open Wildcard's sample mods in the kit. KrazyCosmetics has 57 hats and some furniture. StructureCosmeticSample has a tic-tac-toe table, a party lamp and weapon racks. GlassCosmetic has a clean glass wall.
Skins and custom cosmetics
ARK has two kinds of skin, and they're built almost the same way.
| A skin in a regular mod | A custom cosmetic | |
|---|---|---|
| Installed by | the server and every player | only players who want it |
| Players get it | from an engram | in their Cosmetics menu |
| Seen by | everyone | everyone with the mod |
| Registered in | engram fields | Mod Custom Cosmetic Entries |
This page is about custom cosmetics, the route Wildcard built for skins. A regular skin item uses the same setup, plus an engram.
What a skin can and can't change
- It can change the look: meshes, materials, offsets, which body parts and hair show, and dye regions.
- It keeps the item's function. With "apply as item skin" on, the original item stays underneath.
- It can't change gameplay. The server only knows "this mod's cosmetic 3 is on this item". Stats and damage stay the original's.
- A weapon skin can't swap the weapon actor. It adds its own meshes and hides the original ones.
- Structure skins can do more. They run client-side logic, pass messages through the server and keep a little saved data. That's how the tic-tac-toe table works.
Note
The item class also has a function for a custom cosmetic's equip buff. I haven't tested what it allows.
The process
Pick the right parent. Each kind of cosmetic has a vanilla base. Make a child of it.
Show me how
You're making Parent Notes A hat or armor piece skin PrimalItemSkinGenericKrazyCosmetics' hats all sit on it A full-body costume PrimalItemSkin_FullCostumeTesthides hat, legs, gloves and boots; goes on the shirt slot An accessory PrimalItemSkin_PlayerCosmetic_Accessorya child or copy, modders report A creature costume PrimalItemCostumeGenerictick Is Item Skin; filter by tag or class (step 4) A weapon skin the weapon item itself, such as the Stone Club the client really swaps the item class (step 5) A structure skin an item on PrimalItemStructureSkinGenericand a structure on the structure-skin basesstep 6 PrimalItemSkinGenericsets the basics: item type Skin, weight 0, Is Item Skin on, and Support Drag Onto Other Item on.The kit also has "ghost" templates players always hold in their Cosmetics menu: the Custom Survivor pieces (
PrimalItemSkin_PlayerCosmetic_Helmet,_Shirtand so on, database), Custom Survivor Costume and Custom Creature Costume. Your entries remap them to your skin.Give it a look for each body. Fill Actor Class Attachment Infos, as for armor. Use the With Soft Ref components only.
Show me how
A KrazyCosmetics hat has two entries:
Entry Owner Actor Class Parent Attachment 0 PlayerPawnTest_FemaleStatic Mesh Component With Soft Ref on HatSocket1 Actorthe same mesh on HatSocket, with its own offset and scale- The order matters. The female entry goes first, Wildcard explains, because
Actorwould also match her. - Each component has its own offset and scale. The Steampunk hat sits a centimeter lower on the female head.
- Soft-reference components load the mesh only while it's worn.
- A rigged costume works like armor: skeletal meshes per body, weighted to the player.
- The order matters. The female entry goes first, Wildcard explains, because
Set the item-skin switches. These decide how the skin behaves in the inventory and on the wearer.
Show me how
Setting Value Why Can Slot off Wildcard's overview says skins misbehave on the hotbar Prevent Deposit Dropping on recommended in the same overview Dont Remove On Equip on recommended too; the ghost templates set it Item Skin Use On Item Classes the items it may go on the Grass Ghillie skin lists only the Ghillie Chestpiece Equipped Hide Other Equipment Attach Types slots to hide the full costume hides Hat, Pants, Gloves, Boots Equipment Force Hair Hiding on for full costumes Use Item Color, per region regions players can dye For a creature costume, tie it to the creature. Without a filter it would go on every creature.
Show me how
- The Rex Corrupted Costume (database) uses Equip Requires Explicit Owner
Tags =
Rex, and one skeletal mesh that copies the Rex's pose, with Use Parent Anims on. - A class works as well as a tag. A costume that only adds a hat and keeps the creature's own mesh can name
Dino_Character_BPand fit them all. - Tick Is Item Skin. Wildcard's overview says creature costumes don't work as custom cosmetics without it.
- The Rex Corrupted Costume (database) uses Equip Requires Explicit Owner
Tags =
For a weapon skin, attach your mesh and hide the original. The kit's
PrimalItem_WeaponStoneClub_TestCustomCosmeticis the pattern to copy.Show me how
It's a child of the Stone Club item (database), with:
Attachment Socket Shows in a Static Mesh Component With Soft Ref R_PickSocket, Attach To First Person Hands onfirst person another one none, Attach To Third Person Weapon Mesh on third person - Use Blueprint Equipped Notifications is on. Its Blueprint Equipped checks Is Dedicated Server. On clients only, it hides the weapon's first- and third-person meshes and turns off the third-person shadow.
- To change values on the item the skin lands on, such as its sound, use the Applying Skin Onto Item event. It runs on the skin's class default object (CDO), the shared template copy, so store nothing on the skin.
For a structure skin, copy a sample. It's two classes: a skin item and a skin structure.
Show me how
The tic-tac-toe table:
Class Parent Key settings PrimalItemStructureSkin_TicTacToeTablePrimalItemStructureSkinGenericStructure To Build = the skin structure StructureSkin_TicTacToeTableStructureCosmeticBase_MultiSwapStructure Skin Supported Structures = WoodTable; Consumes Primal Item = the skin item- Its logic overrides the structure-skin hooks: BP Structure Skin Get Multi Use Entries, Client Do Multi Use, Timer Triggered and Blueprint Draw HUD.
- Skin logic runs on the CDO. Work on the structure passed in, never on the skin's own variables.
- Placing structures and their menus: How to make a custom structure and How to make UI.
Register it in the Mod Data Asset. Add one entry to Mod Custom Cosmetic Entries. A custom cosmetic needs no engram.
Show me how
Field What goes in it Custom Cosmetic Skin Descriptive Name a note for you; players never see it Cosmetic ID a number unique among entries that apply to the same class Apply To Classes the classes it may replace Mod Skin Item your skin item Mod Skin Structure your skin structure; structure skins only Cosmetic Apply As Item Skin on for hats, armor, costumes and creature costumes; off for weapons and structures What goes in Apply To Classes, from the samples and modders' reports:
Kind Apply To Classes Hat PrimalItemArmor_BaseHelmet(every KrazyCosmetics hat)Full costume PrimalItemSkin_PlayerCostume_CustomandPrimalItemArmor_BaseShirt, in one entryAccessory PrimalItemArmor_BaseAccessoryandPrimalItemSkin_PlayerCosmetic_Accessory; both are neededCreature costume the creature class and PrimalItemDinoCostume_CustomStructure skin PrimalItemStructureSkinGenericfirst, then the structure (orPrimalStructure)- KrazyCosmetics numbers its 67 entries from 8 to 1010. Any scheme works if entries on one class never share an ID.
- The PrimalGameData can stay blank, Wildcard says. Modders still set the World Settings override to test structure skins in PIE.
- Save and compile after editing, and mind the cache: The cache trap.
Upload it as a custom cosmetic and test the real build. Pick the custom cosmetics category. Then test it from My Mods in single player.
Show me how
- PIE shows some cosmetics, but not all. Modders report accessory cosmetics only work in the live game.
- Link your game account to CurseForge, and the unpublished mod shows in My Mods. Custom cosmetics activate on their own; you don't add them to a world. Your first mod has the steps.
- A server shows only the custom cosmetics it allows. For your own test server, see the CosmeticWhitelistOverride setting.
How the pieces connect
| This asset | Field | Points at |
|---|---|---|
| Mod Data Asset | Apply To Classes | what it replaces |
| Mod Data Asset | Mod Skin Item, Mod Skin Structure | your skin classes |
| Skin item | Actor Class Attachment Infos | your meshes, per body |
| Skin structure | Structure Skin Supported Structures | the vanilla structure |
Common mistakes
It doesn't appear in the Cosmetics menu
It has no Mod Custom Cosmetic Entries row, or the Mod Data Asset wasn't saved and compiled. An engram won't help. Check the entry, then the cache trap.
It goes in the slot but shows the plain Custom Survivor look
Apply To Classes misses a class. An accessory needs both the accessory base and the accessory template (step 7).
Players can only pick one of my two cosmetics
Two entries on the same class share a Cosmetic ID. Number them 0, 1, 2 and so on.
My copy of a working cosmetic never shows up
A modder's duplicated boots skin never appeared, even with new IDs and cleared caches. Nobody found the cause. I'd make each skin a child of a shared base, as KrazyCosmetics does.
The hat sits wrong on female survivors
The female entry is missing or comes after the catch-all. Put it first, with its own offset.
My creature costume goes on every creature, or on none
It needs Is Item Skin and a tag or class filter (step 4). Modders also needed PrimalItemDinoCostume_Custom in
Apply To Classes.
My weapon skin shows both meshes
The original meshes aren't hidden on equip. Copy the Stone Club test cosmetic's Blueprint Equipped (step 5).
My bow skin works in single player, not on a dedicated server
Modders report bows are the one weapon this method fails for on dedicated servers. No fix was posted.
It works in single player but not on a server
The server doesn't allow your cosmetic. Its owner has to allow it (step 8).
It showed in PIE, but it's missing in the cooked build
A modder hit this with a structure skin; nobody answered. Read the cook log: When a cook or upload fails.
Dyeing broke on my structure skin tileset
The tileset's Color Regions was filled in. Modders found leaving it empty keeps the defaults.
Check it worked
- In the cooked build, the skin is in the Cosmetics menu with your icon and name.
- It goes on the items you meant, and refuses the rest.
- It looks right on male and female survivors, and on creatures if it should.
- The original item still works, and dyes recolor the regions you allowed.
- A friend without the mod sees the vanilla item; a friend with it sees your skin.
Watch
- ARK Dev Kit GameFramework & Custom Cosmetics Overview (Studio Wildcard). 18:08 how custom cosmetics work. 22:11 the Mod Data Asset entry and "apply as item skin". 28:02 the hats, female entry first, and soft-reference components. 33:07 the item-skin switches. 38:30 one entry for costume and shirt. 40:11 creature costumes. 45:27 item and weapon skins. 57:13 the Stone Club weapon skin. 1:02:24 structure skins.
- How to Make an ARK ASA Mod (Complete Beginner Guide) (my video). 39:53 testing an unpublished mod from My Mods.
Go deeper
- What the video tutorials teach §1: the whole custom cosmetics system, with Wildcard's rules.
- How to make armor, for rigged meshes, body masks and per-body entries.
- How ARK finds your content, the cosmetics fields.
- The player's view: skins and cosmetics.
- Modders point to the Love Ascended cosmetic assets in the kit as commented examples of structure-skin logic.
Sources
- DevKit files, read offline on 2026-11-06: Wildcard's samples KrazyCosmetics, StructureCosmeticSample and
GlassCosmetic (their Mod Data Assets and skins); the vanilla skin, costume and structure-skin bases, the Custom
Survivor and Custom Creature templates, the Stone Club test cosmetic and a few vanilla skins; and
PrimalItem's reflected settings and events. - Wildcard's overview, listed under Watch (February 2024), and its summary in What the video tutorials teach §1.
- Community knowledge from the ARK Modding Community Discord (discussions from February 2025 to October 2026, mainly #asa-general, #asa-blueprints, #asa-references and #asa-materials), found with Overseer. What modders report is flagged in the text. Threads that helped (they open for server members): skin mod or custom cosmetic (December 2025), a cosmetic missing from the menu (December 2025), accessory cosmetics (May 2026), a duplicated cosmetic that won't register (June 2026), creature costume classes (October 2026), bow skins on dedicated servers (April 2025), a server not showing a cosmetic (February 2025), missing after the cook (August 2025), commented examples in the kit (March 2026), tileset Color Regions (July 2025).
Where this page's information comes from
Applies to: ASA DevKit as of November 2026 (UE 5.8.1)
Wildcard's cosmetic samples in the DevKit, Wildcard's custom cosmetics overview, the community Discord (see Sources)