# Arceus Tasks

Arceus Tasks brings the Pokemon Legends: Arceus Research Task system into Cobblemon.

Just like in the games, players work through per-species research tasks, earn research points as they hit task thresholds, unlock Galaxy-style ranks (via these points) with configurable rewards. ArceusTasks also supports per-species rewards.

### ArceusTasks is the best way to add hundreds of hours of content with no work on your end.

The key reason ArceusTasks is great is that **it is drag and drop, no configuration required** - the Hisuian Dex with Research Tasks from the game is included, which is minimum 20 hours of content for each player on your server.

{% hint style="info" %}
**Not familiar with Research Tasks from Legends: Arceus?**

You can read this great guide from Bulbapedia [HERE](https://bulbapedia.bulbagarden.net/wiki/Research_task_\(Legends:_Arceus\)).
{% endhint %}

## What It Includes

* Per-species research task tracking
* Research levels and research points
* Bonus tasks worth double progress
* Galaxy rank progression with claimable rewards
* Optional per-species rewards
* Editable JSON data for the dex, ranks, messages, and GUIs
* A completion-based shiny modifier (from the game)

## Basic Concepts

### Species Research

Each species entry has its own research tasks and goal thresholds. Progress is updated from gameplay events such as catching, defeating, evolving, feeding, or seeing specific moves used.

<figure><img src="https://2695970514-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMWVMZEKaZjgM2DFfh7w%2Fuploads%2FGn0xvqfUV5DLBz1U7VQ1%2Fimage.png?alt=media&#x26;token=a6544dc8-f74c-413b-a9a0-2fd6c83943ce" alt=""><figcaption></figcaption></figure>

See [pokedex](https://docs.roanoke.dev/mods/mods/arceus-tasks/pokedex "mention")for more info.

### Research Levels & Points

Each completed goal threshold grants research progress. Standard goals grant `10` research points and `1` research level. Bonus goals grant `20` research points and `2` research levels. Displayed research level caps at `10`, and reaching level `10` grants an extra `100` research points for that species.

<figure><img src="https://2695970514-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMWVMZEKaZjgM2DFfh7w%2Fuploads%2FJ17UgDYC6vK6tiGWopv6%2Fimage.png?alt=media&#x26;token=567b95e4-a008-4001-9e69-620c42c0638e" alt=""><figcaption></figcaption></figure>

### Completion Rules

The mod can treat a species as complete in one of two ways, depending on `config/ArceusTasks/config.json`:

* reaching research level `10`
* finishing every goal on every task

That completion state is used for species reward claiming and the research-based shiny modifier. In the Legends: Arceus game, players only need to reach level 10 per-species to get the shiny modifier - that's a bit too easy, so the default behaviour in ArceusTasks is they must complete all tasks & goals.&#x20;

This applies to both the shiny modifier & the per-species rewards.&#x20;

### Galaxy Ranks

Research points also feed into a separate rank ladder. Players do not auto-claim ranks; they claim them from the rank GUI once they have enough total points (notified in chat, with hotlink to GUI). You can define rewards for each rank, as well as edit the display item used in GUIs.&#x20;

Of course, you can also edit the points threshold for each rank to make progression harder or easier. ArceusTasks ships with the same points thresholds as the Legends: Arceus game - and some placeholder rewards, you should configure your own.&#x20;

<figure><img src="https://2695970514-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMWVMZEKaZjgM2DFfh7w%2Fuploads%2FwGXjh1hbYzeIITuF7No6%2Fimage.png?alt=media&#x26;token=7acc1957-f784-4c06-9a16-2e88687feae5" alt=""><figcaption></figcaption></figure>

See [ranks](https://docs.roanoke.dev/mods/mods/arceus-tasks/ranks "mention")for more.

## Default Content

* `242` bundled species (Hisuian Pokedex)
* `9` types of research tasks (with subtypes)
* `11` shipped Galaxy ranks (identical to Legends: Arceus)

The only thing you should configure before using the mod is rewards for Galaxy Ranks, if you want to use the rank system. Each server's economy is so different, so no defaults are provided.

## Configuration Files

On startup, the mod writes config files to `config/ArceusTasks`:

* `config.json`
* `pokedex.json`
* `ranks.json`
* `messages.json`
* `gender_forms.txt`
* `GUI/...`
* `PlayerState/<player-uuid>.json`

## Quick Start

1. Start the server once so `config/ArceusTasks` is generated.
2. Edit `pokedex.json`, `ranks.json`, `messages.json`, and any GUI JSON you want to customize.
3. Run `/arceustasks reload`.
4. Open `/arceustasks` and `/arceustasks ranks` to check the player-facing flow.