# XWUIGameQuestTracker

A HUD-style sidebar quest tracker that lists active quests with collapsible objectives and per-objective progress. Each `quests[]` entry has a `title`, `active`/`completed` flags, and `objectives` with `text`, `current`/`target` counts (a `current/target` counter shows when `target > 1`) and a `completed` flag; status icons distinguish completed, active, and pending quests. It honors the `position` (right/left), `maxVisible`, and `showCompleted` conf_comp options, auto-expands active quests, and exposes a runtime API - `addQuest`, `removeQuest`, `setActiveQuest`, `completeObjective`, and `updateObjectiveProgress` (which auto-completes a quest once all objectives are done). Use it as the persistent on-screen objective overlay during play.

## Basic Usage

A right-anchored tracker with one active multi-objective quest (auto-expanded, including a 3/5 progress counter) and one inactive quest collapsed beneath it.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: A quest tracker with an active multi-objective quest (with a 3/5 counter) and a second inactive quest.
```

## Left Rail Tracker

The tracker pinned to the left edge with two active quests, each objective showing a multi-step progress counter.

```example
file: examples/LeftRailTracker.ts
html: examples/BasicUsage.html
title: Left Rail Tracker
description: A left-positioned tracker with two active quests whose objectives all carry progress counters.
```

## Active Only

With completed quests hidden, a finished quest is filtered out and only the in-progress quest's objective checklist remains.

```example
file: examples/ActiveOnly.ts
html: examples/BasicUsage.html
title: Active Only
description: A tracker with showCompleted off, hiding a completed quest and showing only the active quest's objectives.
```

```api
```