Overview

Introduction

Installation

Getting Started

Core Features

Influence Modes

Deformation

Refinement & Smoothing

Material Layer System

Modular Character Support

API Reference

Blueprint API

Editor Guide

Asset Editor Overview

Debug Visualization

Resources & Support

Troubleshooting & FAQ

Changelog

Material Layer System

FleshRing - Material Layer System Complete Guide

Purpose: This guide covers everything about FleshRing's Material Layer System. After reading this page, you'll understand how layers are assigned, how they control which mesh parts deform, how penetration resolution keeps layers in correct order, and how to configure multi-layer setups with confidence.


What is the Material Layer System?

[IMAGE: Character with multiple layers visible — Skin, Stocking, Outerwear each highlighted in different colors]

The Material Layer System is FleshRing's mechanism for understanding what type of surface each part of a mesh represents. By assigning layer types (Skin, Stocking, Underwear, etc.) to material slots, the plugin can:

  1. Filter deformation targets — A Ring can selectively affect only specific layers (e.g., compress only Skin, not Outerwear).
  2. Resolve layer penetration — Ensure outer layers (Stocking) always render outside inner layers (Skin) after deformation.
  3. Support multi-garment setups — Handle complex character configurations with separate meshes or materials for each garment.

Without the Material Layer System, FleshRing would deform all vertices equally with no understanding of garment hierarchy — resulting in clipping, incorrect layer ordering, and uncontrollable deformation scope.

Without Layer System With Layer System
Deformation Target All vertices in range Only selected layers
Layer Ordering Random clipping Stocking always outside Skin
Multi-Garment Everything deforms together Independent per-layer control

Key Insight: The Material Layer System defines what gets deformed and how layers interact. Tightness and Bulge define how much it deforms.


Layer System Overview

The Material Layer System operates in three phases:

Asset Setup (Editor)
     |
     v
+-------------------------------+
| 1. Layer Assignment           | <-- Map material slots to layer types
|    (per Material Slot)        |      (auto-detected or manual)
+---------------+---------------+
                |
                v
+-------------------------------+
| 2. Layer Filtering            | <-- Ring targets specific layers
|    (per Ring, via Bitmask)    |      via "Target Material Layers"
+---------------+---------------+
                |
                v
+-------------------------------+
| 3. Penetration Resolution     | <-- GPU pushes outer layers outside
|    (GPU Compute Shader)       |      inner layers after deformation
+---------------+---------------+
                |
                v
        Final Deformed Output

Phase Summary

Phase Where When Key Setting
Layer Assignment FleshRing Asset editor Asset setup (once) Material Layer Mappings
Layer Filtering Per-Ring settings Vertex selection Target Material Layers
Penetration Resolution GPU post-process After deformation Automatic (always on)

Layer Types

FleshRing defines 6 layer types arranged in a strict hierarchy from innermost to outermost:

Layer Type Value Hierarchy Description
Skin 0 Innermost Base body mesh. The reference surface that all other layers must stay outside of.
Stocking 1 ↑ Tight-fitting hosiery directly on skin (stockings, tights, pantyhose, socks, leggings).
Underwear 2 ↑ Underwear layer above stocking (bras, panties, lingerie, bikinis, briefs).
Outerwear 3 Outermost External clothing (dresses, shirts, skirts, jackets, pants).
Other 4 Unclassified Default when auto-detection fails. Controlled via Target Material Layers bitmask.
Exclude 5 — Never affected by any Ring, regardless of bitmask settings.

[IMAGE: Layer hierarchy diagram — concentric rings showing Skin (innermost) → Stocking → Underwear → Outerwear (outermost)]

Hierarchy Rule

The penetration resolution system enforces a strict ordering:

Skin (inner) < Stocking < Underwear < Outerwear (outer)

After deformation, if a Stocking vertex ends up inside the Skin surface, it is pushed outward to maintain correct layer ordering. This ensures garments never clip through the body.

Important: The Exclude layer is special — it is always excluded from deformation regardless of the Ring's Target Material Layers setting. Use it for mesh parts that should never deform (eyes, hair, accessories, rigid props).


Phase 1: Layer Assignment

How It Works

When you set the Target Skeletal Mesh in a FleshRing Asset, the plugin automatically scans all material slots and attempts to assign a layer type based on the material name.

[IMAGE: FleshRing Asset editor — Material Layer Mappings array showing auto-detected layer types per material slot]

Auto-Detection Keywords

The plugin scans each material slot name (case-insensitive) against keyword lists in priority order:

Priority Layer Type Keywords
1 (Highest) Stocking stocking, tight, pantyhose, hosiery, nylon, sock, legging
2 Underwear underwear, bra, panty, panties, lingerie, bikini, brief, thong
3 Outerwear cloth, dress, shirt, skirt, jacket, coat, pants, jeans, top, blouse, suit
4 (Lowest) Skin skin, body, flesh, face, hand, leg, arm, foot, head
— Other No keywords matched (fallback default)

Examples:

Material Slot Name Auto-Detected Layer
MI_Body_Skin Skin (matches "skin" and "body")
MI_Stocking_Black Stocking (matches "stocking")
MI_Lace_Panty Underwear (matches "panty")
MI_Jacket_Leather Outerwear (matches "jacket")
MI_Accessory_Ring Other (no match)

Tip: If auto-detection assigns the wrong type, simply change it manually in the dropdown. The auto-detection only runs when a new material slot is added — it never overwrites your manual assignments.

Material Layer Mapping Properties

Property Type Editable Description
Material Slot Index int32 Read-only Auto-populated from skeletal mesh
Material Slot Name FName Read-only Display name from the mesh's material array
Layer Type EFleshRingLayerType Editable The assigned layer — auto-detected or manual override

[IMAGE: Single Material Layer Mapping entry expanded — showing material thumbnail, slot name, and Layer Type dropdown]

Manual Assignment Workflow

  1. Open the FleshRing Asset in the editor.
  2. Set your Target Skeletal Mesh — Material Layer Mappings auto-populate.
  3. Review each entry — auto-detected types are shown.
  4. Override any incorrect assignments by selecting the correct type from the dropdown.
  5. Set any non-deforming parts (eyes, hair, weapons) to Exclude.

[GIF: Manual layer assignment workflow — opening asset, reviewing auto-detection, changing a layer type from Other to Skin]