# Gorecraft Wounds, dismemberment and blade cuts for skeletal meshes in Unreal Engine. The wounds follow the animation on the body and on the clothes over it, with no UV setup and no render targets. Limbs come off at the joint or anywhere along a bone, with a closed stump and a part that falls with physics. Everything is decided on the server and replicated, and a player who joins late sees the same character as everyone else. All of it is usable from Blueprint. ## Wounds on your character in 5 minutes 1. **Add the wounds to the skin material.** In the Content Browser, right-click the character's material (or one of its instances) and pick **Gorecraft > Add Wounds (Skin)**. Do the same with **Add Wounds (Cloth)** on clothes and gear. Save the materials. What this does, and how to do it by hand, is in [Materials](#materials). 2. **Add a `GRC Wound` component** to the character. It needs no setup: it finds the actor's skeletal meshes and their materials on Begin Play. 3. **Wound it from the server.** Where your weapon already knows it hit the character, call **Add Wound From Hit** with the hit result and a wound type (`DA_GRC_Bullet`, `DA_GRC_Cut`, `DA_GRC_Bite`, `DA_GRC_Burn` in `/Gorecraft/WoundTypes`). For a blade, also pass the swing direction as Cut Direction. 4. **For dismemberment, add a `GRC Dismember` component** and set its Settings to `DA_GRC_MannequinLimbs` (the UE5 mannequin) or your own copy of it. Call **Sever Limb From Hit** for a hit that takes a limb off at the joint, or **Slice Limb** for a blade through the middle of a bone. 5. **Packaged game:** tick **Allow CPU Access** on the skeletal mesh's LOD 0, or no severed part drops (everything else works, and the log says which mesh). Play. Everything below is optional. ## The example map Open `/Gorecraft/Example/Maps/L_GorecraftExample` and press Play. It is a firing range with six stations: skin and cloth, a dummy jogging in place, Epic's mannequin material with the wounds added by the right-click tool, limbs coming off, one for everything at once, and a wolf with its own skeleton. Fly with WASD (Q and E down and up) and the mouse, pick a weapon with 1 to 8 or the wheel, and use it with the left button. N turns the Niagara blood on (5.8), R puts every dummy back, H hides the help. Each station is a `GRC Demo Dummy` placed in the map: change its look, animation and limbs in its details, or drag in another one. The weapons call the same Blueprint nodes a game would (Add Wound From Hit, Sever Limb From Hit, Slice Limb), from `GRCDemoPlayerController` in the `GorecraftExample` module. A game that uses Gorecraft needs none of this: delete `/Gorecraft/Example` and the module stays unused. The example content is not Gorecraft's own: the UE5 mannequin, its idle, walk and jog are Epic Games' template content, and the wolf is from Quaternius' "Ultimate Animated Animals" (CC0). ## Wounds A wound is stuck to a bone and drawn by the material, so it stays on the same spot of skin while the character animates, ragdolls or changes clothes. Each wound is a capsule (a sphere when it has no length) in the mesh's reference pose. The component keeps the list in a small texture per character that every material on the actor reads. **Calls (server only):** | Call | What it does | |---|---| | Add Wound From Hit | A wound where a trace or projectile hit. Cut Direction is the blade's swing (ignored for round wounds). | | Add Wound At Location | A wound at a world point on a bone (None picks the closest bone). Surface Normal points out of the skin; Min Radius makes it at least that wide. | | Clear Wounds | Removes every wound. | | Heal Wounds | Every wound fades out over Fade Seconds and goes. | | Load Gore | Puts a save's wounds and cuts back on a fresh character, as a player joining late sees them: no spray, no part dropping, the body limp if a cut limb asks for it. | **Events and queries (every machine):** - **On Wound Added** (Wound, Just Happened): play your own sound or effect here, only when Just Happened is true (the plugin's blood already sprays then). It is false for wounds that arrive with the character: a player joining late, or the character coming back into network view. - **On Wounds Cleared**. - **Get Wound World Location**: where a wound is now, for effects that follow it. - **Get Wounds**, **Get Wound Count**. - **Save Gore**: the wounds and cuts as they are now (a `GRC Gore Save` struct), for your SaveGame. Times are kept from the moment of the save, so a wound that was healing goes on healing after the load. **Settings on the component:** | Setting | Default | What it does | |---|---|---| | Max Wounds | 32 | Past it the oldest goes. Up to 64. | | Default Wound Type | none | Used when a call passes no type. | | Mesh Tag | none | Only skeletal meshes with this component tag get wounds. None is every skeletal mesh on the actor. | | Cut Face Core Start | 0.9 | How much of a cut end stays red before the dark middle (0 to 1). | | Blood Amount | 1 | Drops thrown out of a new wound: its type's count times this. 0 throws none. | Changing clothes or materials at runtime: call **Refresh Meshes** afterwards. A character whose main mesh is not the Character's mesh: call **Set Main Mesh**. ### Wound types A wound type is a Data Asset (`GRC Wound Type`). Duplicate one of the six in `/Gorecraft/WoundTypes` to start. | Setting | What it does | |---|---| | Radius | Size of the stain around each mark, in cm on the mesh as imported. The open wound is the middle of it. | | Length | Length along the cut direction, in cm. 0 is a round hole; a blade leaves a long one. | | Depth | How far the skin sinks in the middle, in cm. 0 is a flat stain (a burn). | | Random Scale | Each mark is scaled by up to this (0.2 is 20% bigger or smaller), so two hits never look the same. | | Num Marks, Mark Spread | Several marks per hit, spread along the skin (teeth, shotgun pellets). | | Tint | Colour of the stain. The open middle is a darker shade of it. | | Edge Softness | 0 is a hard edge, 1 fades the stain out over its whole radius. | | Edge Noise, Edge Noise Frequency | How ragged the edge is, and how many bumps it has. 0 is a clean circle. | | Core Darkness | How dark the open middle goes: 1 nearly black, 0 the stain's colour all the way. | | Spray Drops, Spray Speed | Blood thrown out when the wound opens, and how fast (cm/s). | | Drip Length, Drip Wound Type | A trail of blood running down the skin from the wound, this long (down as the character stands when hit). | | Lifetime, Heal Seconds | Seconds the wound stays before it heals away (its trail with it), and how long the fade takes. Lifetime 0 keeps it. | `DA_GRC_Stump` is the wound a severed limb leaves, and `DA_GRC_Drip` the trail the others leave down the skin. `DA_GRC_Pellet` is a smaller bullet with no trail, for shotguns: 9 pellets take 9 slots instead of 18. ## Blood Blood flies and lands without Niagara: every drop is an instance of one small mesh moved on the CPU, and a drop that hits the level leaves a stain there (a decal). A drop that lands on a stain makes it bigger instead, up to a pool 80 cm across, so the stains a burst throws around stay and the drips under a stump pool; past 400 stains in the world the oldest one moves. A new wound sprays as its type says; a cut sprays from the stump, and the stump and the part's cut end drip for a few seconds, pooling on the floor. It all runs on each machine, from what already replicates: nothing more goes over the network, and a dedicated server draws none of it. From Blueprint, the **GRC Blood** subsystem: **Spray Blood** (a burst from a point), **Bleed From** (drips from a point riding a component, for a few seconds) and **Splat Blood** (a stain). The materials are `M_GRCBloodDrop` and `M_GRCBloodStain` in `/Gorecraft/Blood`. The stain has three shapes, set by `GRC_StainLook` on `M_GRCBloodStain`: 0 a splat with a few drops around it (the default), 1 a spatter with many drops thrown out, 2 a round pool with a darker dried rim. **Niagara, if you want more.** The drops need nothing else, and stay on by default. For a fuller look, give the **GRC Wound** component a **Spray Effect** and the **GRC Dismember** component a **Sever Effect**: any Niagara system, fired on top of the drops (set Blood Amount to 0 for Niagara alone). The spray fires where a wound opens, its Z axis out of the skin. The sever effect fires on the stump and rides it, its Z axis out of the cut. Two come with the plugin in `/Gorecraft/Blood`: `NS_GRC_BloodBurst` (drops and a puff of mist) and `NS_GRC_BloodJet` (the stump spurting for a second). The example's **N** key turns them on. They are made with Unreal 5.8; the 5.6 and 5.7 versions of the plugin have the two settings but not the two systems. ## Dismemberment The `GRC Dismember` component takes limbs off, on any skeleton: the limbs are a list of bone names (the demo shows the mannequin and a four-legged wolf). The server cuts and every machine applies it: the part past the cut is hidden on all the actor's skeletal meshes, its physics bodies stop colliding, the stump gets a closed cap with a stump wound on it, and a severed part drops. **Calls (server only):** | Call | What it does | |---|---| | Sever Limb From Hit | Takes off the limb that was hit, at its joint. It goes up from the hit bone to the first one in the Settings: a shot in the middle of the forearm takes the forearm, a shot in the hand takes the hand. | | Sever Limb | The same, by bone name. | | Explode Body | Blows the body apart from a point: every limb at the top of the list comes off (on the mannequin the head, both arms and both thighs), thrown away at Strength cm/s, with a burst of blood, and the rest goes limp. | | Slice Limb | A blade through a bone: a world point on the blade and its normal. The bone cut is the one passing closest to the point (within 30 cm). The side that falls is the one further down the limb, whichever way the normal points. | A cut at the joint goes 12% into the bone (2 to 6 cm), so the stump has a short piece of the bone with a flat cap instead of the skin pulled to a point. Near a joint the cut also slides down the limb until it is clear of the body beside it (the chest next to an upper arm, the groin next to a thigh), so the hidden part never opens a hole the cap does not close. Every machine works it out the same way from the mesh. A cut is refused when the bone is not a limb in the Settings (or below one), or when it or a bone above it was already cut. **Events and queries:** **On Limb Severed** (Bone, Severed Part, Just Happened) on every machine, **Is Bone Severed**, **Get Severed Limbs**, **Get Stump Caps** (the cap meshes, attached to their bones). ### Limb settings A `GRC Dismember Settings` Data Asset per skeleton, not per character: every character on that skeleton shares it. `DA_GRC_MannequinLimbs` lists 14 limbs of the UE5 mannequin: neck, head, and both upper arms, forearms, hands, thighs, calves and feet. | Setting | What it does | |---|---| | Limbs | Bone, its stump wound (empty uses the default), and whether it drops a part. | | Default Stump Wound | The stump wound for limbs that name none (`DA_GRC_Stump` in the mannequin's settings). | | Stump Radius Per Limb Radius | The stump wound is at least this many times as wide as the limb's physics body (2), so a thick limb's cut end is red and not just the dark middle. | | Severed Part Class | The actor the part is built in. Make a Blueprint child of `GRC Severed Limb` for blood spray, sound or a decal: its **On Severed** event runs once the part is falling. | | Severed Part Lifetime | Seconds the part stays (30). 0 keeps it. | | Severed Part Dissolve Seconds | The end of that lifetime, in which the part dissolves in blotches instead of vanishing (2). 0 makes it vanish. **Dissolve** on the part does it at any time. | | Spawn Parts For Late Joiners | Off: a player who joins later sees the stumps but no parts on the floor. On: they get the parts too, dropped at the character. | | Replicate Severed Parts | The part falls once, on the server, and replicates (see below). Off: each machine drops its own. On a dedicated server the character's mesh needs its bones moving with no one watching (Visibility Based Anim Tick Option: Always Tick Pose And Refresh Bones). | | Sever Spray Drops, Bleed Seconds | The burst out of the stump (80 drops) and how long it keeps dripping (6 s). | Each limb in the list can also make the body react: - **Ragdoll Body**: the rest of the body goes limp (a head, a leg). The mannequin's settings tick it on the neck, the head, the thighs and the calves. **Ragdoll Body** is also a node, for your own deaths (local to the machine: call it from your replicated event). - **Reaction Montage**: played on the body when the limb comes off (a stagger, a scream). The mesh's Anim Blueprint needs a slot for it. - **Wounds To Cripple**: after this many wounds on the limb and below it, the limb is crippled and **On Limb Crippled** fires on every machine (each counts the same replicated wounds). With **Dangle When Crippled** the limb hangs by physics while the body goes on animating; without it only the event fires, for your Anim Blueprint (a limp). The mannequin's settings cripple the arms (they hang) and the thighs (event only) at 3 wounds. Clear Wounds, or healing every wound away, gives the limbs back. **Is Limb Crippled** and **Get Crippled Limbs** ask. - **Extra Bones**: bones outside the limb's own hierarchy that its skin rides, which go with it (children included). Rigs made in Blender often hang an IK chain from the root and put the feet on it: the example wolf's front feet ride `IKFrontLeg_R` and its child `FF_R`, not the leg bones, so its leg limbs list them. Without them the foot stays standing on the body when the leg comes off. A hit goes on the bone closest to the impact, not only the one whose physics body it struck: a physics asset made by an import often puts one body over two or three bones (the wolf's shoulder body covers half its leg). From that bone it goes up to the first limb in the list. List the bones that have physics bodies too, so every hit finds a limb. ### The severed part Each machine builds its own copy, so by default the part is not replicated and may land a little differently on each screen. With **Replicate Severed Parts** on in the limb settings it falls once, on the server, and every machine shows its copy riding the server's (a player who joins late finds it where it lies); its physics shape then comes from the physics asset's bodies, which a dedicated server has. `/Gorecraft/Example/Dismemberment/DA_GRC_MannequinLimbs_ReplicatedParts` is the mannequin's settings with it on. It is built from the character's triangles (body and clothes) in the reference pose, so it falls straight and keeps its wounds, and its cut end is closed. Physics is a convex hull of up to 128 points, and characters walk through it instead of kicking it around. **Get Part Meshes** gives you the meshes, for effects on the cut end or other materials. It needs the mesh data on the CPU: tick **Allow CPU Access** on LOD 0 of the skeletal mesh (and of any clothing mesh that should come with it). In the editor the data is always there, so the editor will not show the problem; a packaged game will. ## Materials Every material on the character needs the material function **`MF_GRCWound`** (`/Gorecraft/Materials`). The component warns in the log about any material that does not have it, and that material simply shows no wounds. **Gorecraft > Add Wounds (Skin / Cloth)** on the Content Browser's right-click menu (or **Add Wounds To Material** from Blueprint or Python) puts the function in for you: - what fed Base Color and Roughness now goes through the function (nothing plugged in uses grey and 0.5); - its World Position Offset is added to the material's own; - **Skin:** its **Cut Mask** goes into Opacity Mask, so a blade cut hides the far side of the limb. **Cloth:** its **Hole Mask** goes there instead, which also opens a hole through the cloth in each wound. Anything already in Opacity Mask is multiplied with it. An opaque material becomes Masked; - "Used with Skeletal Mesh" is ticked and the material is recompiled. A **Material Attributes** graph (a MetaHuman's skin is one) works too: the tool breaks the attributes, puts base colour and roughness through the function, and sets them back with Set Material Attributes, with the offset and the mask. On a material instance it changes the parent material, and with it every instance of that parent. Engine materials are refused, those of engine plugins too (an FBX import makes instances of an Interchange plugin material): duplicate the parent into your project, point the instances at the copy, and run the tool on it. **By hand** (and for the graphs the tool refuses): place `MF_GRCWound`, plug your base colour and roughness into its inputs and its outputs into the material, add its World Position Offset to yours, and put Cut Mask (skin) or Hole Mask (cloth) in Opacity Mask with the Blend Mode set to Masked. - **Substrate graphs** (a Slab or other BSDF plugged into Front Material): put the function before the Slab's Diffuse Albedo and Roughness, add its offset to World Position Offset, and its mask to the Opacity Mask. Materials with the classic inputs work as they are in a Substrate project; Unreal converts them. - **Translucent materials** have no opacity mask: they show the wounds, but no blade cut or cloth hole. Look settings in the function (Gorecraft group on each material instance): | Parameter | Default | What it does | |---|---|---| | GRC_CoreStart | 0.55 | Where the dark open middle of a wound starts, from its edge (0 to 1). | | GRC_WetRoughness | 0.12 | Roughness of the wet stain. | | GRC_HoleStart | 0.7 | Cloth: where the hole starts inside the wound. 1 is no hole. | | GRC_FleshDetail | 2 | The open middle of a wound. 0 flat colour, 1 meat with fibres and a band of torn skin around it, 2 also dark clots and a near black bottom. Shaded from the wound type's tint, so a burn stays charred. | | GRC_CapLook | 2 | The flat end of a cut, on the stump and on the part. 0 the wound's colour, 1 meat with a ring of fat under the skin, 2 also the bone and its marrow in the middle. | `GRC_Wounds`, `GRC_WoundCount`, `GRC_CutCount` and `GRC_CutFace` are set by the component: leave them alone. The bone and fat of `GRC_CapLook` follow the outline of the cut, from the bone out to the skin. Where the cut's outline doesn't go once around the bone (two pieces of mesh in one plane, say), the end is plain meat. ### Clothes and gear Clothes get wounds when they are skeletal meshes on the same actor, built on the same skeleton in the same reference pose as the body (the usual case, and how Leader Pose works). A shot through a vest marks the vest and the skin under it, at the same spot. Gear built on another skeleton has a different reference pose, so wounds would land in the wrong place on it: leave `MF_GRCWound` out of its material (the log warning about it is harmless) or keep it out with Mesh Tag. A static mesh attached to a socket gets no wounds. ## Multiplayer - The server adds wounds and cuts; clients only draw them. All the calls that change something are Blueprint Authority Only. - Wounds replicate as a list in each bone's space, rounded to 0.1 cm (the server rounds its own copy too, so every machine draws exactly the same thing). Only changes go over the network. - A cut sends the bone, the plane and the impulse. Each machine hides the limb, closes the stump and builds its own part. - A player who joins late gets every wound and every stump with the character. **On Wound Added** and **On Limb Severed** tell them apart with Just Happened = false. - A dedicated server keeps the wounds and cuts but draws nothing: no texture and no parts. ## Cost Nothing is painted into textures, so a shotgun on a crowd costs the same as one shot, and a wound costs no memory beyond its 64 bytes in the character's small texture. A pixel of the character only tests the wounds near it: a grid over the body, in the texture, says which wounds and cuts reach each spot (16 x 8 x 16 cells over the mesh as imported). Without it every pixel tested every wound, and 64 wounds on one character filling the screen cost 23 ms; with it, about 1 ms on the same machine (the table below). Measured on 27/10/2026 (RTX 2070 Super, 1920x1080, UE 5.8): 30 mannequins jogging, in the vest, each with the same number of wounds spread over skin and vest. GPU time per frame added to the same scene with no wounds, the median of three rounds of 240 frames (Tools/bench.ps1): | Wounds on each of the 30 | Crowd, seen from 14 m | One filling the screen, 1.3 m | |---|---|---| | 16 | +0.12 ms | +0.27 ms | | 32 | +0.21 ms | +0.68 ms | | 64 | +0.37 ms | +1.05 ms | The cost follows the pixels a wound covers, not how many characters have wounds: a crowd far away costs little, a body close to the camera with dozens of open wounds costs the most. The default is 32 per character (Max Wounds, up to 64). ## Limits - A wound is a capsule with a ragged edge: not a decal with your own texture. - Cut ends are flat. Clothes are cut with no cap of their own: the body's cap closes the end, and where the body has no skin under the clothes (a MetaHuman under a collar), the clothes close it instead. - Up to 16 cuts per character. - Meshes with wounds and severed parts don't receive decals: the wounds paint them, and a floor decal would stay put while the skin moves through it. Blood drops leave no stain on a skeletal mesh or a part that is falling. - The blood is drops and stains, no fluid. Niagara adds mist and spurts (see Blood), not pools that flow. ## Supported versions Unreal Engine 5.6, 5.7 and 5.8, Windows. Tested with Substrate on and off. Tested on a MetaHuman (body, head, hoodie, cargo pants and shoes following the body) and on a Nanite skeletal mesh: wounds, a forearm off at the joint, a thigh sliced along a plane, the head off with the body going limp, and the clothes hiding the head with the body. Run the material tool on the MetaHuman's skin material (it's a Material Attributes graph).