You are viewing a potentially older version of this package. View all versions.
YMC_MHZ-MoreHead-1.1.3 icon

MoreHead

Customizable cosmetics. 简单好玩的装饰模组,提供unitypackage,供玩家自行导入模型。

Date uploaded a year ago
Version 1.1.3
Download link YMC_MHZ-MoreHead-1.1.3.zip
Downloads 141
Dependency string YMC_MHZ-MoreHead-1.1.3

This mod requires the following mods to function

nickklmao-MenuLib-2.5.2 icon
nickklmao-MenuLib

A library for creating UI!

Preferred version: 2.5.2

README

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.

简单好玩的装饰模组,提供 unitypackage,供玩家导入自定义模型。
目前仅有少量装饰,未来会持续更新。
需安装 nickklmao-MenuLib 前置模组。





How to Use 如何使用

  1. Install this mod and enter any game match.
  2. Press ESC > Find "MoreHead" in the bottom left > Click to switch components.

  1. 安装本模组,进入游戏战局。
  2. ESC > 在左下角找到 "MoreHead" > 点击切换部件。




How to Add Models 如何添加模型

Click to expand for detailed instructions.

点击展开具体说明。

Click to see 点击展开

English Tutorial

  1. Set up Unity (2022.3* recommended, the game uses built-in render pipeline, please pay attention to the corresponding model materials), import MoreHead-Asset-Pack_v*.*.unitypackage.

    📥 Download unitypackage

  2. Import your model and drag PlayerAvatar prefab into the scene.

    Make sure your model is compatible with Unity and properly rigged if animated.

  3. Find the following parts in PlayerAvatar, where models will be placed:

    Name Description Tag
    Head decoration (Do Not Move) Head part that raises when speaking head
    Neck decoration (Do Not Move) Chin/chest area neck
    Body decoration (Do Not Move) Body body

    ⚠️ These positions are anchor references. DO NOT modify coordinates, or your model will be misaligned in-game.

  4. Create an empty object under the target part (referred to as A) and name it.

    This name will be displayed in-game as your decoration's name.

  5. Place your model inside A and adjust to a suitable position.

  6. Drag A to the Project window to create a prefab.

  7. Run Tools → Head Decorations Builder, drag your A prefab (or more, batch export is supported) into the script panel, and select the corresponding part from step 3, then click Add Model to List.

    Make sure to select the correct body part (head/neck/body) that matches where you placed your decoration.

  8. Click Build All AssetBundle, then locate the [your decoration name].hhh file in the AssetBundles folder.

    Only the .hhh file is needed for installation. Other generated files can be ignored.

  9. Move the .hhh file to BepInEx\plugins (recommended: place it in \MoreHead\Decorations for better organization).

    ⚠️ For multiplayer visibility: You and your friends must have the same .hhh file installed to see the correct decorations.

  10. Start the game and enjoy!

    Press ESC in-game and find "MoreHead" in the bottom left to access your new decoration.


中文教程

  1. 部署 Unity(推荐 2022.3* 版本,游戏使用的是内置渲染管线,请注意对应的模型材质),导入 MoreHead-Asset-Pack_v*.*.unitypackage

    📥 下载 unitypackage

  2. 导入模型,并将 PlayerAvatar 预制体拖入场景

    确保您的模型与Unity兼容,如果有动画需要正确绑定骨骼。

  3. 找到 PlayerAvatar 中的以下部位,对应模型将会摆放的位置

    名称 描述 标签
    Head decoration (Do Not Move) 说话时会上抬的头部 head
    Neck decoration (Do Not Move) 下巴/胸口 neck
    Body decoration (Do Not Move) 身体 body

    ⚠️ 这些位置是坐标锚点参考。请勿修改坐标,否则您的模型在游戏中会错位。

  4. 在目标部位下创建一个空对象(称为A),并命名

    此名称将在游戏中显示为您的装饰品名称。

  5. 将模型放入A,并调整到合适位置

  6. 拖动A到Project窗口,创建预制体

  7. 运行Tools → Head Decorations Builder,拖入A预制体(或更多,支持批量导出),并选择第3步中对应的部位,随后点击Add Model to List

    确保选择正确的身体部位(头部/颈部/身体),与您放置装饰的位置相匹配。

  8. 点击Build All AssetBundle,然后在AssetBundles文件夹中找到[你的装饰品名].hhh文件。

    安装时只需要.hhh文件,其他生成的文件可以忽略。

  9. .hhh文件移动至BepInEx\plugins(建议放入\MoreHead\Decorations便于管理)。

    ⚠️ 多人游戏可见性:您和您的朋友必须安装相同的.hhh文件才能互相看到正确的装饰。

  10. 启动游戏,享受装饰!

    在游戏中按ESC,在左下角找到"MoreHead"即可访问您的新装饰。



