peak-jojo-hats

JOJO's Bizarre Climb / JOJO 的奇妙登山

JOJO-inspired hats and hairstyles for PEAK. 给 PEAK 小人换个 JOJO 发型。

Six head cosmetics inspired by Jotaro, Jolyne, Giorno, Josuke, Joseph and Jonathan, alongside your other cosmetics. Version 0.5.2 updates the package cover; runtime logic is unchanged from v0.5.0 and the six models are unchanged from v0.4.2. The outfit concept preview remains below.

In-game gallery and source · 中文介绍 · Installation and troubleshooting · Report an issue

In-game gallery / 实机展示

Here's how the six styles look in PEAK. Click a photo for the full-size image.

六款头饰的实机效果，点击照片可以查看原图。

Jonathan Joestar · 乔纳森	Joseph Joestar · 乔瑟夫	Jotaro Kujo · 承太郎
Josuke Higashikata · 仗助	Giorno Giovanna · 乔鲁诺	Jolyne Cujoh · 徐伦

Only the hats and hair are included; the screenshots' eyes, outfits and props are not part of this mod. The models shown are unchanged in v0.5.0.

本模组只包含帽子和发型，不包含照片里的眼睛、服装和道具。v0.5.0 沿用图中的六款模型。

Install

1. Install JojoScoutHats v0.5.0 or newer with r2modman or Thunderstore Mod Manager, including the dependencies.
2. Launch modded PEAK from the manager.
3. Open the passport's Hat tab and pick a JOJO icon.

No scripts, file deletion or framework patches required. Leave More Customizations and its included built-in.pcab as installed. Your other custom hats, eyes, faces and accessories stay in the catalog.

Dependencies: BepInEx-BepInExPack_PEAK-5.4.75301 and cretapark-More_Customizations-1.1.10. The supported framework target is an unmodified 1.1.10 installation. For manual installation, copy the ZIP's BepInEx/plugins/JojoHats folder into your profile's BepInEx/plugins and keep its complete adjacent assets directory.

Updating from v0.4.2

Equip a vanilla hat before updating and reselect your JOJO hat afterward; the old exclusive catalog and new shared catalog can use different positions.

Previously ran the JOJO-only script, patched More Customizations or removed its sample bundle? Start with a fresh mod-manager profile, or reinstall a clean copy of More Customizations 1.1.10 with its original DLL and built-in.pcab. v0.5.0 does not automatically change third-party files or restore old backups. Do not rerun the old patch scripts. See the installation guide for existing-profile recovery.

Playing with friends

Share the same complete cosmetic profile with everyone in the lobby: JOJO, dependencies, all other cosmetic packs and their versions. Manually installed cosmetic files must match too. Matching only JOJO is not sufficient, and this mod does not send models to other players. Two-client appearance and reconnect validation are still pending; see validation scope.

A few notes

• Only static headwear is included. The screenshots' eyes, outfits, expressions and props are not added by this mod.
• No added abilities or body replacements. Some outfits or climbing/ragdoll poses may still clip.
• Before disabling or removing the mod, equip a vanilla hat and close PEAK. Keep dependencies used by other mods. A normal v0.5.0 installation needs no framework repair afterward.

中文安装说明

包含乔纳森、乔瑟夫、承太郎、仗助、乔鲁诺和徐伦六款头饰，全部在护照的 Hat / 帽子 页选择。v0.5.0 改为与其他外观共存，六款模型沿用 v0.4.2。

1. 用 r2modman 或 Thunderstore Mod Manager 安装 JojoScoutHats v0.5.0 或更新版本，一并安装提示的依赖。
2. 从管理器启动 Modded PEAK / 模组版游戏。
3. 在护照的帽子页选择喜欢的 JOJO 图标。

不需要运行脚本、删除文件或修改框架。 保留 More Customizations 及其自带的 built-in.pcab。新版不隐藏其他自定义帽子、眼睛、表情或配件。依赖版本见上方；手动安装时保留 DLL 旁完整的 assets 目录。

旧版升级与联机

从 v0.4.2 升级前请换回原版帽子，升级后重新选择 JOJO 头饰，避免新旧列表位置变化造成选错。以前运行过 JOJO-only 补丁、修改过框架或删过样例包的话，最省心的方式是新建管理器配置；也可以重装包含原始 DLL 和样例包的 More Customizations 1.1.10。新版不自动修改其他模组或恢复旧备份，不要再运行旧脚本。

和朋友一起玩时，请使用相同的完整外观配置，依赖、其他外观包及其版本、手动安装的外观文件也要一致。本模组不自动传输模型，不能只保证 JOJO 版本相同。双客户端显示与重连验证仍待完成。

仅包含静态头饰，不包含展示图中的眼睛、衣服和道具。卸载前换回原版帽子并退出游戏，保留其他模组需要的依赖。正常安装的 v0.5.0 卸载后不需要修复框架；旧版修改过的配置需单独恢复。

六款实机展示 / In-game gallery · 详细安装与排错 / Full guide

Coming soon: JOJO outfits / 即将推出：JOJO 服装

Matching JOJO outfits for the six scouts are planned. Here's a first look at the idea.

计划给六位小人配上 JOJO 服装，先看看设计示意。

