# Scoring

Scoring is a step interaction in Colibri that allows participants to be scored when answering questions in a self-paced exercise. This helps to reinforce correct behaviour in participants through consequence.

There are three different options when it comes to scoring:

| Scoring option                         | Description                                                                    |
| -------------------------------------- | ------------------------------------------------------------------------------ |
| Set                                    | Set the participant's total score                                              |
| Increment (this is the default option) | Add an amount to the participant's accumulative score over an exercise.        |
| Decrement                              | Subtract an amount from the participant's accumulative score over an exercise. |

## How to

You can configure scoring in the Editor via the `Interactions` tab in a step:

<figure><img src="https://3202416344-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkKsE69Z3PsghYNFs2oFd%2Fuploads%2FDyW8qEf3NevCF62Q27bh%2Fscoring.png?alt=media&#x26;token=c3bc3a80-c943-409d-981f-a458600bef42" alt=""><figcaption></figcaption></figure>

### 1. Set

| Description                      | Use                                                                                                                                                                                                                                               |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Set the participants total score | <p>At the beginning of an exercise or if you want to reset the participant's score. Set the score to 0 (assuming the score should start at 0)</p><p></p><p>You might also want to award a specific value at any time and branch on this later</p> |

<div align="left"><figure><img src="https://3202416344-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkKsE69Z3PsghYNFs2oFd%2Fuploads%2Fhe1YVfL6X87ArQoRB3gU%2Fset%20score1.png?alt=media&#x26;token=5b37d241-1a12-4905-8988-69d65f3685f5" alt=""><figcaption></figcaption></figure></div>

{% hint style="success" %}
If you are using the `Set` option to reset the participant's score, pair it with the `Erase all` action to delete all previous messages and, effectively, reset the exercise.
{% endhint %}

### 2. Increment

{% hint style="warning" %}
This is the default option because it's the most likely scoring option you'll want to use.
{% endhint %}

| Description                                                                                                                   | Use                                                                                                                                          |
| ----------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| <p>Add an amount to the participant's accumulative score over an exercise</p><p></p><p>If set to 0, nothing will be added</p> | When using questions, configure all incorrect answers' scoring value to 0, but the correct answer's scoring value to 1 (or more if you like) |

<div align="left"><figure><img src="https://3202416344-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkKsE69Z3PsghYNFs2oFd%2Fuploads%2FZsp1Hm5IJ7U2bU9K7zJx%2Fincrement.png?alt=media&#x26;token=785637b8-84d4-486a-9415-d492af6a5b49" alt="" width="301"><figcaption></figcaption></figure></div>

### 3. Decrement

<table><thead><tr><th>Description</th><th>Use</th><th data-hidden></th></tr></thead><tbody><tr><td><p>Subtract an amount from the participant's accumulative score over an exercise</p><p></p><p>If set to 0, nothing will be subtracted</p></td><td>If you'd like to take points away from a participant for getting a question wrong</td><td></td></tr></tbody></table>

<div align="left"><figure><img src="https://3202416344-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkKsE69Z3PsghYNFs2oFd%2Fuploads%2FFkJJYMldzTrVVevzIi8P%2Fdecrement%20score1.png?alt=media&#x26;token=37e3cc10-c180-4423-8bb5-72975c12d31f" alt="" width="301"><figcaption></figcaption></figure></div>
