MoreHead Bridge

Translates .hhh cosmetics (from MoreHead) into the vanilla R.E.P.O. cosmetics system, so they appear alongside your vanilla cosmetics in the game.

What does it do?

• Scans BepInEx/plugins for .hhh files and registers them as vanilla cosmetics
• Cosmetics show up in the vanilla shop with rarity tiers, icons, and unlock tracking
• Auto-unlocks all bridge cosmetics on game start (configurable)
• Supports every cosmetic type including World cosmetics
• Favorite your preferred cosmetics and hide the ones you're not interested in - and easily find them in their own tabs in the cosmetics menu
• Equip multiple cosmetics of the same type, each one can have its own individual color
• Search cosmetics or view all the equipped cosmetics
• Hover over a cosmetic item to see its name
• Automatically removes physics components and fixes animation looping on bridge cosmetics at load time (configurable)
• Optional: hide the MoreHead button if you prefer to use only the vanilla UI
• Optional: change the rarity or category per-cosmetic

Menu features

Favorites & Hidden

• Ctrl + click any cosmetic to toggle it as a favorite
• Alt + click any cosmetic to hide it from the menu
• Dedicated FAV and HIDE tabs appear in the category strip
• Hidden cosmetics are excluded from other categories and Randomize buttons

New tabs

Cosmetic Customizer

Shift + click any bridge cosmetic to open a per-cosmetic override popup where you can change:

• Rarity — Common, Uncommon, Rare, UltraRare
• Category — Hat, Eyewear, Face Upper, Bodywear Top, World, and more
• Modded highlight — force the orange border on or off per cosmetic

Overrides are saved to BepInEx/config/MoreHeadBridge_CosmeticOverrides.json and applied automatically on every launch.

Please note that changing the cosmetic category is only a local change and may alter the bone in which the cosmetic appears for you.

To enable it, change the EnableCosmeticOverrideUI = true in the config file (default: false)

How icons work

Since .hhh cosmetics don't have built-in icons, the mod generates one for each cosmetic using the following fallback chain:

1. Placeholder — a generic icon is generated so the cosmetic slot is never blank in the menu
2. Texture overlay — if the cosmetic has a texture, it is applied on top of the placeholder as a preview (can be disabled via UseTextureAsPlaceholder)
3. Captured icon — once you hover the cosmetic in the menu, the mod snapshots the in-game avatar preview and saves a PNG icon, which replaces the placeholder permanently

Tip for best results: Before generating icons, remove all cosmetics from your Semibot (vanilla and MoreHead), set it to a neutral color, and make sure it is facing forward. This gives each icon the cleanest background possible. If an icon doesn't look right, you can delete it individually using DeleteIconsMatching in the config, or wipe all icons at once with DeleteIconCache.

Slot mapping

Since the vanilla cosmetics menu has more specific slots than MoreHead, the following mapping is used:

Installation

1. Install via Thunderstore / r2modman (dependencies will be resolved automatically).
2. Launch the game — MoreHead bridged cosmetics will appear in the vanilla cosmetics menu on first load.

Configuration

Config file: BepInEx/config/Xuaun.MoreHeadBridge.cfg

General

Appearance

Icons

Cosmetic Customizer

Compatibility

Reset

Debug

Icon cache location

Icons are stored outside the vanilla cosmetics cache (which REPOLib wipes on every launch):

%userprofile%\AppData\LocalLow\semiwork\REPO\Cache\Icons\CosmeticsModded\MoreHeadBridge_CosmeticsIcons\

Delete this folder manually to wipe all generated icons, or use the DeleteIconCache config option.

Upgrading from v1.0.0? The icon cache was previously stored at MoreHeadBridge_Icons\ in the same root. The mod migrates existing icons automatically on first launch — no manual action needed.

Colorful console (optional)

If you have BepInEx Console Extensions (BCE) installed, MoreHead Bridge will use it to print colored messages in the BepInEx console. It is a soft dependency - the mod works perfectly without it - but if you like a more lively terminal, you can install BCE manually and drop it in your plugins folder.

