# ⚙️ Configuration

The `config.yml` acts as the brain of **VortexSellChests**. Below is a detailed breakdown of the core settings and how they impact your server's performance and gameplay.

***

#### 📝 Main Settings

| Key                    | Default    | Description                                                                                      |
| ---------------------- | ---------- | ------------------------------------------------------------------------------------------------ |
| `Invalid Chest Action` | `WARN`     | Defines what happens if a chest in the DB is missing from the config (`SKIP`, `WARN`, `REMOVE`). |
| `Debug`                | `false`    | Enables verbose logging in the console for troubleshooting.                                      |
| `Currency Symbol`      | `$`        | The symbol displayed next to money values in holograms and GUIs.                                 |
| `Number Format`        | `#,###.##` | Standard Java DecimalFormat for prices and counts.                                               |

***

#### 💎 Instant Collection

Control how items are "vacuumed" into collectors or sell chests.

* **`Enabled`**: Global toggle for the feature.
* **`Force Enabled`**: If true, ignores individual chest settings and forces vacuuming for all.
* **`Default State`**: The initial state for a newly placed chest.

***

#### 📊 Hologram Placeholders

You can customize the update frequency of specific hologram lines to save performance. Intervals are in **Ticks** (20 ticks = 1 second).

| Placeholder   | Description                       | Suggested Interval |
| ------------- | --------------------------------- | ------------------ |
| `<owner>`     | Name of the chest owner.          | 0 (Static)         |
| `<money>`     | Current pending earnings.         | 20 (1s)            |
| `<fuel>`      | Remaining fuel time.              | 20 (1s)            |
| `<sold>`      | Items sold since last collection. | 20 (1s)            |
| `<collected>` | Total items stored in collector.  | 20 (1s)            |

***

### ⚠️ Crucial Notes

{% hint style="warning" %}
**Internal Cooldowns:** Sell timers are processed asynchronously. Reducing `Sell Time` below 5 seconds for dozens of chests simultaneously may impact database performance if using H2. Use MySQL for high-volume servers.
{% endhint %}

{% hint style="warning" %}
**Hologram Frequency:** Setting all update intervals to `1` will cause significant client-side FPS lag due to constant packet updates. Keep them at `20` or higher for dynamic values.
{% endhint %}

***

{% hint style="success" %}
**Setup Complete:** After modifying the configuration, use `/vsc reload` to apply changes safely.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.vortexdevelopment.net/projects/vortexsellchests/configuration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.