Concept illustration, not an in-game screenshot. These outfits are not included in the current hats mod. Final designs may change; no release date is set yet.

这是概念示意图，不是实机截图。 服装尚未包含在当前头饰模组中，最终造型可能调整，暂未确定发布日期。

Credits / 致谢

Unofficial fan project; not affiliated with PEAK or JoJo's Bizarre Adventure. Built on BepInEx and More Customizations. No explicit reuse license is included; please contact the maintainer about reusing project material. The header is promotional artwork; gallery images are actual gameplay screenshots.

非官方同人项目，与 PEAK 或《JOJO 的奇妙冒险》官方无关联。感谢 BepInEx 和 More Customizations。项目未附带明确的再使用许可，如需使用素材请联系维护者。横幅为宣传插画，展示图为实机截图。

0.5.2

• Update the package cover with the revised, borderless JOJO scout illustration.
• No changes to models, cosmetic IDs, dependencies or runtime logic.

中文：更新为无边框新版封面，六款头饰与加载逻辑不变。

0.5.1

• Add a bilingual coming-soon section and concept illustration for planned JOJO outfits.
• Clearly distinguish the concept from the in-game gallery: outfits are not included, and no release date is set.
• No changes to hat models, cosmetic IDs, dependencies or runtime logic; only release version metadata changes in the loader.

中文：新增 JOJO 服装预告与设计示意图，明确服装尚未包含、暂无发布日期。六款头饰与加载逻辑不变。

0.5.0

• Add six JOJO hats alongside the existing cosmetic catalog instead of replacing it; keep other custom hats, eyes, faces and accessories.
• Use unmodified More Customizations 1.1.10 with its included sample bundle. Normal installs no longer require PowerShell or third-party DLL patches.
• Remove the historical JOJO-only installer and empty-bundle patch scripts from the download package. Existing profile files and backups are not changed automatically.
• Add mod-manager installation, v0.4.2 migration, removal and matching-profile multiplayer instructions in English and Chinese.
• Include the six-image in-game gallery directly in the Thunderstore description, with bilingual captions and full-size image links.
• Keep the six models, textures and cosmetic IDs from v0.4.2. Asset revision numbers remain independent of the loader version.
• Multiplayer appearance and reconnect behavior still require two-client validation; no automatic asset synchronization is provided.

中文：现在只添加六款头饰，不隐藏其他自定义外观；正常安装不再需要脚本或修改框架。模型不变。旧版修改过依赖的配置建议重新建立，联机请使用相同的完整外观配置。

0.4.2

• Extend continuous-volume / fitted-root refinement to Jotaro, Jonathan and Joseph.
• Conservative Giorno cleanup: one scalp envelope and continuous spiral ridges; accepted locks, roll bodies and braid positions preserved.
• Josuke/Jolyne and shared palette remain byte-identical to v0.4.1.
• Same six IDs, hat order and runtime architecture; no added eyes, clothing, textures or PCAB content.
• Per-hat exported-mesh comparisons, six-view sheets and 12-angle turntables.

0.4.1

• Targeted Josuke/Jolyne refinement from gameplay feedback; other four hats and palette frozen byte-for-byte.
• One continuous Josuke forehead-roll/crown/scalp surface, shallow integrated ridges, no detached top tufts.
• Jolyne gathered green roots and continuous braid follow the curved skull; tapered tie and smaller tail.
• Same runtime architecture, custom catalog, material, IDs and hat order.
• Real-mesh before/after comparison, six-views and regression checks; no visual gameplay approval implied.

0.4.0

• Six character-specific layouts replacing the generic rear-hair template.
• Surface-following tapered locks with independently controlled width and thickness.
• Stable transported sweep frames and part-local authored smooth normals.
• Indexed runtime mesh and normal-aware CPU previews.
• Revised Jotaro cap opening, full band, visor and hidden hair roots.
• Filled Josuke pompadour, swept Giorno crown, raised Jonathan fan, asymmetrical Joseph crown.
• Interwoven Jolyne bun rings, shallow pulled-back hair and continuous braid strands.
• All six use the shared palette; no separate high-resolution texture dependency.
• Per-hat six-view sheets, 12-angle turntables and expanded normals validation.
• Replaced the previous layered rear-hair construction.

0.2.0

• Rebuilt all six models from the approved six-view designs with curved faceted locks.
• Navy Jolyne buns, lime braided bases/bangs/back braid, teal tie; no all-green buns.
• Asymmetric Jotaro crown, solid gold cord and raised hand badge; removed coat chain.
• Rolled indigo Josuke perimeter and interwoven top/back; no waffle slab.
• Solid Giorno spiral rolls and rear braid; blue-violet Jonathan fan/forelocks; Joseph patterned headband.
• JOJO-only custom catalog: six hats, zero custom eyes, faces or accessories; vanilla preserved.
• Recoverable sample removal and narrow offline empty-bundle framework compatibility fix.
• Actual-mesh six-view exports, expanded validation and zero-pcab runtime assertions.

0.1.0

• Initial six static low-poly hats, including corrected compact Josuke pompadour.
• Shared texture atlas, six passport icons, deterministic mesh source and OBJ exports.
• Runtime registration through More Customizations 1.1.10.
• Isolated PEAK smoke-test workflow.