Future Update Plans 未来更新计划

  • More hats

  • Screenshots for decorations to assist selection (not guaranteed)

  • 更多的帽子

  • 为装饰物提供截图,方便选择 (不保证)



Author Information 作者信息

Masaicker 马赛克了:BILIBILI
YurisCat Calypso 尤里的猫·卡里普索:BILIBILI

For questions and suggestions, submit issues:
如有问题和建议,请提交 Issues:GitHub Issues

Want to support us with coffee and yellow energy crystals?
想请我们喝咖啡和购买黄色能量水晶?
Donate on Ko-Fi

Whispering, we are making an indie game!
悄悄说一句,我们正在制作独立游戏!

CHANGELOG

v1.4.5

  • 已装备的装饰品会在重新打开列表时置顶,方便查看当前装备且避免点击后列表立即跳动造成误触
  • 修复头部装饰品节点路径,适配新的头部骨骼结构
  • Equipped cosmetics now move to the top when reopening the list, making current outfit pieces easier to find without causing the list to jump immediately after clicking
  • Fixed the head decoration node path for the updated head rig hierarchy

v1.4.4

  • 优化搜索功能:搜索时忽略空格,实现双向模糊匹配(搜"small flag"可输入"smallflag",反之亦然)
  • Improved search: spaces are ignored for bidirectional fuzzy matching (search "small flag" by typing "smallflag", and vice versa)

v1.4.3

  • 修复MenuLib移除MenuScrollBox.Update IL hook后产生的滚动交互问题
  • 添加搜索框功能
  • 修复输入框退格键延迟累积导致的乱码问题
  • Fixed scrolling interaction issues after MenuLib removed MenuScrollBox.Update IL hook
  • Added search box
  • Fixed backspace key input corruption caused by delay accumulation

v1.4.2

  • 添加了fixstrength模组的链接到README
  • Added fixstrength mod link to README

