> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.cyanplex.net/llms.txt
> Use this file to discover all available pages before exploring further.

# fixing-resource-pack-crashes

> Diagnose and fix Minecraft crashes caused by the Cyan Plex resource pack, covering driver updates, mod conflicts, and log file locations.

If Minecraft crashes when loading the Cyan Plex resource pack, you're not alone, this is most commonly reported on devices running **Intel UHD Graphics** or older Intel integrated GPUs. The steps below cover the most effective fixes in order of likelihood, so work through them from the top before skipping ahead.

<Steps>
  <Step title="Update your graphics drivers">
    Outdated Intel UHD drivers are the single most common cause of resource pack crashes. Visit the [Intel Download Center](https://www.intel.com/content/www/us/en/download-center/home.html), search for your GPU model, and install the latest available driver. Restart your computer once the installation is complete, then try launching Minecraft again.
  </Step>

  <Step title="Update Minecraft">
    Make sure you are running the **latest release** of Minecraft. The resource pack may use rendering features or textures that are not supported in older versions. Open your launcher, check for updates, and upgrade if a newer version is available.
  </Step>

  <Step title="Disable Iris / Sodium">
    Iris Shaders can conflict directly with our resource pack's rendering pipeline. Open your `.minecraft/mods` folder and **remove or disable** `iris-*.jar` (and `sodium-*.jar` if present). Launch Minecraft without them and attempt to join the server again.
  </Step>

  <Step title="Remove all mods and test">
    If the crash persists, clear your entire `.minecraft/mods` folder and test with a completely vanilla setup. If the crash disappears, re-add your mods **one at a time**, restarting Minecraft each time, until the crash returns, the last mod you added is the culprit.
  </Step>

  <Step title="Switch to a clean launcher">
    Launchers like **FastClient** and **SKLauncher** are known to inject additional mods into your game automatically, which can trigger conflicts. Switch to [AstralRinth](https://git.astralium.su/didirus/AstralRinth/releases/tag/AR-0.16.102), it launches Minecraft without adding anything extra, giving you a clean environment to test with.
  </Step>
</Steps>

## Still crashing? Get support

If none of the steps above resolved the crash, reach out to us with your log files attached. Our team needs these files to diagnose the issue.

<Tabs>
  <Tab title="Windows">
    Locate the following files in File Explorer or paste the paths directly into the Explorer address bar:

    ```text theme={null}
    Log file:      %AppData%\.minecraft\logs\latest.log
    Crash reports: %AppData%\.minecraft\crash-reports\
    ```
  </Tab>

  <Tab title="macOS">
    Open Finder, press **⌘ + Shift + G**, and paste the paths below:

    ```text theme={null}
    Log file:      ~/Library/Application Support/minecraft/logs/latest.log
    Crash reports: ~/Library/Application Support/minecraft/crash-reports/
    ```
  </Tab>

  <Tab title="Linux">
    Navigate to the following paths in your file manager or terminal:

    ```text theme={null}
    Log file:      ~/.minecraft/logs/latest.log
    Crash reports: ~/.minecraft/crash-reports/
    ```
  </Tab>
</Tabs>

<Note>
  Attach both `latest.log` **and** the relevant crash report file (named with a timestamp) when posting your support request. Reports without logs take significantly longer to resolve.
</Note>

## Last resort: disable the resource pack

If you need to play immediately while waiting for a fix, you can prevent the resource pack from loading entirely.

<Warning>
  Disabling the server resource pack means the game will use default Minecraft textures. You will not see any of Cyan Plex's custom blocks, items, or visual effects until the pack is re-enabled.
</Warning>

<Steps>
  <Step title="Open the Server List">
    Launch Minecraft and navigate to the **Multiplayer** screen.
  </Step>

  <Step title="Edit the Cyan Plex entry">
    Hover over **Cyan Plex** in the list and click the **Edit** (pencil) button.
  </Step>

  <Step title="Disable the resource pack">
    Find the **Server Resource Packs** option and set it to **Disabled**.
  </Step>

  <Step title="Save and join">
    Click **Done** to save your changes, then join the server as normal. The resource pack will no longer be downloaded or applied.
  </Step>
</Steps>