# Aftermath documentation is misleading 

**URL:** <https://forums.unrealengine.com/t/aftermath-documentation-is-misleading/2678916>\
**Category:** Rendering\
**Tags:** unreal-engine, Epic-Pro-Support, question\
**Created:** [October 22, 2025, 3:36pm UTC](https://forums.unrealengine.com/t/aftermath-documentation-is-misleading/2678916 "2025-10-22T15:36:02Z")\
**Posts on this page:** 7\
**Page:** 1

<div class="post-metadata">

**Author:** ![anonymous-edc](https://d3kjluh73b9h9o.cloudfront.net/original/4X/2/8/5/28502927f1d97ba1051b3b47ccfe17233bf41ef0.png) [@anonymous-edc](https://forums.unrealengine.com/u/anonymous-edc)\
**Post date:** [October 22, 2025, 3:36pm UTC](https://forums.unrealengine.com/t/aftermath-documentation-is-misleading/2678916/1 "2025-10-22T15:36:02Z")

</div>

The documentation at [https://dev.epicgames.com/documentation/en-us/unreal-engine/nvidia-nsight-aftermath-for-gpu-pipeline-debugging-in-unreal-engine](https://dev.epicgames.com/documentation/en-us/unreal-engine/nvidia-nsight-aftermath-for-gpu-pipeline-debugging-in-unreal-engine) states that in order to enable Aftermath you need to set r.GPUCrashDebugging=1. This however causes D3D12\_GetDredMode() to return ED3D12DredMode::Full, which enables DRED. And if DRED is enabled, Aftermath initialization in UE::RHICore::Nvidia::Aftermath::InitializeDevice() fails with Result=GFSDK\_Aftermath\_Result\_FAIL\_D3DDebugLayerNotCompatible.

As it turns out, following the documentation disables Aftermath rather than enabling it.

I have tested it only on the main p4 branch, I don’t know how it behaves in UE5.6. But even if the logic behind this CVar has changed only on the main branch and the documentation just lags behind, it’s a deceptive move to reverse the meaning of a CVar.

---

<div class="post-metadata">

**Author:** ![anonymous-edc](https://d3kjluh73b9h9o.cloudfront.net/original/4X/2/8/5/28502927f1d97ba1051b3b47ccfe17233bf41ef0.png) [@anonymous-edc](https://forums.unrealengine.com/u/anonymous-edc)\
**Post date:** [October 22, 2025, 3:36pm UTC](https://forums.unrealengine.com/t/aftermath-documentation-is-misleading/2678916/2 "2025-10-22T15:36:06Z")

</div>

**Steps to Reproduce**

1. Set r.GPUCrashDebugging=1 and expect Aftermath to be enabled
2. Aftermath is disabled

---

<div class="post-metadata">

**Author:** ![TimStullich](https://d3kjluh73b9h9o.cloudfront.net/original/4X/2/8/5/28502927f1d97ba1051b3b47ccfe17233bf41ef0.png) [@TimStullich](https://forums.unrealengine.com/u/TimStullich)\
**Post date:** [October 23, 2025, 9:32am UTC](https://forums.unrealengine.com/t/aftermath-documentation-is-misleading/2678916/3 "2025-10-23T09:32:49Z")

</div>

Hi Gabor,

I just tried this on my end and was able to start Aftermath and complete DRED with GPUCrashDebugging enabled in 5.6. However, this fails on our latest internal build, so it is interesting that you pointed this out. I’ll check internally if we already know about this regression. How did you figure out the initialization failed due to enabling full DRED?

---

<div class="post-metadata">

**Author:** ![anonymous-edc](https://d3kjluh73b9h9o.cloudfront.net/original/4X/2/8/5/28502927f1d97ba1051b3b47ccfe17233bf41ef0.png) [@anonymous-edc](https://forums.unrealengine.com/u/anonymous-edc)\
**Post date:** [October 23, 2025, 1:11pm UTC](https://forums.unrealengine.com/t/aftermath-documentation-is-misleading/2678916/4 "2025-10-23T13:11:30Z")

</div>

Hi Tim,

Yesterday I was convinced it is related to r.GPUCrashDebugging and when I checked the code where is CVarGPUCrashDebugging used before Aftermath initialization, the only place I found was DRED from the following callstack.

```auto
UE::RHI::ShouldEnableGPUCrashFeature(IConsoleVariable &, const wchar_t *)
D3D12_GetDredMode()
FD3D12Adapter::CreateRootDevice(bool)

```

And because Aftermath is not compatible with D3D Debug Layer that’s why I thought that it’s not compatible with DRED either.

Today I’m unable to reproduce the issue. I’m able to launch the editor with both DRED and Aftermath.

Maybe yesterday I caused the issue accidentally by forgetting to disable renderdoc.AutoAttach or -AttachPix, which is understandable that they are not compatible with Aftermath. I’m sorry for drawing the wrong conclusion.

---

<div class="post-metadata">

**Author:** ![TimStullich](https://d3kjluh73b9h9o.cloudfront.net/original/4X/2/8/5/28502927f1d97ba1051b3b47ccfe17233bf41ef0.png) [@TimStullich](https://forums.unrealengine.com/u/TimStullich)\
**Post date:** [October 24, 2025, 9:20am UTC](https://forums.unrealengine.com/t/aftermath-documentation-is-misleading/2678916/5 "2025-10-24T09:20:36Z")

</div>

Okay, I see. Something similar happened to me yesterday when I was testing this issue, and since I cannot repro this again today, it sounds like we can just close this case for now unless you find something else. Let me know what you think.

---

<div class="post-metadata">

**Author:** ![anonymous-edc](https://d3kjluh73b9h9o.cloudfront.net/original/4X/2/8/5/28502927f1d97ba1051b3b47ccfe17233bf41ef0.png) [@anonymous-edc](https://forums.unrealengine.com/u/anonymous-edc)\
**Post date:** [October 24, 2025, 9:55am UTC](https://forums.unrealengine.com/t/aftermath-documentation-is-misleading/2678916/6 "2025-10-24T09:55:15Z")

</div>

I agree, we can close this. Thank you for the help.

But improving the logging might help prevent similar confusion in the future. For example if the Result is GFSDK\_Aftermath\_Result\_FAIL\_D3DDebugLayerNotCompatible then report “A debug layer not compatible with Aftermath has been detected. Make sure to disable Pix, RenderDoc and similar tools.”

---

<div class="post-metadata">

**Author:** ![TimStullich](https://d3kjluh73b9h9o.cloudfront.net/original/4X/2/8/5/28502927f1d97ba1051b3b47ccfe17233bf41ef0.png) [@TimStullich](https://forums.unrealengine.com/u/TimStullich)\
**Post date:** [October 27, 2025, 7:58am UTC](https://forums.unrealengine.com/t/aftermath-documentation-is-misleading/2678916/7 "2025-10-27T07:58:26Z")

</div>

That sounds like something we can look into, although we already print the error code, which can be cross-referenced with the source code to quickly get some info about the initialization failure.
