From c924a2a39cfbb192cdeb0667cefd73bb79e84bf2 Mon Sep 17 00:00:00 2001
From: Alexander Drozdov <snosme@gmail.com>
Date: Thu, 14 Dec 2023 10:45:56 +0200
Subject: [PATCH] add "Failed to load leagues" docs

---
 docs/.vitepress/config.js   |  2 +-
 docs/failed-load-leagues.md | 30 ++++++++++++++++++++++++++++++
 docs/issues.md              |  3 ++-
 3 files changed, 33 insertions(+), 2 deletions(-)
 create mode 100644 docs/failed-load-leagues.md

diff --git a/docs/.vitepress/config.js b/docs/.vitepress/config.js
index 143f7b74..abd9f54e 100644
--- a/docs/.vitepress/config.js
+++ b/docs/.vitepress/config.js
@@ -20,7 +20,7 @@ export default defineConfig({
   },
   themeConfig: {
     // logo: 'TODO', https://github.com/vuejs/vitepress/issues/1401
-    appVersion: '3.22.10005',
+    appVersion: '3.23.10001',
     github: {
       releasesUrl: 'https://github.com/SnosMe/awakened-poe-trade/releases'
     },
diff --git a/docs/failed-load-leagues.md b/docs/failed-load-leagues.md
new file mode 100644
index 00000000..099813ca
--- /dev/null
+++ b/docs/failed-load-leagues.md
@@ -0,0 +1,30 @@
+---
+title: Failed to load leagues
+---
+
+![](https://i.imgur.com/jzhlnmP.png)
+
+Most likely, leagues cannot be loaded because Cloudflare suspects you are a bot.
+GGG uses Cloudflare's bot protection services to ensure fair access to the trade site,
+especially during league launch.
+
+1. The permanent solution to this is to change the IP address
+or write to GGG support.
+
+2. If you are ok with the temporary solution,
+you will need to complete a CAPTCHA every ~15 minutes.
+
+    - Click on "Browser" button. Wait untill you see a CAPTCHA and complete it.
+    Alternatively, you can get a lightweight bot check, which means you just
+    wait ~5 seconds and see the screenshot below.
+
+    - Once you see the barely visible text with the list of leagues,
+    click on the "Retry" button, now everything should work.
+    ![](https://i.imgur.com/iMkTPIY.png)
+
+---
+
+If you've opened Browser, waited for a while and see nothing,
+then the problem is with the network. A simple PC reboot usually helps.
+
+People have encountered some weirdness related to VPN and [DNS](https://github.com/SnosMe/awakened-poe-trade/issues/1038#issuecomment-1691780513) settings.
diff --git a/docs/issues.md b/docs/issues.md
index 296270d5..06e2a758 100644
--- a/docs/issues.md
+++ b/docs/issues.md
@@ -11,7 +11,7 @@ title: Common issues
 
 3. Are you playing with Vulkan renderer? Update GPU drivers.
 
-    If Awakened works for you with DirectX11 renderer,
+    If Awakened works for you with DirectX11/12 renderer,
     then problem is old Vulkan drivers for sure.
 
 4. Delete `%appdata%\awakened-poe-trade`
@@ -32,6 +32,7 @@ title: Common issues
 ---
 
 - 🔥[There are no stats to select from when price checking](/no-item-mods)
+- [Failed to load leagues](/failed-load-leagues)
 - [How to remove the stopwatch in center of screen?](https://github.com/SnosMe/awakened-poe-trade/issues/219)
 - [Sends a whisper when doing price-check](https://github.com/SnosMe/awakened-poe-trade/issues/178)