================================================================================
  COPPERWATCHSYNC - Real-Time Auction House Prices for WoW 3.3.5
================================================================================

Version: 1.0.3
Compatible with: WoW 3.3.5 (Ascension)
Website: https://copperwatch.cc

================================================================================
  WHAT IS THIS?
================================================================================

CopperwatchSync displays real-time auction house prices in item tooltips using
data from the Copperwatch server. It works in two modes:

1. TSM INTEGRATION MODE (if TradeSkillMaster is installed)
   - Automatically injects Copperwatch prices into TSM's tooltip system
   - Your tooltips will show server-sourced prices without scanning the AH

2. STANDALONE MODE (if TSM is not installed)
   - Displays custom price tooltips with market value, min buyout, quantity,
     auction counts, and last update time
   - Works on any item, anywhere (bags, AH, chat links, equipped items)

================================================================================
  INSTALLATION
================================================================================

STEP 1: Install the Addon
--------------------------
1. Download the latest CopperwatchSync_Data.lua from:
   https://copperwatch.cc/downloads

2. Copy the entire "CopperwatchSync" folder to:
   <WoW Install>/Interface/AddOns/

   Example path:
   C:\Program Files\World of Warcraft\Interface\AddOns\CopperwatchSync\

3. The folder should contain:
   - CopperwatchSync.toc
   - CopperwatchSync.lua
   - CopperwatchSync_Data.lua
   - README.txt (this file)

STEP 2: Load the Addon
-----------------------
1. Start World of Warcraft
2. At the character select screen, click "AddOns" button
3. Make sure "CopperwatchSync" is checked/enabled
4. Log in to your character

STEP 3: Verify Installation
----------------------------
1. Type: /cws status
2. You should see:
   - Version number
   - Number of items loaded
   - Current mode (TSM or Standalone)

3. Hover over any item in your bags
   - You should see "Copperwatch Prices:" in the tooltip

================================================================================
  UPDATING PRICE DATA
================================================================================

METHOD 1: Manual Update (Phase 1)
----------------------------------
1. Download latest CopperwatchSync_Data.lua from the website
2. Replace the file in your addon folder:
   Interface/AddOns/CopperwatchSync/CopperwatchSync_Data.lua
3. In-game, type: /reload
4. Or type: /cws reload

METHOD 2: Automatic Update (Phase 2 - Coming Soon)
---------------------------------------------------
The Rust companion app will automatically:
- Download latest price data based on your subscription tier
- Update the file in your addon folder
- Hot-reload prices without needing /reload

================================================================================
  SLASH COMMANDS
================================================================================

/cws help       - Show list of commands
/cws status     - Display addon status and loaded item count
/cws reload     - Reload price data from file
/cws mode       - Show current mode (TSM Integration or Standalone)
/cws debug      - Toggle debug output
/cws enable     - Enable the addon
/cws disable    - Disable the addon

You can also use the full command: /copperwatchsync

================================================================================
  TOOLTIP EXAMPLES
================================================================================

STANDALONE MODE:
----------------
[Silver Ore]
Binds when equipped
...
Copperwatch Prices:
  Market Value: 69g 42s
  Min Buyout: 69g 42s
  Quantity: 420 items in 420 auctions
  Last Update: 2 hours ago

TSM INTEGRATION MODE:
---------------------
Your existing TSM tooltips will display Copperwatch prices automatically.
No additional configuration needed!

================================================================================
  COLOR CODING
================================================================================

Prices are color-coded to help you spot deals:

- GREEN:        50% or less of market value (amazing deal!)
- LIGHT GREEN:  50-80% of market value (good deal)
- WHITE:        80-120% of market value (fair price)
- ORANGE:       120-150% of market value (expensive)
- RED:          150%+ of market value (overpriced)

Timestamps are also color-coded:
- GREEN:        Very recent (< 1 hour)
- WHITE:        Recent (1-24 hours)
- YELLOW:       1-7 days old
- ORANGE:       1+ weeks old

================================================================================
  TROUBLESHOOTING
================================================================================

ISSUE: "No price data found" error
FIX: Download CopperwatchSync_Data.lua from the website and place it in the
     addon folder, then type /reload

ISSUE: No tooltips showing
FIX: 1. Check if addon is enabled: /cws status
     2. Make sure addon is enabled at character select screen
     3. Try: /cws enable
     4. Type: /reload

ISSUE: Prices seem outdated
FIX: Download the latest data file from the website and type /reload

ISSUE: Conflicts with other tooltip addons
FIX: Try disabling other tooltip addons temporarily to test. CopperwatchSync
     is designed to work with most addons, but some may conflict.

ISSUE: TSM still showing old scan data
FIX: CopperwatchSync injects prices but TSM may cache values. Try:
     1. /cws reload
     2. /reload
     3. Clear TSM cache if problem persists

================================================================================
  FAQ
================================================================================

Q: Do I need TradeSkillMaster installed?
A: No! CopperwatchSync works standalone or with TSM.

Q: How often should I update the price data?
A: Depends on your subscription tier:
   - Gold:   Every 10 minutes (automated with Rust companion)
   - Silver: Every 20 minutes
   - Copper: Every 30 minutes
   - Free:   Every 60 minutes

Q: Does this replace TSM?
A: No, this complements TSM. If you have TSM, you get the best of both:
   TSM's powerful features + Copperwatch's real-time server prices.

Q: Is this against WoW's Terms of Service?
A: No. This addon only reads data files and displays information. It does not
   automate gameplay, interact with the game server inappropriately, or
   provide any unfair advantage. It's similar to other auction addons.

Q: Can I use this on multiple realms?
A: Currently, each data file is realm-specific. The Phase 2 Rust companion
   will support multiple realms automatically.

Q: Where does the price data come from?
A: Prices are aggregated from user-uploaded TSM scans on the Copperwatch
   server. The more users contribute scans, the more accurate the data!

================================================================================
  CONTRIBUTING DATA
================================================================================

Want to help make Copperwatch prices more accurate?

PHASE 1 (Current):
- After running a TSM auction scan, upload your scan data via the website
- Your contribution helps everyone get better prices!

PHASE 2 (Coming Soon):
- The Rust companion will automatically upload your scans
- Just play and scan the AH normally - the companion handles the rest!

================================================================================
  SUPPORT
================================================================================

Need help? Found a bug?

Website:  https://copperwatch.cc
Discord:  [Your Discord Link]
Email:    [Your Support Email]

Please include:
- WoW version (e.g., 3.3.5 Ascension)
- Addon version (type /cws status)
- Description of the issue
- Any error messages

================================================================================
  CHANGELOG
================================================================================

Version 1.0.0 (2026-02-16)
--------------------------
- Initial release
- TSM integration mode
- Standalone tooltip mode
- Slash commands
- Color-coded prices
- Relative timestamps
- Silver Ore test data (69g 42s)

Version 1.0.3 (current)
--------------------------
- TSM tooltip text-replacement fix (no more duplicate tooltips)
- Coin icons instead of g/s/c letters
- Fixed timestamp display
- See VERSION.txt for the full fix history

================================================================================
  LICENSE
================================================================================

Copyright (c) 2026 Copperwatch
All rights reserved.

This addon is provided for use with the Copperwatch service.
Redistribution and modification are not permitted without permission.

================================================================================
  THANKS FOR USING COPPERWATCHSYNC!
================================================================================

Happy auctioneering! May all your deals be green!

For the latest updates, visit: https://copperwatch.cc
