# General

The General tab controls core behavior that applies across the whole addon.

## Where to configure
- `/zsbt` -> `General`

## Dungeon/Raid Aware Outgoing
When enabled, ZSBT will apply extra restrictions to outgoing detection while you are in dungeons and raids.

### Why this exists
In group content, some combat text feeds can become ambiguous or can look like “your” damage when it was actually done by a follower/party member.

This setting prioritizes **correct attribution** over **completeness**.

### What you may notice
- Outgoing numbers can become quieter in instances.
- Auto-attacks may be suppressed in some situations.

### When to enable
- If you see outgoing damage/heals that clearly aren’t yours in dungeons/raids.

### When to disable
- If you are solo and you want the maximum amount of outgoing detail.

## Experimental fallbacks (instances)
These options are only shown when `Dungeon/Raid Aware Outgoing` is enabled.

### Auto-Relax Outgoing When Solo (Legacy Instances)
Relaxes strict/quiet outgoing attribution while you are solo inside party/raid instances, which is useful for legacy content where one-shot hits can otherwise be suppressed.

- Pros: restores more outgoing detail while soloing old instances.
- Cons: should stay off if you are trying to diagnose strict attribution behavior.

### Use Damage Meter Outgoing Fallback (Experimental)
Uses Blizzard’s damage meter totals as a last-resort outgoing source when normal outgoing detection is too quiet in instances.

- Pros: restores outgoing visibility in follower dungeons.
- Cons: may be less detailed and can increase duplicates if other sources are also active.

### Use Damage Meter Incoming Damage Fallback (Experimental)
Uses Blizzard’s damage-taken totals as a last-resort incoming damage source when incoming combat text becomes ambiguous/secret in instances.

- Pros: restores incoming damage visibility when combat text is hidden/secret.
- Cons: may be less detailed and can increase noise.

### Show Auto Attacks in Instances (Experimental)
Enables a conservative fallback for auto-attacks in restricted instance mode.

- Pros: restores missing swing numbers.
- Cons: in rare cases may misattribute follower/other melee swings.

## Quick Control Bar
The Quick Control Bar is an optional on-screen widget that lets you toggle common tuning settings without opening the full configuration UI.

### Enable
- `/zsbt` -> `General` -> `Enable Quick Control Bar`

### How to use
- Drag the bar to position it anywhere on your screen.
- Use `Instance` to toggle Dungeon/Raid tuning options.
- Use `Open World` to toggle Open-World tuning options.
- Use `PvP` to toggle PvP tuning options.
- Use `Unlock/Lock` to quickly unlock scroll areas for dragging.

## Open-World Tuning
These settings change how ZSBT attributes outgoing events in open world and edge cases.

### Quiet Outgoing When Idle
Suppress outgoing numbers from ambiguous attribution sources unless they can be correlated to your own casts/periodic effects.

- Pros: reduces incorrect outgoing attribution on shared targets.
- Cons: may reduce outgoing numbers (especially auto-attacks) depending on your tuning choices.

### Allow Auto Attacks While Quiet
Optional companion toggle for melee classes. Re-enables a conservative auto-attack fallback while Quiet Outgoing is enabled.

## PvP Tuning
These settings change how ZSBT attributes outgoing events in PvP instances (battlegrounds/arenas).

### PvP Strict Mode
In PvP, some outgoing feeds can be ambiguous and can cause incorrect outgoing attribution.

PvP Strict Mode prioritizes correctness by tightening attribution rules.

### Disable Auto-Attack Fallback (PvP)
Optional companion toggle for PvP Strict Mode. Suppresses the last-resort auto-attack fallback used in restricted attribution modes.

## Defaults and migration
ZSBT ships with recommended defaults for Dungeon/Raid and Open-World tuning. On upgrade, ZSBT only applies these defaults to existing profiles when a setting is unset (nil), and does not overwrite explicit user choices.

## Recommended test checklist
1. Enable `Dungeon/Raid Aware Outgoing`.
2. Do a small follower dungeon pull.
3. If outgoing is too quiet, enable `Use Damage Meter Outgoing Fallback (Experimental)` and retest.
4. If incoming damage is missing/secret, enable `Use Damage Meter Incoming Damage Fallback (Experimental)` and retest.
5. Only if swings are missing, try `Show Auto Attacks in Instances (Experimental)`.
