# 📜 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
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://paw-studio.gitbook.io/paw-studio-docs/litequest/welcome-to-litequest.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.