# Settings Reference

**1. Enable/Disable Components Group (┏╸⚙️)**

This group contains the master switches for each major analytical component of the indicator.

* **Market Structure:**
  * **Default:** On
  * **Description:** Toggles the visibility of all Market Structure components, including swing point labels (HH, LL, etc.), CHoCH/BOS lines, and the trend-based bar coloring.
* **Support & Resistance:**
  * **Default:** On
  * **Description:** Enables or disables the automatic detection and plotting of support and resistance zones based on historical price pivots.
* **Psychological Levels:**
  * **Default:** Off
  * **Description:** Toggles the display of horizontal price levels based on round numbers and price volatility, which can act as psychological S/R.
* **Liquidation Heatmap:**
  * **Default:** On
  * **Description:** Enables or disables the Liquidation Heatmap, which visualizes potential liquidity zones on the right side of the chart and as colored zones extending from price action.
* **Trend Lines:**
  * **Default:** Off
  * **Description:** Activates the automatic trend line detection and plotting feature, including trend line break signals.
* **FOMO Bubbles:**
  * **Default:** Off
  * **Description:** Toggles the "FOMO Bubbles" which appear during periods of unusually high volume, indicating potential market excitement or exhaustion.

#### **2. Market Structure Group (〽️)**

This group controls how market structure is identified and displayed.

* **Market Structure Time-Horizon:**
  * **Default:** 12
  * **Description:** Controls the lookback period used to identify swing highs and lows. A larger number will focus on longer-term market structure, while a smaller number will identify shorter-term structure.
* **CHoCH/BOS Line Style:**
  * **Default:** Solid
  * **Options:** Solid, Dashed, Dotted
  * **Description:** Sets the visual style for the lines drawn when a Change of Character (CHoCH) or Break of Structure (BOS) occurs. This is purely aesthetic.
* **Enable Swing Points:**
  * **Default:** On
  * **Description:** Toggles the visibility of the text labels for Higher Highs (HH), Lower Lows (LL), Higher Lows (HL), and Lower Highs (LH).
* **Market Structure Colors:**
  * **Description:** Sets the Bullish (cyan) and Bearish (red) colors used for market structure labels (HH, HL), CHoCH/BOS lines, and the main bar coloring.

#### **3. Support & Resistance Group (🧱)**

This group manages the settings for the automatic support and resistance zone plotting.

* **Support & Resistance Time-Horizon:**
  * **Default:** 12
  * **Description:** The lookback period for identifying the pivot highs and lows that form the basis of the S/R zones.
* **Zone Expiry Age:**
  * **Default:** 1200
  * **Description:** The maximum number of bars a zone can exist on the chart before it is automatically removed. This helps keep the chart clean by removing very old, potentially irrelevant zones.
* **Swing Points Search Limit:**
  * **Default:** 700
  * **Description:** The maximum number of bars the indicator will look back to find a matching swing point to form a new S/R zone.
* **Visual Repainting:**
  * **Default:** On
  * **Description:** When enabled, zones are drawn starting from the original pivot where they were first identified, creating a cleaner look. When disabled, zones are drawn from the bar where the zone was confirmed, which can be useful for backtesting to see exactly when the signal appeared.
* **Support & Resistance Base/Highlight Color:**
  * **Description:** Sets the colors for S/R zones. The Base Color is for newly formed zones, and the Highlight Color is used when a zone is re-tested or strengthened by subsequent price action.

#### **4. Psychological Levels Group (🔮)**

This group controls the horizontal price levels based on psychological round numbers.

* **Automatic levels:**
  * **Default:** On
  * **Description:** If enabled, the indicator automatically calculates the appropriate distance between levels based on recent price volatility. If disabled, the 'Manual Spread Factor' is used instead.
* **Spread Multiplier:**
  * **Default:** 5
  * **Description:** When 'Automatic levels' is on, this value multiplies the automatically detected spread. Use a larger value to space the levels further apart, or a smaller value to bring them closer.
* **Manual Spread Factor:**
  * **Default:** 5000
  * **Description:** If 'Automatic levels' is disabled, this fixed value is used to set the distance between each psychological level (e.g., levels will be drawn at 5000, 10000, 15000, etc.).
* **Visible Levels:**
  * **Default:** 12
  * **Description:** Determines the number of levels to draw above and below the current price.
* **Psychological Levels Base/Highlight Color:**
  * **Description:** Sets the color for the standard levels (Base) and the color for the level closest to the current price (Highlight).

