Skip to content

Asset and Material

Obtaining Assets

Using this Shader requires a lot of ripped assets, which you need to obtain yourself. This project does not provide assets, tools, or tutorials to help you obtain assets.

Official MMD Models

Download link: https://www.aplaybox.com/u/516827875. MMD models lack some detailed information, so the rendering may not be as good as ripped models.

Processing Assets

Textures and models of characters need to be set up correctly before they can be used. This is a repetitive and tedious task, so this project provides an asset processor. After importing an asset, if its path meets certain requirements, the asset processor will automatically apply presets to it without the need for manual modification of the asset settings. For models, it can also automatically smooth their normals.

Default texture filename formats:

  • Avatar_*_Ramp*
  • Avatar_*_LightMap*
  • Avatar_*_Color*
  • Avatar_*_Stockings*
  • M_*_*_FaceMap* or W_*_*_FaceMap*
  • M_*_*_Face_ExpressionMap* or W_*_*_Face_ExpressionMap*

Default model filename formats:

  • Avatar_*_*.fbx or Art_*_*.fbx

By default, case is ignored. * represents zero or more characters.

Configure Asset Processor

The asset processor can be configured in Project Settings/StarRail NPR Shader/HSR Asset Processors.

Asset Processor
Asset Processor

  • Match Mode: The matching mode for assets.

    • Name Glob: Path Pattern uses a syntax similar to Unix Glob, ignoring case, to match the asset's name (including the extension).

      • *: Matches zero or more characters.
      • ?: Matches exactly one character.
      • |: Separates multiple Globs. For example, a.* | b.* means matching either a.* or b.*.
    • Regex: Treats Path Pattern as a regular expression to match the complete asset path.

    • Equals: Matches successfully if the complete asset path is equal to Path Pattern.
    • Contains: Matches successfully if the complete asset path contains Path Pattern.
    • Starts With: Matches successfully if the complete asset path starts with Path Pattern.
    • Ends With: Matches successfully if the complete asset path ends with Path Pattern.
  • Path Pattern: The pattern string.

  • Ignore Case: Whether to ignore case during matching.
  • Custom Preset: Custom preset. If empty, the default preset is used.
  • Smooth Normal Store Mode: The mode for storing smoothed normals in models.

Shaders

  • Honkai Star Rail/Character/Body
  • Honkai Star Rail/Character/Body (Transparent)
  • Honkai Star Rail/Character/EyeShadow
  • Honkai Star Rail/Character/Face
  • Honkai Star Rail/Character/FaceMask
  • Honkai Star Rail/Character/Hair

Materials

  • It is recommended to reset the material after changing its shader.
  • If using MMD models, set Model Type to MMD at the top of the material.
  • If there is no Outline/Rim-Light, adjust the Model Scale at the top of the material.
  • If the outline flickers or obscures the model, adjust the Z Offset value in the material's Outline section. Typically, this is a small negative number like -1e-05 or -1e-04.
  • If self shadow produces strange patterns (Shadow Acne), adjust the Depth Bias and Normal Bias in the material's Self Shadow Caster section. Typically, this is a negative number of the same order of magnitude as -0.01.