MoreHead Bridge

Translates .hhh cosmetics (from MoreHead) into the vanilla R.E.P.O. cosmetics system, so they appear right alongside your vanilla cosmetics — same shop, same menu, same unlock flow.

Highlights

• All your .hhh cosmetics in the vanilla menu — with rarity tiers, generated icons and unlock tracking. No separate UI to learn.
• A Mini-Semibot that follows you — a tiny copy of your avatar, in your outfit, mirroring your face and visible to everyone (see below).
• Your own colors, per cosmetic — paint each item (or each material slot) its own color, with optional Cycle / Rainbow animations, all synced to other players.
• Equip more than one of the same type (two hats, several body pieces, multiple worlds).
• World cosmetics in a dedicated WORLD tab, that orbit and follow you around.
• Favorite and Hide cosmetics, search by name, and a SELECTED tab that shows only what you're wearing.
• A deep Cosmetic Customizer (Shift + click): rarity, category, tinting, jiggle physics, crown, condition flags, position offsets and Death Head behavior — all per cosmetic.
• Plays nice with everything — REPOLib is the only hard dependency; MenuLib, MoreHead, MoreHeadUtilities and BCE are all optional.

Mini-Semibot

Equip the Mini-Semibot (in the WORLD tab) to spawn a cute small copy of your avatar that follows you — dressed in your cosmetics, mirroring your facial expressions, and visible to everyone in the room.

Shift + click it in the menu to open its customizer (requires MenuLib). The options are grouped into sections:

• Placement — Position (Behind, trailing you / Front, walking ahead) and Size (Baby / Child / Teen / Junior).
• Outfit — Same As You (mirrors your live outfit, updating as you change) or Random Preset (a random saved cosmetics preset, re-rolled each time you equip it).
• Gaze — a Menu look-at (At Mouse / Copy Avatar / Still) for how it watches you in menus, and a separate In-Game gaze (Same Target / Copy Head). Idle Glance makes it softly look around when idle so it reads as "alive".
• Movement — Follow Smoothing (Off / Soft / Bouncy) for how it eases after you, Avoid Walls so it squeezes past geometry, climbs stairs and stops at ledges, Leg Speed for how fast its little legs scramble, and State Effects so it flashes when you take damage / heal / upgrade.
• Face & sound — Mouth modes: Never / Random chatter / When I Talk (tracks your live voice) / Mimic Clips (plays the voice lines the Mimic mod recorded — requires that mod), with adjustable Chatter, Voice Volume and Voice Range. Optional Footstep Sounds at its feet.
• Hands — what it carries: Clean Arm, Orb, or Orb + Light with the grabber beam (plus a Beam Color option when CustomGrabColor is installed). It auto-pulls its own Flashlight whenever yours is out.
• When you die — Death Head (slumps at your death-head), Crouch & Wait, or Hide. Hide on Kart tucks it away during the King of the Losers arena (it's cramped in there).
• Extras — show it in the facial-Expression Preview (the 5–9 keys panel), and Recapture Icon to re-photograph its menu icon with your current colors.

When you explode in an arena, the Mini-Semibot explodes too — same blast, in its own outfit colors (purely visual, hurts no one). Its outfit, colors, animated colors and behaviors are synced to other players. Every option above lives in the Shift + click customizer popup; the config file just has EnableMiniSemibot to turn the cosmetic off entirely.

Menu features

Favorites & Hidden

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

Tabs

Colors

• Open any cosmetic's color picker — bridge, vanilla or modded — to give it its own color, independent of the per-type color.
• For cosmetics with several materials, a slot selector (ALL · 1 · 2 · …) appears below the palette so you can color each material slot separately.
• An Original button restores the author's intended colors; a "C" button (custom RGB) and an "A" button (Cycle / Rainbow animation) appear when enabled in the config.
• Colors and animations are synced to other players.

Quality of life

• Hover any cosmetic to read its name; GroupCosmeticVariants can collapse some variant families (pride flags, color variants) into a single button.
• Tools dropdown: Generate Icons, Clear All Icons, and Sync Customizer (copy another player's per-cosmetic settings).
• Optionally hide the MoreHead button to use only the vanilla UI, or hide MoreHead decorations on avatars entirely.

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

Installation

1. Install via Thunderstore / r2modman (dependencies resolve automatically).
2. MenuLib is a soft dependency — install it if you want the Cosmetic Customizer / Sync Customizer UI.
3. Make sure you have some .hhh cosmetic files in BepInEx/plugins (e.g. from MoreHead or any cosmetics pack).
4. Launch the game — bridged cosmetics appear in the vanilla cosmetics menu on first load.

Credits

• Xuaun — MoreHead Bridge
• Masaicker & YurisCat — MoreHead (original mod inspiration)
• Maygik — MoreHeadUtilities
• Zehs — REPOLib
• nickklmao — MenuLib (Cosmetic Customizer UI)
• innominata — BepInEx Console Extensions (optional mod)