Miyabi Mercenary

v0.8.7·Updated 2026-10-07

Hoshimi Miyabi (Zenless Zone Zero) as a Mercenary skin: katana, scabbard, hair and cloth physics, and her blue frost flames on the Mercenary's skills.

About this mod Machine translation

Miyabi Mercenary

Adds Hoshimi Miyabi from Zenless Zone Zero as a skin for the Mercenary.

  • Miyabi's full body replaces the Mercenary and follows all of his animations.
  • Her katana replaces the Mercenary's sword: it rests in her scabbard on her left hip and is drawn only when she attacks.
  • On the character select screen she sits on a white plastic chair, her sheathed katana beside her.
  • Hair, fox ears, coat, sleeve and skirt have their own physics, and the hair and the clothes push each other.
  • Blue frost flames like in Zenless Zone Zero on the Laser Sword, Whirlwind / Rising Thunder, the dash and Eviscerate / Slicing Winds: frost crescents, ghost fire along the katana, frost hits with ice cracks, dash flare.
  • Her horned ghost floats beside her in runs, like in Zenless Zone Zero.
  • Her horned eye spirit replaces the Mercenary's Expose mark on enemies (flat 2D line drawing).
  • Item displays and the Mercenary's own model effects (blue lights) are hidden on Miyabi.
  • Miyabi's portrait replaces the Mercenary's in the scoreboard, ally cards and end of run report.

Select the skin in the Mercenary's loadout (Skins tab).

Configuration

BepInEx/config/com.randy.miyabimercenary.cfg

| Section | Setting | Default | |

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

| Physics | Enabled | true | Hair, ears, coat, sleeve and skirt physics |

| Physics | Rate | 30 | Physics steps per second (60 = smoothest, twice the cost) |

| Physics | HairLag | 0.3 | How much her hair trails behind when running, dashing or turning |

| Physics | ClothLag | 0.12 | How much the coat, sleeve and skirt lag behind |

| Physics | HairClothCollisions | true | Hair and coat, sleeve and skirt push each other |

| Weapons | MiyabiKatana | true | Show Miyabi's katana |

| Weapons | Scabbard | true | Show the scabbard on her hip |

| Weapons | SheatheWhenIdle | true | Katana sheathed when not attacking |

| Model | HideItemDisplays | true | Hide item and equipment displays on Miyabi |

| Model | HideMercenaryEffects | true | Hide the Mercenary's blue lights and pre-dash glow |

| Model | MiyabiPortrait | true | Miyabi's portrait in the game UI |

| Model | MenuPose | true | Miyabi's pose on the character select screen |

| Model | MenuChair | true | Seated on the plastic chair (false = standing) |

| Model | Size | 1 | Extra size multiplier |

| Effects | FrostFlames | true | Miyabi's frost flames on M1, M2, the dash and R |

| Effects | EyeMark | true | Miyabi's eye spirit as the Expose mark |

| Effects | GhostCompanion | true | Miyabi's ghost floating beside her |

Credits

3D model by BiliBili. Hoshimi Miyabi © HoYoverse / miHoYo.

Install & use Install: BepInEx plugin

  1. The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
  2. Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
  3. Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
  4. Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.

Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file.

Dependencies

Install these first, or the mod will not work:

bbepis-BepInExPackRiskofThunder-R2API_LanguageRiskofThunder-R2API_ContentManagementRiskofThunder-R2API_Skins

File & checksum

Filename
Miyabi_Mercenary-0.8.7.zip
File size
8.4 MiB