peak-jojo-hats

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

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

Six JOJO-inspired head cosmetics: Jotaro Cap, Josuke Pompadour, Giorno Rolls, Jonathan Hair, Jolyne Buns and Joseph Hair. Version 0.4.2.

Screenshots and source · 中文介绍 · Full installation guide

Install

Use a dedicated PEAK profile, with the tested dependencies:

• BepInEx-BepInExPack_PEAK-5.4.75301
• cretapark-More_Customizations-1.1.10

Install this package with your mod manager, or download and extract the ZIP manually. The mod manager does not run the compatibility script for you. For the JOJO-only, zero-.pcab setup, also extract the ZIP to access its scripts folder.

Close PEAK. For a manual installation, copy BepInEx/plugins/JojoHats to your profile's BepInEx/plugins, keeping the complete assets directory beside the DLL. From this extracted ZIP root, open PowerShell and run:

.\scripts\install-jojo-only.ps1 -BepInExRoot 'FULL_PATH_TO_PROFILE\BepInEx'

Replace the placeholder with your actual profile path. The script backs up the local framework DLL, patches its empty-bundle check, and moves built-in.pcab out of the loading path. Backups are in BepInEx/JojoHats-backup. Simply deleting the sample is insufficient. The patch is tested only with 1.1.10; do not reuse an old backup across framework updates. See the full guide before modifying a profile. No game/framework DLL is bundled here.

Launch modded PEAK and select a JOJO icon in the passport's Hat tab.

Important

This replaces the custom cosmetic catalog with six hats. Vanilla cosmetics remain available; other custom eyes, hats and accessories are excluded. The screenshots' eyes, outfits and props are not added by this mod. All hats are static. Multiplayer has not been validated with two clients. Equip a vanilla hat before uninstalling or using an unmodded profile.

中文安装说明

包含乔纳森、乔瑟夫、承太郎、仗助、乔鲁诺和徐伦六款头饰，全部在护照的 Hat / 帽子 页选择。

1. 新建独立 PEAK 配置，安装上面列出的两个测试版本依赖。
2. 使用模组管理器安装本包，或手动解压复制 BepInEx/plugins/JojoHats。保留 DLL 旁完整的 assets 目录。
3. 模组管理器不会自动运行兼容脚本。 要使用只保留 JOJO、没有 .pcab 的配置，请另外下载并解压 ZIP，关闭游戏，在解压目录运行上面的 PowerShell 命令，把占位路径替换为该配置的实际 BepInEx 路径。
4. 脚本备份并修改本地 More Customizations DLL，将 built-in.pcab 移至 BepInEx/JojoHats-backup，不会永久删除它。不能只删除样例包；兼容补丁仅测试过 1.1.10，升级框架后不要复用旧备份。
5. 从管理器启动模组版 PEAK，在护照的帽子页找到 JOJO 图标。

仅包含静态头饰，不包含展示图中的眼睛、服装或道具。本版本会隐藏其他自定义外观，原版外观不受影响；请使用独立配置。双客户端联机尚未验证，卸载前请换回原版帽子。

六款实机展示 / In-game gallery · 反馈 / Report an issue

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.

非官方同人项目，与 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.