# 🛠️ Configuration

The **nwMVP configuration** allows you to control how boss tracking, rankings, seasons, daily limits, and territory systems behave across your server.\
Each section focuses on a specific system, making it easy to customize

Below is a quick and simple overview of all main configuration sections.

***

### 🔌 Plugin Integration

Controls which external plugins nwMVP should work with.

You can choose:

* Boss plugins (MythicMobs / EliteMobs)
* Party systems
* Guild systems
* Hologram plugins
* Block regeneration plugins

> 💡 Only enable plugins that are installed on your server.\
> nwMVP will automatically adapt if some plugins are not present.

***

### ⚙️ General Settings

Controls the core behavior of nwMVP.

Includes:

* Price and number formatting
* Permission nodes for commands
* Event behavior (such as clearing data when players change worlds)

Use this section to align nwMVP with your server rules and permission structure.

***

### 💾 Database Settings

Controls how player and boss data is stored.

Supported databases:

* **SQLite** – Simple, file-based (recommended for small–medium servers)
* **MySQL** – Network-based (recommended for large or multi-server setups)

> 💡 You can switch databases without changing other systems.

***

### 📅 Daily Boss System

Controls how many times players can fight bosses per day.

Features:

* Limit boss attempts per day
* Automatic reset based on time and timezone
* Bonus attempts based on:
  * Permissions
  * Placeholder values (e.g. player level)
  * Day of the week

This system helps control boss farming and player progression.

***

### 🌟 Season Ranking System

Controls long-term competition and progression.

You can configure:

* Season start and end dates
* Season point calculation formulas
* Bosses that count toward season points
* Tier system (Unranked → Platinum)
* Event boosts (time-based multipliers)
* Season rewards and announcements

> 💡 Designed for competitive servers that want long-term goals.

***

#### 💬 **Messages Configuration**

All messages used across the plugin can be fully customized here.\
Supports RGB, Standard, MiniMessage, and Legacy Hex color formats.

***

### 🏆 MVP Points System

Controls how MVP points are calculated during boss fights.

Supports:

* Fixed points (First Strike, Final Blow, Top Damage, etc.)
* Scaling points based on performance
* Ranking-based bonus points
* Penalties for deaths or daily attempt usage

This system allows ranking based on **performance**, not just raw damage.

***

### 🗺️ Territory System

Controls territory capture and management for guilds.

Includes:

* Territory limits per guild
* Entry restrictions
* Territory event messages
* Integration with block regeneration systems

> 📁 Detailed territory settings are managed in separate files inside the `/territory/` folder.

***

### 🎨 **Message Format Examples**

MiniMessage, RGB, and legacy color formats

***

The `config.yml` file is the **central control panel** of nwMVP.

With this configuration, you can:

* Enable or disable integrations based on your server setup
* Choose how data is stored (SQLite or MySQL)
* Control daily boss limits and bonuses
* Define competitive season rules and rewards
* Customize MVP point calculations
* Manage territory behavior and restrictions

Every section is independent, flexible, and designed to scale with your server.

> 💡 nwMVP is built to be **config-driven**, allowing you to shape the entire boss and competition experience without modifying code.