MoreHead

All models were created by Yuri's cat Calypso, specifically for this mod:3

All models made by Yuri's cat Calypso for this mod: 3

Introduction Introduction

A simple and fun decoration mod that provides a unitypackage for players to import custom models.

Currently, only a few decorations are available, but more updates are planned.

nickklmao-MenuLib mod is required as a prerequisite.

if you encounter strength loss problems, please download the fixstrength mod.

A simple and fun decoration module that provides unitypackage for players to import custom models.

There are currently only a few decorations and will continue to be updated in the future.

nickklmao-MenuLib front-end module needs to be installed.

If you are experiencing strength loss issues, download the fixstrength mod.

*The chicken beak in the screenshot comes from EvenMoreHead.

How to Use How to use

• Install this mod and enter the game.
• You can find the "MoreHead" button in the bottom left corner either in the lobby or after entering a level (press ESC).
• Click the button to switch cosmetics.

• Install this module and enter the game.
• You can find the "MoreHead" button in the lower left corner by pressing ESC during the lobby preparation stage or after officially entering the level.
• Click the button to switch cosmetics.

⚠️ Compatibility Notice Compatibility Note ⚠️

Click to see Click to expand

With MenuLib updated to 2.1.3, MoreHead must be updated to 1.3.0 or later to function properly.

⚠️ If you are still using MoreHead 1.2.8 or earlier, please keep MenuLib at 2.1.1 or earlier to avoid compatibility issues.

For the best experience and stability, we recommend always using the latest version.

MenuLib has been updated to 2.1.3, so MoreHead needs to be upgraded to 1.3.0 or higher to function properly.

⚠️ If you are still using MoreHead 1.2.8 or earlier, please make sure MenuLib is still 2.1.1 or earlier, otherwise compatibility issues may occur.

To ensure the best experience and stability, it is recommended to always use the latest version.

Previously: previous version

MenuLib 2.0.0 → MoreHead 1.2.8+ required.

MenuLib 1.0.3 → MoreHead 1.1.8+ required.

MenuLib 2.0.0 → Requires MoreHead version 1.2.8+.

MenuLib 1.0.3 → Requires MoreHead version 1.1.8+.

Configuration Options Configuration Options

Click to see Click to expand

English

MoreHead provides several configuration options that can be modified in the BepInEx configuration file (BepInEx/config/Mhz.REPOMoreHead.cfg):

UI Settings

| Option | Description | Default |

| --- | --- | --- |

| EscButtonPosX | X position of MoreHead button in ESC menu | 0 |

| EscButtonPosY | Y position of MoreHead button in ESC menu | 0 |

| LobbyButtonPosX | X position of MoreHead button in lobby | 0 |

| LobbyButtonPosY | Y position of MoreHead button in lobby | 0 |

Adjusting these values allows you to reposition the MoreHead buttons if they conflict with other mod UI elements.

Blacklist Mode

| Option | Description | Default |

| --- | --- | --- |

| BlacklistMode | Set to "ENABLE_BLACKLIST" to enable blacklist functionality | "" (disabled) |

When blacklist mode is enabled:

• Use Shift + click on decoration buttons to add/remove items from the blacklist
• Use Shift + CLEAR ALL to clear the entire blacklist at once
• ⚠️ All blacklist changes take effect after restarting the game

Blacklisted decorations won't appear in your decoration menu, which is useful for hiding items you don't want to use.

💡It's recommended that one player manages the blacklist and shares it via mod code or the BepInEx/config/MoreHeadBlacklist.json file to ensure appearance sync in multiplayer.

💡Before sharing, make sure to disable Blacklist Mode (clear the config value) to prevent unintended changes from other players.

Logging

| Option | Description | Default |

| --- | --- | --- |

| EnableVerboseLogging | Enable detailed logs for model loading | false |

Enable this option to see more detailed logs about model loading process, helpful f …