# ⚔️ Commands

The **nwMVP** plugin provides a powerful and comprehensive command system designed to manage every core feature of the plugin, including:

* Boss Damage & Score Tracking
* Daily Boss System
* Season Rankings & Rewards
* Territory Control System
* Regen Zone Management
* Administrative & Debug Tools

All commands are permission-based, highly structured, and deeply integrated with GUI, database storage, and scheduling systems.

***

### 📌 Command Overview

#### Base Command

```
/nwmvp
```

#### Permission System

| Permission     | Description             | Default |
| -------------- | ----------------------- | ------- |
| `nwmvp.player` | Player-level commands   | true    |
| `nwmvp.admin`  | Administrative commands | op      |
| `nwmvp.reload` | Reload configurations   | op      |

#### Command Structure

```
/nwmvp <subcommand> [arguments]
```

***

## 🎮 Player Commands

Player commands are available to all players with `nwmvp.player` permission.

***

### 🧮 `/nwmvp score <boss>`

#### Description

Opens a GUI displaying **damage statistics and rankings** for a specific boss.

#### Permission

```
nwmvp.player
```

#### Usage

```
/nwmvp score <boss>
```

#### Arguments

| Argument | Description                                   |
| -------- | --------------------------------------------- |
| `<boss>` | Boss ID (must match a file inside `/bosses/`) |

#### How It Works

* Opens an interactive **Score GUI**
* Displays:
  * 🏆 Top damage dealers
  * 📊 Damage percentages
  * ⚡ First Strike player
  * ☠ Final Blow player
  * 👤 Personal damage dealt
* Boss ID must exist in `/plugins/nwMVP/bosses/`
* GUI layout is fully configurable
* Works with MythicMobs and EliteMobs bosses

#### Example

```
/nwmvp score SkeletalMinion
```

***

### 📆 `/nwmvp daily stats [player]`

#### Description

Displays **Daily Boss statistics** for yourself or another player.

#### Permission

* Self view: `nwmvp.player`
* Other players: `nwmvp.admin`

#### Usage

```
/nwmvp daily stats
/nwmvp daily stats PlayerName
```

#### Information Displayed

* Daily attempts used / max attempts
* Total damage dealt
* Total damage taken
* Total healing
* First Strike count
* Final Blow count
* Top rank appearances
* Death count

#### Reset Behavior

* Resets automatically based on `daily-boss.reset-time`
* Admins can manually reset via admin commands

***

### 🏅 `/nwmvp season stats [player]`

#### Description

Displays **Season ranking statistics** for a player.

#### Permission

* Self view: `nwmvp.player`
* Other players: `nwmvp.admin`

#### Usage

```
/nwmvp season stats
/nwmvp season stats PlayerName
```

#### Information Displayed

* Season points
* Tier & rank
* Boss kill count
* Participation count
* First Strike / Final Blow
* Best & worst rank
* Active days

> ⚠ Requires Season System to be enabled.

***

### 🎁 `/nwmvp season reward`

#### Description

Claims **Season rewards** after the season has ended.

#### Permission

```
nwmvp.player
```

#### Usage

```
/nwmvp season reward
```

#### Conditions

* Season status must be `ENDED`
* Player must have season data
* Rewards must not be already claimed

Rewards are defined in:

```
season.rewards.lists
```

***

## 🏰 Territory Commands

***

### 🛠 `/nwmvp territory maintenance`

#### Description

Pays the **maintenance cost** for a captured territory.

#### Permission

* `nwmvp.player`
* Must be **Guild Leader**

#### Usage

```
/nwmvp territory maintenance
```

#### Requirements

* Player is inside the territory region
* Player is guild leader
* Guild owns the territory
* Maintenance is enabled
* Maintenance has not been paid yet

#### Supported Economies

* Vault
* PlayerPoints
* CoinsEngine
* BeastTokens

***

### ⚙️ `/nwmvp territory gui`

#### Description

Opens the **Territory Owner Settings GUI**.

#### Permission

* `nwmvp.player`
* Guild leader only

#### Usage

```
/nwmvp territory gui
```

#### GUI Features

* Territory buffs & effects
* Cost settings
* Utilities & restrictions
* Owner-specific settings

***

### 📊 `/nwmvp territory stats`

#### Description

Displays **territory statistics** for your guild.

#### Permission

```
nwmvp.player
```

#### Information Displayed

* Territory capture history
* Performance data
* Ownership statistics

***

## 🔧 Admin Commands

> All admin commands require `nwmvp.admin`

***

### 🔄 `/nwmvp admin reload`

Reloads all nwMVP configuration files.

```
/nwmvp admin reload
```

#### Reloads

* `config.yml`
* `messages.yml`
* Boss configs
* Territory configs
* GUI files
* Drop tables
* `regenzone.yml`

***

### ⏱ `/nwmvp admin schedules <daily|season|territory|all> reload`

Reloads schedule systems without restarting the server.

```
/nwmvp admin schedules daily reload
/nwmvp admin schedules season reload
/nwmvp admin schedules territory reload
/nwmvp admin schedules all reload
```

***

### 🔁 Daily Boss Admin Commands

#### Reset a Specific Player

```
/nwmvp admin daily reset PlayerName
```

#### Reset All Players

```
/nwmvp admin daily start
/nwmvp admin daily end
```

***

### 🏁 Season Admin Commands

#### Start a Season

```
/nwmvp admin season start
```

#### End a Season

```
/nwmvp admin season end
```

#### Check Season Status

```
/nwmvp admin season check
```

#### Reset Player Season Data

```
/nwmvp admin season reset PlayerName
```

***

## 🌱 Regen Zone Commands

> Requires:

```
regen-block-plugin: "nwmvp"
```

***

### 🪄 `/nwmvp admin territory regenzone wand`

Gives a wand for selecting regen zone boundaries.

***

### ➕ Create Regen Zone

```
/nwmvp admin territory regenzone create <zoneName>
```

***

### ❌ Delete Regen Zone

```
/nwmvp admin territory regenzone delete <zoneName>
```

***

### 📃 List Regen Zones

```
/nwmvp admin territory regenzone list [page]
```

***

### 🔁 Enable / Disable Regen Zone

```
/nwmvp admin territory regenzone setting <zoneName> <true|false>
```

***

## 📚 Permission Summary

| Command Group   | Permission     |
| --------------- | -------------- |
| Player Commands | `nwmvp.player` |
| Admin Commands  | `nwmvp.admin`  |
| Reload          | `nwmvp.reload` |