# ⚙️ 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 %}
