╔══════════════════════════════════════════════════════════════════════════════╗
║              RealNibba's Farm Pack — WoW 3.3.5a (Wrath of the Lich King)     ║
║                         Installation & User Guide                             ║
╚══════════════════════════════════════════════════════════════════════════════╝

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  WHAT'S INCLUDED
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  • RealNibba.Pack   — RealNibba's Farm Pack (farming & economy tools)
  • Auctionator      — Required for Farm Pack price scanning (tested version)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  INSTALLATION
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  1. Close World of Warcraft completely before installing.

  2. Extract the contents of this archive.

  3. Copy BOTH folders into your WoW AddOns directory:
       <WoW Install Folder>\_classic_\Interface\AddOns\

     After copying, the structure should look like:
       Interface\AddOns\RealNibba.Pack\
       Interface\AddOns\Auctionator\

  4. Launch WoW. At the character select screen, click "AddOns"
     (bottom-left button) and make sure both addons are ticked/enabled.

  5. Log in. The addon loads automatically on login.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  IMPORTANT — ELVUI COMPATIBILITY
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  Farm Pack is fully compatible with ElvUI.
  ElvUI will automatically skin the frames with its own style.
  No extra configuration needed — it works out of the box.

  If you prefer the custom dark backdrop texture over ElvUI skinning:
    • Disable "Skins > Ace3 Skin" in ElvUI's config
    • Or use ElvUI's per-addon skin toggle

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  USING FARM PACK
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  MINIMAP BUTTON:
    Left-click        — Open / close the Farm window
    Drag              — Reposition button around the minimap

  MAIN WINDOW BUTTONS:
    Routes    — Manage and load farming routes
    Sessions  — View past farming session history
    Config    — Open addon settings (price sources, scale, etc.)
    Scan Bags — Scan your bags and calculate total loot value

  FARM TRACKER:
    Click START to begin a session. The tracker records:
      • Gold per hour
      • Total gold earned
      • Nodes gathered / items looted
      • Session duration and zone

    Click STOP to end the session. Sessions are saved automatically
    and viewable in the Sessions window.

  ROUTES:
    Load a route to display it on your minimap / world map.
    Routes can be exported and shared with other players.
    Click Export to generate a share string (Ctrl+A, Ctrl+C to copy).

  AH POPUP:
    Appears automatically when you open the Auction House.
    Shows estimated value of items in your bags ready to post.

  MAIL POPUP:
    Appears automatically when you open the Mailbox.
    Assists with bulk mailing farmed items to your bank alt.

  SCAN BAGS:
    Click "Scan Bags" to calculate total bag value using your chosen
    price source (Vendor / Auctionator / TSM) per item quality.
    Configure price sources in Config → Price Sources.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  IMPORTANT NOTES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  • Designed for WoW 3.3.5a (Wrath of the Lich King). Will NOT work
    on Retail WoW.

  • Tested on Warmane Icecrown (x7 rates) and compatible with
    other popular 3.3.5a private servers.

  • AUCTIONATOR (INCLUDED — REQUIRED FOR PRICE SCANNING):
    This pack includes a tested and working version of Auctionator.
    !! IMPORTANT !! If you already have Auctionator installed:
      1. DELETE your existing Auctionator folder from Interface\AddOns\
      2. Install the Auctionator folder included in this pack instead.
    Using any other version of Auctionator may cause price scanning
    to break or return incorrect values in Farm Pack.

  • TSM Pricing: Farm Pack also reads prices from TradeSkillMaster if
    installed. Without TSM, it uses Auctionator (included) or Vendor price.

  • All window positions, scales, and settings are saved per-character
    and restored automatically on next login.

  • If you experience any visual issues with window backgrounds, try
    disabling "ElvUI > Skins > Ace3 Skin" in ElvUI config.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  CREDITS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  Created by RealNibba
  Built for the Warmane community — Icecrown 3.3.5a

  Libraries used (bundled, no separate install needed):
    Ace3 (AceAddon, AceDB, AceGUI, AceComm, AceSerializer, AceEvent)
    LibDBIcon-1.0
    LibDataBroker-1.1
    LibMapData-1.0

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