#### **5. Liquidation Heatmap Group (🔥)**

This group configures the visualization of potential liquidity pools.

* **Heatmap Look-Back:**
  * **Default:** 50
  * **Range:** Minimum 5
  * **Description:** The lookback period for calculating liquidity. A larger number will identify longer-term liquidity zones, while a smaller number focuses on short-term liquidity.
* **Resolution:**
  * **Default:** 10
  * **Range:** 3 to 29
  * **Description:** Controls the number of vertical cells in the heatmap gradient. A higher resolution provides a more detailed heatmap but may increase indicator loading time.
* **Liquidity Scale Colors:**
  * **Description:** Sets the three-color gradient for the heatmap, representing the transition from low liquidity (bottom color) through medium (middle color) to high liquidity (top color).

#### **6. Trend Lines Group (📐)**

This group controls the automatic trend line drawing feature.

* **Trend Lines Look-Back:**
  * **Default:** 7
  * **Range:** Minimum 5
  * **Description:** The lookback period for identifying pivots used to draw trend lines. A higher value will detect more significant, longer-term trend lines.
* **Noise Filter Factor:**
  * **Default:** 3.0
  * **Range:** 1.0 to 10.0
  * **Description:** This value controls the width of the trend line's "buffer zone." A higher value creates a wider channel, which helps filter out minor price fluctuations and false breakouts, but may result in a slower signal for true breakouts.
* **Show Trend Line Signals:**
  * **Default:** On
  * **Description:** Toggles the visibility of the triangle markers (▲/▼) that appear when price breaks a confirmed trend line.
* **Trend Line Signal Colors:**
  * **Description:** Sets the colors for the bullish breakout signal (cyan) and the bearish breakout signal (red).

#### **7. FOMO Bubbles Group (🫧)**

This group configures the detection of extreme volume spikes indicating potential FOMO (Fear Of Missing Out).

* **FOMO Look-Back:**
  * **Default:** 14
  * **Range:** Minimum 5
  * **Description:** The lookback period used in the FOMO calculation. A higher value is less sensitive and will result in fewer bubbles.
* **FOMO Bubble Version:**
  * **Default:** FOMO V2
  * **Options:** FOMO V2, FOMO V1
  * **Description:** Selects the algorithm used for detecting FOMO. V2 is a newer, volatility-adjusted version.
* **Noise Filter Factor (for V1):**
  * **Default:** 7.0
  * **Range:** 1.0 to 10.0
  * **Description:** This sensitivity multiplier is only applicable if 'FOMO Bubble Version' is set to 'FOMO V1'. A higher value reduces sensitivity and filters out more noise.
* **FOMO Bubble Colors:**
  * **Description:** Sets the colors for the bullish (cyan) and bearish (red) FOMO bubbles.

#### **8. Alerts Group (⚠️)**

This group contains all settings for the advanced, multi-step alert system.

* **Show Historical Alerts:**
  * **Default:** Off
  * **Description:** Toggles a background shape at the bottom of the chart, showing where your custom multi-step alert conditions would have historically triggered.
* **Invalidation Type:**
  * **Default:** Time Interval
  * **Options:** Time Interval, Strict Sequence, Invalidate on Step 1
  * **Description:** Defines the rule for when a partially completed alert sequence should be reset.
* **Reset Timeout (bars):**
  * **Default:** 50
  * **Description:** If 'Invalidation Type' is 'Time Interval', this sets the number of bars an active step will wait for the next step before the entire sequence is reset.
* **External Condition 1-5:**
  * **Description:** A set of 5 inputs for defining alert conditions based on external data. Each allows you to compare a `Source` (e.g., close, another indicator's plot) with a `Value` using a logical `Condition` (e.g., Greater than, crossover).
* **Condition 1-12:**
  * **Description:** A set of 12 inputs for building the core alert logic. Each condition can be configured with the following:
    * **Enable Checkbox:** Activates or deactivates the condition.
    * **Condition:** A dropdown menu to select a specific trigger (e.g., "Bullish CHoCH \[Trigger]") or state (e.g., "Market Structure Bullish \[State]") from the indicator.
    * **Boolean (AND/OR):** Chains this condition with others assigned to the same step.
    * **Step:** Assigns the condition to a specific step in the sequence (from 1 to 7). An alert fires only when all configured steps are completed in order.