# Community Goals

Community Goals provide an engaging way for your players to collectively support your project. When customers purchase qualifying packages, their contributions count toward a defined monetary target. Once the goal is met, you can trigger automatic actions such as server-wide events, global rewards, or even launch a store-wide sale.

***

#### What Can Community Goals Do?

* Unlock **server-wide rewards** (e.g., global XP boosts, loot drops)
* Automatically **activate a sale** on your store
* Encourage **collective progress and engagement**
* Display real-time **progress via sidebar modules**

> ❗ Manual payments do **not** count towards Community Goals and this behavior cannot be changed.

***

### How to Set Up a Community Goal

1. **Go to**: `Engagement > Community Goals`
2. **Click**: `Create Community Goal`
3. **Configure the fields:**

| Field                            | Description                                                                                             |
| -------------------------------- | ------------------------------------------------------------------------------------------------------- |
| **Name**                         | Internal name; not visible to customers.                                                                |
| **Description**                  | Explain the goal, target amount, and the reward players can expect.                                     |
| **Image**                        | Upload an image to visually represent the goal on your store.                                           |
| **Target**                       | Set the monetary target (e.g., $50) that triggers the reward.                                           |
| **Activate Sale on Goal**        | (Optional) Select a sale to activate once the goal is met. This will be available to all customers.     |
| **Community Goal is Repeatable** | Enable this if you want the goal to reset after completion for ongoing contributions.                   |
| **Packages**                     | Select one or more packages that will contribute to the goal when purchased.                            |
| **Commands**                     | Enter any global server commands to execute when the goal is reached (e.g., give all players a reward). |

***

### Displaying Community Goal Progress on Your Store

By default, community goals run in the background. To publicly display the goal and encourage contributions:

1. **Go to**: **Webstore > Sidebar**
2. **Click**: **Add Module to Sidebar**
3. **Select**: **Community Goal,** then click **Create**
4. **Configure display options:**

| Field                   | Description                                                                                                     |
| ----------------------- | --------------------------------------------------------------------------------------------------------------- |
| **Header**              | Title displayed above the module (visible to users).                                                            |
| **Community Goal**      | Select the goal to link with this module.                                                                       |
| **Bar Style**           | Choose between a solid or striped progress bar.                                                                 |
| **Animate Goal Bar**    | Enable animated effects on the progress bar.                                                                    |
| **Display Goal Amount** | Show the actual currency target (e.g., $50) instead of just a percentage.                                       |
| **Start/End Time**      | (Optional) Set a visibility window for the module on your store. This does not affect the goal's functionality. |

***

### Academy Guide

{% embed url="<https://www.youtube.com/watch?v=Vh9n7kYO6Mg>" %}


---

# 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://docs.tebex.io/creators/tebex-control-panel/engagement/community-goals.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.