# 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>" %}