v1.4.1

  • 黑名单模式(Blacklist Mode):可通过配置项启用(设置为 "ENABLE_BLACKLIST"
  • 支持通过 Shift + 点击化妆品按钮 添加或移除黑名单项目
  • 支持使用 Shift + CLEAR ALL 快速清空所有黑名单条目
  • 所有黑名单相关更改需重启游戏后生效
  • 推荐由一名玩家维护黑名单,通过分享模组代码或直接发送 BepInEx/config/MoreHeadBlacklist.json 文件,以保证多人游戏时外观同步
  • 分享前请务必关闭黑名单模式(清空配置项字符串),以避免其他玩家误触导致数据不同步
  • Blacklist Mode: can be enabled via config (set to "ENABLE_BLACKLIST")
  • Supports Shift + click on cosmetic buttons to add or remove blacklist entries
  • Supports Shift + CLEAR ALL to quickly clear all blacklist entries
  • All blacklist changes take effect after restarting the game
  • 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

v1.4.0

  • 压缩了网络传输数据,略微提高了联机性能
  • Compressed network data to slightly improve multiplayer performance

v1.3.11

  • 减少了中文字符导致的乱码显示以及控制台不断警告提示的问题
  • Reduced garbled text and console warnings caused by Chinese characters

v1.3.10

  • 新增配置选项,可自定义ESC菜单和大厅按钮的位置坐标
  • Added config options to customize button position in ESC menu and lobby

v1.3.9

  • 将装备方案切换快捷键从Ctrl+1-5改为F1-F5
  • Changed outfit switching shortcuts from Ctrl+1-5 to F1-F5

v1.3.8

  • 在游戏大厅添加了MoreHead按钮
  • Added MoreHead button to the lobby

v1.3.7

  • 新增:在界面右侧添加五个快速换装按钮,并支持使用Ctrl+1到Ctrl+5快捷键在游戏中随时切换装备方案
  • Added five quick switching buttons on the right side of the interface and keyboard shortcuts (Ctrl+1 to Ctrl+5) for switching outfits anytime during gameplay

v1.3.6

  • 添加模型日志配置选项(默认开启)
  • 优化标签按钮布局与间距
  • Added model logging config option (enabled by default)
  • Improved tag button layout and spacing

v1.3.5

  • 添加 "LIMBS" 主标签,支持手脚部位装饰品的统一管理
  • 提供对应 v1.3 的 UnityPackage,支持直接配置四肢相关子标签(leftarm, rightarm, leftleg, rightleg)
  • Added "LIMBS" main tag for unified management of arm and leg cosmetics
  • Updated the v1.3 UnityPackage with direct support for limb-related tags (leftarm, rightarm, leftleg, rightleg)

v1.3.4

  • 修复了将版本号识别为模组名称的问题
  • 修复打开改变颜色窗口时,出现多个模型重叠的问题
  • Fixed version numbers being incorrectly identified as mod names
  • Fixed the issue where multiple character models overlap when opening the color change window

v1.3.3

  • 修复了退出场景时空引用的问题
  • Fixed null reference issue when exiting a scene

v1.3.2

  • 悬停装饰品按钮时显示模组来源
  • 点击当前标签页返回顶部(1.3.0 新增)
  • Show mod names when hovering over decoration buttons
  • Click the current tab to return to the top (added in 1.3.0)

v1.3.1

  • 添加了一顶Nick'sHat,感谢nick制作的menulib模组,为社区带来便利
  • Added Nick's Hat. Thanks to Nick for creating the MenuLib mod, bringing convenience to the community.

v1.3.0

  • 依赖 MenuLib 2.1.3,本版本及以后不再兼容 MenuLib 早期版本
  • 优化了UI界面的响应速度
  • 修复了一些小问题
  • Now requires MenuLib 2.1.3. Starting from this version, earlier versions of MenuLib are no longer supported.
  • Optimized UI interface response speed
  • Fixed some minor issues

v1.2.8

  • 依赖 MenuLib 2.0.0,本版本及以后不再兼容 MenuLib 1.x
  • 修复因 MenuLib 2.0.0 更新导致的兼容性问题,确保 Morehead 正常工作
  • Now requires MenuLib 2.0.0. Starting from this version, MenuLib 1.x is no longer supported.
  • Fixed compatibility issues caused by the MenuLib 2.0.0 update to ensure Morehead functions properly.

v1.2.7

  • 修复单人模式依然能看到 world 标签装饰品的问题
  • Fixed the issue where world-tagged cosmetics were still visible in single-player mode.

V1.2.6

  • 修复了因 world 标签的装饰品导致的翻滚动画异常,以及角色无法完全倒下的问题。特别感谢 AnzunoHagi 朋友的测试,以及多位玩家的问题反馈
  • Fixed the issue where decorations with the "world" tag caused ragdoll rolling animation errors and prevented the character from fully falling down. Special thanks to AnzunoHagi for testing and to multiple players for their feedback.

v1.2.5

  • 按钮现在已按字母顺序(A-Z)排序
  • The buttons are now sorted in alphabetical order (A-Z).

v1.2.4

  • 新增公开API接口,支持扩展功能
  • 添加模型和资源追踪系统,允许开发者注入自定义脚本
  • 支持将AssetBundle作为嵌入式资源加载
  • 详情请查看README.md中的"开发者API与扩展"部分
  • Added public API interfaces for extensions
  • Added model and resource tracking system for custom scripts
  • Added support for loading AssetBundles as embedded resources
  • For details, see the "Developer API & Extension" section in README

v1.2.3

  • 添加"hip"父级标签,支持在臀部/下半身位置添加装饰品
  • 优化body部位装饰品,现在会随角色变矮而同步压缩
  • 优化world装饰品位置,避免在第一人称视角中看到
  • Added "hip" parent tag for decorations on hip/lower body area
  • Improved body decorations to scale with character height
  • Optimized world decorations to be invisible in first-person view

v1.2.2

  • 添加标签筛选功能,可按类型查看装饰品
  • Added tag filtering to view decorations by type

v1.2.1

  • 添加"world"父级标签,装饰品跟随角色位置但保持水平方向
  • 更新AssetBundleBuilder工具支持"world"标签
  • Added "world" parent tag for horizontal orientation
  • Updated AssetBundleBuilder tool for "world" tag support

v1.2.0

  • 更改装饰品数据保存位置
  • 添加清空所有装饰按钮
  • Changed cosmetic data save location
  • Added clear all accessories button

v1.1.10

  • 添加了十六夜的发型和一把小旗子。
  • 1.1.9的readme文件出了点问题,我们重新上传了一份。
  • Added Sakuya Izayoi's hairstyle and a small flag
  • There was an issue with the readme file for version 1.1.9, so we re-uploaded a new one.

v1.1.9

  • 优化部分代码,略微提升一点点性能
  • Optimized some code for a slight performance improvement.

v1.1.8

  • 依赖 MenuLib 1.0.3,本版本及以后不再兼容 MenuLib 1.0.2
  • Now requires MenuLib 1.0.3. Starting from this version, MenuLib 1.0.2 is no longer supported.

v1.1.7

  • 添加了创可贴、特殊的头发和"盲视"
  • Added band-aids, special hair, and blind vision.

v1.1.6

  • 优化了README
  • Optimized the README.

v1.1.5

  • 修复加载问题
  • 临时优化了UI显示,但导入模型过多仍可能导致部分按钮被遮挡,无法选中。未来可能会更换饰品选择方案。
  • Fixed loading issues.
  • Temporarily improved UI display, but excessive model imports may still cause selection issues. A new accessory selection method may be considered in the future.

v1.1.4

  • 优化了README
  • Optimized the README.

v1.1.3

  • 修改了数据保存方案,以防止更新后饰品配置数据丢失
  • 恢复了Odradek奥卓德克灯光
  • 优化了README
  • Modified the data saving method to prevent accessory configuration data loss after updates.
  • Restored Odradek's lighting.
  • Optimized the README.

v1.1.2

  • 优化部分代码
  • Optimized some code.

v1.1.1

  • 更加明显的 ON/OFF 区别
  • More distinct ON/OFF differentiation.

v1.1.0

  • 为Odradek奥卓德克添加了动画
  • Added animations for Odradek.

v1.0.9

  • 优化了UI界面
  • Optimized the UI interface.

v1.0.8

  • 修复死亡时更换装饰品复活后不同步的问题
  • Fixed an issue where accessories changed upon death were not synchronized after revival.

v1.0.7

  • 为Odradek奥卓德克添加了更加炫酷的灯光效果
  • Added more impressive lighting effects for Odradek

v1.0.6

  • 添加了小丑鼻子、草帽、Odradek奥卓德克(带有灯光效果!)、竹蜻蜓(带有动画!)
  • Added clown nose, straw hat, Odradek (with lighting effects!), bamboo copter (with animation!)

v1.0.5

  • 现在可以加载plugins文件夹下的所有.hhh
  • Now it is possible to load all .hhh files located in the plugins folder.

v1.0.4

  • 优化了滚动界面中按钮被遮挡的问题
  • Optimized the issue where buttons were obscured in scrolling interfaces.

v1.0.2

  • 开发者包已经优化(v1.01),以方便制作者批量的打包模型
  • 添加了一根非常酷的,留有轨迹的雪茄
  • 吸烟有害健康,但游戏里不,不过说真的,现实世界还是别抽了
  • The developer package has been optimized (v1.01) to make it easier for creators to batch package models
  • Added a very cool cigar that leaves a trail
  • "Smoking is harmful to health, but not in games. However, seriously speaking, it's better not to smoke in the real world."

v1.0.1

  • 提升了部分模组加载器的兼容性
  • 开发包已经优化(v1.01),以方便制作者更好的找到位置锚点
  • Improved compatibility with some mod loaders
  • The development package has been optimized (v1.01) to help creators better locate position anchors

v1.0.0

  • 初始版本
  • Initial release