I think that colors make the console feel more human and I love it! lol

Credits

• Xuaun — MoreHead Bridge
• Masaicker & YurisCat — MoreHead (original mod)
• Maygik - MoreHeadUtilities
• Zehs — REPOLib
• innominata — BepInEx Console Extensions (optional mod)

v2.2.0

Compatibility

• New option FixBridgedCosmetics (default: true, in the [Compatibility] config section) — automatically fixes common asset issues on bridge cosmetics at load time, applied directly to the prefab so every instance inherits the fix:
  • Removes Collider and Rigidbody components — eliminates the character-rotation bug in the cosmetics preview menu caused by cosmetics with physics components
  • Forces Animation clips to loop — cosmetics that only played once now loop correctly
  • Adds software-loop support for Animator-driven clips whose controller states are not marked as Loop Time
• At load time the mod now detects whether a bridge cosmetic uses PartShrinker (body-part hiding from MoreHeadUtilities) and logs whether it is active or whether MoreHeadUtilities needs to be installed

Dependencies

• MoreHead is no longer a required dependency — MoreHead Bridge works standalone and treats MoreHead as optional
  • Someone asked me if I could remove this hard dependency on MoreHead - so I did it in this version
  • But you still need the .hhh cosmetic files to load in-game - so I recommend keeping the mods to use them

v2.1.0

Features / Fixes

• Individual color sync (working correctly) in multiplayer — other players now see the correct individual colors you have set per cosmetic
• Updated the RepoLIB version dependency (4.0.3 -> 4.0.4)

Bug fixes

• Clothing not appearing after the first Confirm in multiplayer
• Reset All leaving the old outfit all white on the remote instead of clearing correctly
• Virtual tabs (FAV, HIDE, SEARCH, SELECTED) displaying "new" badges incorrectly
• Painting a cosmetic individually sometimes had strange behavior
• Loading multiple painted cosmetics from a saved outfit in the preset menu now correctly colors the cosmetics

v2.0.0

World Cosmetics

• .hhh cosmetics with the World tag are now fully supported — they appear in the vanilla menu under a dedicated WORLD category button
• World cosmetics (internally - hats) render independently of hats (no slot conflict), with correct highlight counters, and equip/unequip actions

Multiple Cosmetics

• You can now equip multiple cosmetics of the same type simultaneously
• Configurable via AllowMultipleCosmetics (default: true)

Favorites & Hidden

• Ctrl + click any cosmetic to toggle it as a favorite
• Alt + click any cosmetic to hide it from the menu
• Dedicated FAV and HIDE category tabs show only favorited / hidden cosmetics
• Hidden cosmetics are excluded from other categories and Randomize buttons
• Saved persistently to MoreHeadBridge_Favorites.json

Cosmetic Customizer

• Shift + click any bridge cosmetic to open a per-cosmetic override popup
• Override rarity tier, category (Hat, BodyTop, World, …), and modded-highlight flag individually
• Please note that changing the cosmetic category is only a local change and may alter the bone in which the cosmetic appears for you
• Overrides are saved to MoreHeadBridge_CosmeticOverrides.json and applied on every launch
• Enable via EnableCosmeticOverrideUI = true (default: false)

New Menu Tabs

• SEARCH — live search bar filters cosmetics by name as you type; position configurable (Top / Bottom)
• You can see the names of the cosmetics (to search) now by hovering over them.
• SELECTED — shows only currently equipped cosmetics; updates after Randomize / Reset

Visual

• Bridge cosmetics now show an orange border in the menu to distinguish them from vanilla cosmetics (configurable via HighlightModdedCosmetics)
• Default rarity tier for bridge cosmetics is now separately configurable (DefaultRarity)

Icon Generation

• Icon cache moved to Cache/Icons/CosmeticsModded/MoreHeadBridge_CosmeticsIcons/ — sits outside REPOLib's wipe zone; automatic migration from the old path on first launch

v1.0.0

• MoreHead Bridge initial release