# SmartQuests - TabScore

{% embed url="<https://youtu.be/xf8TCGh_qAk>" %}

## Description

#### 📘 SmartQuests Tablist — Addon for SmartQuests

**SmartQuests Tablist** is an addon for the **SmartQuests** plugin (version ≥ 1.1.9) that adds a dynamic **scoreboard** and **tablist** to display players' active quests.

🔹 **Main Features**:

* Real-time display of **active quests** in the scoreboard and/or tablist.
* If multiple quests are active, they will **rotate automatically**.
* If no quests are active:
  * the **scoreboard** will automatically hide
  * the **tablist** will show an empty quest section

🔧 **Customization**:

* The **tablist is fully customizable**, including support for **placeholders**.
* The **scoreboard** has some layout limitations but still displays essential quest info.

⚙️ **Settings**:

* You can **enable or disable** the scoreboard and tablist separately via the config file.
* Players can **disable their own scoreboard** with a dedicated command.

💡 Perfect for servers that want a clean, customizable way to show quest progress!

🕒 **Full Timing Control**:\
You can customize:

* the **update interval** of both scoreboard and tablist
* the **delay between quests** when rotating through multiple active ones

***

## Commands

| Command          | Description                                                             |
| ---------------- | ----------------------------------------------------------------------- |
| /qscore toggle   | Each player will have the ability to deactivate/activate the scoreboard |
| /tabscore reload | Reload configuration                                                    |

***

## Permissions

| Permission                    | Description                                                          |
| ----------------------------- | -------------------------------------------------------------------- |
| smartquests.scoreboard.toggle | <p>Enables the player to use the command<br>/qscore toggle</p>       |
| smartquests.scoreboard.set    | Enable or disable the scoreboard for a specific player (Only for OP) |
| smartquests.scoreboard.use    | Enables the player to view the scoreboard                            |
| smartquests.tablist.use       | Enables the player to view the tablist                               |
| smartquests.tabscore.reload   | Enable to reload the configuration                                   |

***

## Configuration

<details>

<summary>config.yml</summary>

```yaml
scoreboard:
  enabled: true
  update-interval: 1 #seconds
  time-next-mission: 5 #seconds
  page: true
  page-text: "&f{page}&7/&7{total}"
  title: "&6&l✦ Smart Quests ✦ "

tab-list:
  enabled: true
  update-interval: 1 #seconds
  time-next-mission: 5 #seconds
  page: true
  page-text: "&f{page}&7/&7{total}"
  prefix: " &e> "
  suffix: " &e< "
  no-active-quest: "&7No active missions."
  header:
    - "&a&l✦ SMART QUESTS ✦"
    - ""
    - "&7Welcome &a%player_name%&7!"
    - "&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
  footer:
    - "&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
    - "&aActive Missions: &f%SmartQuests_player.active%"
    - "&aMissions Completed: &f%SmartQuests_player.complete%"
    - "&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
    - "&6&lCURRENT MISSIONS:"
    - ""
    - "{SmartQuests}" #It is replaced by the active mission
    - "&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
    - "&7Online: &a%server_online%"

# To use %player_name%, %server_online%
# Download PlaceholderAPI add-on packages, with the following commands:
# /papi ecloud download Server   /papi ecloud download Player

message:
  no-permission: "&cYou don't have permission to use this command."
  scoreboard-on: "&aScoreboard enabled"
  scoreboard-off: "&cScoreboard disabled"
  scoreboard-on-player: "&aScoreboard enabled for %player%"
  scoreboard-off-player: "&cScoreboard disabled for %player%"
  player-not-found: "&cPlayer not found"
  reload: "&aConfiguration reloaded!"
```

</details>
