Modding guide

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

  1. 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 PrimalItemSkinGeneric KrazyCosmetics' hats all sit on it
    A full-body costume PrimalItemSkin_FullCostumeTest hides hat, legs, gloves and boots; goes on the shirt slot
    An accessory PrimalItemSkin_PlayerCosmetic_Accessory a child or copy, modders report
    A creature costume PrimalItemCostumeGeneric tick 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 PrimalItemStructureSkinGeneric and a structure on the structure-skin bases step 6

    PrimalItemSkinGeneric sets 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, _Shirt and so on, database), Custom Survivor Costume and Custom Creature Costume. Your entries remap them to your skin.

  2. 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_Female Static Mesh Component With Soft Ref on HatSocket
    1 Actor the same mesh on HatSocket, with its own offset and scale
    • The order matters. The female entry goes first, Wildcard explains, because Actor would 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.
  3. 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
  4. 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_BP and fit them all.
    • Tick Is Item Skin. Wildcard's overview says creature costumes don't work as custom cosmetics without it.
  5. For a weapon skin, attach your mesh and hide the original. The kit's PrimalItem_WeaponStoneClub_TestCustomCosmetic is 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 on first 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.
  6. 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_TicTacToeTable PrimalItemStructureSkinGeneric Structure To Build = the skin structure
    StructureSkin_TicTacToeTable StructureCosmeticBase_MultiSwap Structure 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.
  7. 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_Custom and PrimalItemArmor_BaseShirt, in one entry
    Accessory PrimalItemArmor_BaseAccessory and PrimalItemSkin_PlayerCosmetic_Accessory; both are needed
    Creature costume the creature class and PrimalItemDinoCostume_Custom
    Structure skin PrimalItemStructureSkinGeneric first, then the structure (or PrimalStructure)
    • 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.
  8. 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

  1. In the cooked build, the skin is in the Cosmetics menu with your icon and name.
  2. It goes on the items you meant, and refuses the rest.
  3. It looks right on male and female survivors, and on creatures if it should.
  4. The original item still works, and dyes recolor the regions you allowed.
  5. A friend without the mod sees the vanilla item; a friend with it sees your skin.

Watch

Go deeper

Sources

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)

Esc

↑ ↓ move↵ openCtrl ↵ new tab