> For the complete documentation index, see [llms.txt](https://paw-studio.gitbook.io/paw-studio-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://paw-studio.gitbook.io/paw-studio-docs/litequest/welcome-to-litequest.md).

# 📜 Welcome to LiteQuest

**LiteQuest** is a lightweight and flexible Minecraft plugin for creating and managing quests.\
It is designed to work efficiently on any Paper-based server and offers both solo and group questing experiences.

***

## 📌 Key Features

* **Quest-based configuration**\
  Each quest is stored as a separate configuration file (`1 config = 1 quest`).\
  All quest files are located in:

  ```
  plugins/LiteQuest/quests
  ```
* **Solo or Group Play**\
  Quests can be assigned to one or multiple players, allowing cooperative progression.
* **Optimized Data Loading**\
  Quest sessions and player data are loaded only when needed, ensuring high performance.
* **Quest Sessions**\
  When a quest is assigned, a dedicated **session** is created:

  ```
  plugins/LiteQuest/sessions
  ```

  Each session stores live quest progress and participant information.
* **Player Data Management**\
  Player profiles are stored in:

  ```
  plugins/LiteQuest/players
  ```

  Upon login, the plugin automatically loads the player’s profile along with all active quest sessions.
* **Progress Tracking**\
  Players can view their active quests via:

  ```
  /lquest menu
  ```

  The menu displays all active quests and the completion percentage for each participant.
* **Reward System**
  * Online players receive rewards immediately upon quest completion.
  * Offline players have their rewards stored in their profile until their next login.

## 📂 Data Structure Overview

```
plugins/
  LiteQuest/
    quests/       <- Static quest configurations
    sessions/     <- Active quest session data
    players/      <- Player profiles
```