> For the complete documentation index, see [llms.txt](https://docs.cozycrafters.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cozycrafters.net/plugin-docs/cozygoals.md).

# CozyGoals

### What It Does

CozyGoalsPlugin provides server goals, personal player goals, global goals, and a public task board.

Players use it to view goals, track progress, claim rewards, view global server milestones, and create or complete public tasks.

### Main Features

<table><thead><tr><th width="262.296875">Feature</th><th>Description</th></tr></thead><tbody><tr><td>Goal menu</td><td><code>/goals</code> opens the main goals menu.</td></tr><tr><td>Goal categories</td><td>Bundled categories include Mining, Farming, Fishing, Combat, Exploration, Community, Voting, Daily Tasks, Weekly Tasks, and Mastery.</td></tr><tr><td>Progress tracking</td><td>Goals can track confirmed actions such as block breaking, block placing, mob kills, fishing, farming, crafting, smelting, item pickup, playtime, voting, portals, commands, and AuraSkills levels.</td></tr><tr><td>Daily and weekly task boards</td><td>Daily and weekly goals are selected from configured pools. The default active count is 5 daily goals and 5 weekly goals.</td></tr><tr><td>Rewards</td><td>Goal rewards can include money, PlayerPoints points, AuraSkills XP, items, and server commands.</td></tr><tr><td>Board bonuses</td><td>The default config includes daily and weekly board bonuses after active board tasks are completed.</td></tr><tr><td>Global goals</td><td><code>/goals global</code> opens cooperative server-wide goals. Global goals can rotate, track shared progress, and run global, contributor, and top-contributor reward commands.</td></tr><tr><td>Public task board</td><td><code>/tasks</code> opens a task hub where players can browse, create, accept, complete, approve, deny, cancel, and claim stored task items.</td></tr><tr><td>Menus</td><td>The source includes menu files for the main goals menu, category pages, profile view, leaderboard, task board, and global goals.</td></tr><tr><td>Oraxen display items</td><td>GUI display items can use Bukkit materials or Oraxen IDs with fallback materials.</td></tr></tbody></table>

### Basic Admin Workflow

1. Review `config.yml`, `menus.yml`, `categories.yml`, quest files in `quests/`, and `global-goals.yml`.
2. Assign player access with `cozygoals.use`. This is granted by default.
3. Assign `cozygoals.global.view` if players should use `/goals global`. This is granted by default.
4. Give trusted admins `cozygoals.admin`, or assign narrower admin permissions from `permissions.md`.
5. Use `/cozygoals reload` after config changes.
6. Use `/cozygoals debug` to check loaded goals, categories, hooks, active daily and weekly goals, and reward integrations.
7. Use `/cozygoals active` and `/cozygoals reroll <daily|weekly> confirm` to inspect or manually reroll active daily and weekly boards.
8. Use `/cozygoals global ...` commands to inspect or manage global goals.

### Notes

* The plugin name in `plugin.yml` is `CozyGoals`.
* The registered commands are `/goals`, `/tasks`, and `/cozygoals`.
* `/tasks` also has the aliases `/task`, `/jobs`, and `/job`.
* No `/goal` command is registered in `plugin.yml`.
* The confirmed soft dependencies are Vault, PlayerPoints, AuraSkills, VotingPlugin, and Oraxen.
* Global goal definitions live in `global-goals.yml`, not `config.yml`.
* Runtime progress and rotation state are stored separately from the goal config files.
* PlaceholderAPI is not listed as a dependency in `plugin.yml`.
* Public task creation has configurable limits for money amounts, point amounts, item amounts, required rewards, minimum money rewards, and maximum open tasks per creator.

### Common Use Cases

| Use Case                                   | Command or Area                                             |
| ------------------------------------------ | ----------------------------------------------------------- |
| Player opens goals                         | `/goals`                                                    |
| Player views profile or stats              | `/goals profile` or `/goals stats`                          |
| Player opens global goals                  | `/goals global`                                             |
| Player opens public tasks                  | `/tasks`                                                    |
| Player creates a public task               | `/tasks create`                                             |
| Admin reloads config                       | `/cozygoals reload`                                         |
| Admin checks loaded goals and integrations | `/cozygoals debug`                                          |
| Admin resets a player's goal progress      | `/cozygoals reset <player>`                                 |
| Admin resets all player progress           | `/cozygoals reset all` twice within the confirmation window |
| Admin manages global goals                 | `/cozygoals global ...`                                     |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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.cozycrafters.net/plugin-docs/cozygoals.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.