Translates .hhh cosmetics (from MoreHead) into the vanilla R.E.P.O. cosmetics system, so they appear alongside your vanilla cosmetics in the game.
BepInEx/plugins for .hhh files and registers them as vanilla cosmetics| Tab | Description |
|---|---|
| SEARCH | Live search bar — filters cosmetics by name as you type |
| SELECTED | Shows only your currently equipped cosmetics |
| WORLD | Shows world cosmetics in their own category |
| FAV | Shows only favorited cosmetics |
| HIDE | Shows only hidden cosmetics |
Shift + click any bridge cosmetic to open a per-cosmetic override popup where you can change:
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
bonein which the cosmetic appears for you.To enable it, change the
EnableCosmeticOverrideUI = truein the config file (default:false)
Since .hhh cosmetics don't have built-in icons, the mod generates one for each cosmetic using the following fallback chain:
UseTextureAsPlaceholder)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
DeleteIconsMatchingin the config, or wipe all icons at once withDeleteIconCache.
Since the vanilla cosmetics menu has more specific slots than MoreHead, the following mapping is used:
| MoreHead | Vanilla |
|---|---|
| Head | Hat |
| Neck | Face Lower |
| Body | Bodywear Top |
| Hip | Bodywear Bottom |
| Left Arm | Armwear Left |
| Right Arm | Armwear Right |
| Left Leg | Legwear Left |
| Right Leg | Legwear Right |
| World | World (dedicated WORLD category) |
Config file: BepInEx/config/Xuaun.MoreHeadBridge.cfg
| Option | Default | Description |
|---|---|---|
| UnlockAll | true |
Auto-unlock all bridge cosmetics on every game load. Set to false to require earning them like vanilla cosmetics. |
| AllowMultipleCosmetics | true |
Allow equipping multiple cosmetics of the same type simultaneously (e.g. two hats). |
| HideMoreHeadButton | false |
Remove the MoreHead button from all menus. Requires restart. |
| SpecificFolders | (empty) | Comma-separated subfolder names under BepInEx/plugins to scan for .hhh files. Empty = scan all. Example: Some-MoreHeadPack,Another-Pack. |
| SearchFieldPosition | Top |
Where the search bar appears in the cosmetics menu. Top = above the category strip. Bottom = at the bottom of the Semibot. |
| Option | Default | Description |
|---|---|---|
| HighlightModdedCosmetics | true |
Show an orange border on bridge cosmetics in the menu to distinguish them from vanilla ones. Per-cosmetic overrides (Cosmetic Customizer) take priority. |
| DefaultRarity | Common |
Rarity tier assigned to bridge cosmetics. Controls sort position in the menu. Values: Common, Uncommon, Rare, UltraRare. Per-cosmetic overrides take priority. |
| Option | Default | Description |
|---|---|---|
| UseTextureAsPlaceholder | true |
Use the cosmetic's texture as the icon placeholder until a captured icon replaces it. |
| AutoCaptureIcons | true |
Reactively capture icons as you hover cosmetics in the menu. Icons are saved as PNGs and reused on future visits. |
| GenerateAllIcons | false |
One-shot trigger. When true, the next menu open cycles through all bridge cosmetics without a cached icon and snapshots each one. Auto-resets to false. Can take a few minutes. |
| Option | Default | Description |
|---|---|---|
| EnableCosmeticOverrideUI | false |
Enable the Shift + click popup to override rarity, category, and modded flag per cosmetic. Requires MenuLib. |
| Option | Default | Description |
|---|---|---|
| ResetUnlocks | false |
⚠ Destructive one-shot trigger. Removes all bridge cosmetics from your unlocks, outfits, and history on next launch. Auto-resets to false. |
| ResetCosmeticCustomizer | false |
One-shot trigger. Clears all per-cosmetic overrides and deletes MoreHeadBridge_CosmeticOverrides.json on next launch. Auto-resets to false. |
| DeleteIconCache | false |
One-shot trigger. Deletes cached bridge icon PNGs on the next launch. Use DeleteIconsMatching to filter which ones. Auto-resets to false. |
| DeleteIconsMatching | (empty) | Optional filter for DeleteIconCache. Comma-separated substrings matched against icon filenames (case-insensitive). Empty = delete all. |
| Option | Default | Description |
|---|---|---|
| ShowBridgeDebugLogs | false |
Show detailed debug logs for bridge-specific events. |
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.
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