# Getting Started

## Open the configuration
- Type `/zsbt` in chat.
- Use the tabs on the left to configure features.

## Recommended first run
- **Optional: choose a preset profile**
  - Go to `Profiles`.
  - Select one of the shipped preset profiles (Melee / Ranged / Tank / Healer / Pet Class).
  - If you ever want to restore a preset back to its shipped layout, use the reset buttons at the bottom of `Profiles`.
- **Enable the addon**
  - Go to `General`.
  - Make sure `Enabled` is on.
- **Confirm scroll areas are enabled**
  - Go to `Display` -> `Scroll Areas`.
  - Ensure the `Incoming`, `Outgoing`, and `Notifications` areas are enabled.
- **Unlock and place scroll areas**
  - Go to `Display` -> `Scroll Areas`.
  - Use the unlock/move controls (if present) to position each area where you want it.
  - Adjust `Width` / `Height` so text doesn’t clip.
- **Pick your number formatting**
  - Go to `General` -> `Numbers`.
  - Choose the Number Format you prefer (full numbers, abbreviated, etc.).
- **Pick fonts**
  - Go to `General` for the master font.
  - Optionally override fonts per scroll area in `Display` -> `Scroll Areas`.
- **Test**
  - Hit a target dummy or fight a mob.
  - You should see:
    - Incoming damage/heals in `Incoming`
    - Your damage/heals in `Outgoing`
    - Alerts (if enabled) in `Notifications`

## Quick setup checklist
- **Optional: pick a preset profile**
  - Go to `Profiles`.
  - Select a shipped preset profile.
- **Enable ZSBT**
  - Go to `General`.
  - Make sure `Enabled` is on.
- **Pick your font**
  - Go to `General`.
  - Adjust the master font (face/size/outline).
- **Place your scroll areas**
  - Go to `Display` -> `Scroll Areas`.
  - Move/size the `Incoming`, `Outgoing`, and `Notifications` areas.
- **Confirm you see messages**
  - Hit a target dummy or fight a mob.
  - You should see numbers in `Incoming` / `Outgoing` and alerts in `Notifications`.

## Common first tweaks
- **Too much spam**
  - Go to `Combat Text` -> `Spam Control`.
  - Enable merging and set reasonable minimum thresholds.
- **Don’t want auto-attack clutter**
  - Go to `Combat Text` -> `Outgoing`.
  - Adjust `Auto Attack` display and/or raise the outgoing damage min threshold.
- **Want cooldown / proc / warning style alerts**
  - Go to `Alerts` -> `Notifications`.
  - Enable the categories you care about and route them to the `Notifications` scroll area.

## Common commands
- `/zsbt` Open configuration
- `/zsbt minimap` Toggle minimap button
- `/zsbt reset` Reset settings to defaults
- `/zsbt version` Show addon version

## Troubleshooting
- **Nothing shows**
  - `/zsbt` -> `General` -> `Enabled`
  - `/zsbt` -> `Display` -> `Scroll Areas` -> enable at least one visible scroll area
  - If `Combat Only` is enabled, test while in combat
  - Temporarily lower thresholds to confirm output is working
  - `/reload`
- **More help**
  - See: [Troubleshooting](14-Troubleshooting.md)

## Next reading
- [General](00-General.md)
- [Scroll Areas](02-Scroll-Areas.md)
- [Incoming](03-Incoming.md)
- [Outgoing](04-Outgoing.md)
- [Spam Control](06-Spam-Control.md)
- [Diagnostics](11-Diagnostics.md)
