From 060b77c48c8b212df0cb82af48ba7c24199c1c16 Mon Sep 17 00:00:00 2001
From: Scarecr0w12 <jacob.r.bowen1@gmail.com>
Date: Wed, 1 Apr 2026 13:47:04 -0400
Subject: [PATCH] docs: clarify mod-playerbots dependency

---
 CHANGELOG.md |  1 +
 README.md    | 24 +++++++++++++++++++-----
 2 files changed, 20 insertions(+), 5 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 8188264..78f4c0e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,6 +7,7 @@ All notable changes to `mod-gold-rush` will be documented in this file.
 ### Added
 - Standalone repository documentation in `README.md`.
 - Initial `CHANGELOG.md` for tracking module releases.
+- Clear documentation that `mod-playerbots` is a required dependency.
 
 ### Changed
 - Loosened Gold Rush hotspot selection so events can fall back to eligible
diff --git a/README.md b/README.md
index 0646f0b..7512484 100644
--- a/README.md
+++ b/README.md
@@ -6,6 +6,17 @@ eligible open-world zone, anchors on a live player, spawns temporary resource
 nodes near the hotspot, announces the event to the server, and can route
 playerbots into the area to create a PvPvE scramble.
 
+## Requirements
+
+> **Required dependency:** `mod-playerbots` must be installed and enabled.
+> Gold Rush includes direct playerbot integration and will not work correctly
+> without the Playerbots module.
+
+- Requires AzerothCore.
+- Requires `mod-playerbots`.
+- Gold Rush bot routing, hotspot pressure, and related behavior depend on
+  Playerbots APIs.
+
 ## Features
 
 - Schedules Gold Rush events on a random interval.
@@ -30,12 +41,13 @@ playerbots into the area to create a PvPvE scramble.
 
 ## Installation
 
-1. Place `mod-gold-rush` inside the AzerothCore `modules/` directory.
-2. Re-run CMake so AzerothCore detects the module.
-3. Build and install/update your server.
-4. Copy `conf/gold_rush.conf.dist` to your generated module config directory as
+1. Make sure `mod-playerbots` is already installed in your AzerothCore setup.
+2. Place `mod-gold-rush` inside the AzerothCore `modules/` directory.
+3. Re-run CMake so AzerothCore detects the module.
+4. Build and install/update your server.
+5. Copy `conf/gold_rush.conf.dist` to your generated module config directory as
    `gold_rush.conf` if you want local overrides.
-5. Restart `worldserver`.
+6. Restart `worldserver`.
 
 ## Configuration
 
@@ -67,6 +79,8 @@ Important options:
 - Event locations are announced approximately, not with exact coordinates.
 - Hotspots are temporary and despawn at event end.
 - Eligible anchors must be in open-world, non-city, non-sanctuary zones.
+- `mod-playerbots` is required because Gold Rush actively routes random bots to
+  the event hotspot.
 - Blacklisted zones and zone/area pairs are excluded from selection.
 - Node selection alternates between ore-like and herb-like entries when
   possible.