🧯 Troubleshooting - Jon1969Edwards/VlcMedia_UnrealEngine GitHub Wiki

---

Troubleshooting.md

# 🧯 Troubleshooting

## ❌ Plugin Not Found

- Folder must be named `VlcMedia`
- `.uplugin` file must be inside that folder
- The folder must be inside `/Plugins/` in your project

---

## 🖥️ Black Screen?

Check:

- Material uses **Emissive Color**
- Texture is assigned dynamically
- MediaPlayer is actually playing

---

## 🧊 Editor Freezes?

You may be accessing the MediaTexture from the render thread.

**Fix:**  
Wrap texture access in C++ like so:

```cpp
ENQUEUE_RENDER_COMMAND(FSafeUpdate)(
[](FRHICommandListImmediate& RHICmd) {
    // Safe texture access
});
🐞 Enable Logging (C++)
Inside VlcMediaModule.cpp:

#if UE_BUILD_DEBUG
Args.Add("--file-logging");
Args.Add("--verbose=3");
Args.Add("--logfile=" + FPaths::Combine(FPaths::ProjectLogDir(), TEXT("vlc_debug.log")));
#endif

---