# RL Gearscore / Item Level

RL Gearscore is a lightweight World of Warcraft addon that shows the **average item level** and a simple **gearscore** estimate for players directly in tooltips and chat.  
It is designed to be minimal, clear and easy to use.

## Features

- Shows **average item level** (iLvl Ø) in tooltips for players.
- Shows a simple **total gearscore** value for equipped items.
- Optional display of:
  - Guild name and guild rank
  - Level / race / class line
  - Talent distribution (e.g. `0/31/10`) for players
  - Basic quest information for enemies
- Adds a clear colored header line to the tooltip for better readability.
- Provides a **slash command** to print gear information to chat.
- Includes a **movable minimap button** with tooltip and quick access to settings.
- Supports **multiple languages** (German / English / automatic based on client).

## Installation

1. Download or copy the addon folder `RLGearscore` into your WoW AddOns directory, for example:

   ```text
   World of Warcraft\_retail_\Interface\AddOns\RLGearscore
   ```

2. Make sure the file `RLGearscore.toc` is directly inside the `RLGearscore` folder.
3. Start the game or type `/reload` in the chat to reload the UI.
4. Enable **RL Gearscore/Item Level** in the in-game AddOns list at the character selection screen.

## Usage

### Tooltips

Move your mouse over a player or an item:

- For **items**, the addon adds:
  - A header line
  - The item level (if available)
  - The gearscore value (if enabled)

- For **players**, the addon adds:
  - Average item level (colored by difficulty compared to your own gear)
  - Total gearscore (colored)
  - Optional talent distribution
  - Optional line showing the target of the inspected player

### Chat Command

Use the slash command:

```text
/rlgs
```

- If you have a valid player **target**, it uses the target.
- Otherwise it falls back to **your own character**.
- The addon prints a summary like:
  - Character name with level / race / class
  - Average item level
  - Gearscore
  - Talents (if available)

You can optionally provide a chat channel:

```text
/rlgs group
/rlgs raid
/rlgs party
/rlgs say
```

If the channel is valid (for example you are in a group or raid), RL Gearscore will send the gear information to that channel.

## Minimap Button

RL Gearscore adds a small minimap button using the addon logo.

- **Left-click**: Open or close the options window.
- **Right-click**: Toggle the addon on or off.
- You can **drag** the button around the minimap; its position is saved.

## Options

Click the minimap icon, or use `/rlgs` and open settings via the minimap button.

The options window has multiple tabs:

### Settings Tab

Controls what information is shown:

- Enable addon
- Show guild
- Show guild rank
- Show level/race/class line
- Show item level
- Show gearscore
- Show talents
- Show quest information

Changes are saved automatically.

### Language Tab

Controls the language used by the addon:

- **Automatic** – Uses the WoW client language (e.g. deDE → German).
- **German**
- **English**

When you change the language, all labels and texts in the options window update immediately. Tooltips and chat messages will use the new language from the next time they are shown.

### About Tab

Shows the addon title, logo and author / contact information.

## Saved Data

The addon uses a SavedVariables table:

- `RLGearscoreDB`

This stores:

- Enabled state
- Language choice
- Options for what to display in tooltips
- Minimap button position

If you want to reset all settings, you can delete `RLGearscoreDB` from your SavedVariables file while the game is closed.

## Author

- **Author**: XamiraNRW – RL-Dev  
- Contact and donation information can be found in the About tab of the addon.

