Diff
1diff --git a/README.md b/README.md
2index 13f708d46bea083c0bd902f5f3ee10042537e67e..315b705e45f8a74bfbd06bd37a9bd29b9c0a85f7 100644
3--- a/README.md
4+++ b/README.md
5@@ -109,8 +109,27 @@ wayland.windowManager.hyprland = {
6 ```
7
8 ### Arch (AUR)
9-There is an unofficial [hy3-git](https://aur.archlinux.org/packages/hy3-git) package,
10-usable with the `hyprland-git` package.
11+
12+> [!IMPORTANT]
13+> Pacman is not very reliable when it comes to building packages in the correct order.
14+> If hy3 fails to load or build, crashes randomly or behaves oddly (commonly dispatchers stop working)
15+> then your packages likely updated in the wrong order, or you have hyprland headers in `/usr/local`.
16+>
17+> To fix this, remove `/usr/include/hyprland`, `/usr/local/include/hyprland`, `/usr/share/pkgconfig/hyprland.pc` and `/usr/local/share/pkgconfig/hyprland.pc`,
18+> then reinstall hyprland and hy3.
19+>
20+> If you know how to fix this please open an issue or pr, or message `@outfoxxed:outfoxxed.me` in the [matrix room](https://matrix.to/#/#hy3-support:outfoxxed.me).
21+
22+hy3 stable (for arch's `hyprland` package) is availible on the AUR as [hy3](https://aur.archlinux.org/packages/hy3).
23+
24+hy3-git (for `hyprland-git` on the AUR, unofficial package) is availible on the AUR as [hy3-git](https://aur.archlinux.org/packages/hy3-git).
25+
26+Both packages install hy3 as `/usr/lib/libhy3.so`.
27+You can enable it in your hyprland configuration by adding the following line anywhere in your `hyprland.conf`
28+
29+```conf
30+plugin = /usr/lib/libhy3.so
31+```
32
33 ### Manual
34 Install hyprland, including its headers and pkg-config file, then run the following commands: