> For the complete documentation index, see [llms.txt](https://docs.inconnu.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.inconnu.app/advanced/administration/experience-management.md).

# Experience Management

Maintain a log of player-character experience gains and expenditures with the /experience command group.

Experience can be awarded or `deducted` from characters with `/experience award` and `/experience deduct`, respectively. Both commands have the following parameters:

| Parameter   | Description                                              |
| ----------- | -------------------------------------------------------- |
| `player`    | The player who owns the character                        |
| `character` | The character from whom to award/deduct XP               |
| `amount`    | The amount of XP to award/deduct                         |
| `scope`     | Whether to apply the operation to lifetime or current XP |
| `reason`    | An admin-given note about the reason for the change      |

{% hint style="info" %}
Players and admins may view their characters' experience logs with the `/experience log` command.
{% endhint %}

**To remove a log entry**, use the `/experience remove entry` command. This takes a `player`, `character`, and `log_index` parameter. The `log_index` is the log entry number as shown by `/experience log`.

When removing an entry, the confirmation message will give the admin an option to reverse the XP change; i.e. if the entry was an award of 10 lifetime XP, a button will appear that, when clicked, will subtract 10 lifetime XP.

### Bulk experience

If you manage a large server, the `/bulk award xp` command can save a lot of time. This command pops up a modal dialogue with the following required parameters:

| Parameter       | Description                                                  |
| --------------- | ------------------------------------------------------------ |
| Reason          | The reason the XP is being granted. **Example:** "Weekly XP" |
| Experience list | A list of characters and the XP to grant, separated by line. |

The `list` must follow this format:

```
N xp <@User ID> Character name
```

Where `N` is the amount of XP to give that character, `User ID` is the player's Discord ID, and `Character name` is the character's name.

If there are any errors in your input (misspelled character name, invalid user, etc.), then **no** experience will be rewarded. You will instead see a list of lines **Inconnu** understood, followed by a list of error lines.

#### Syntax example:

```
5 xp <@1234567890> Nadea Theron
3 xp <@0987654321> Billy Bill
4 xp <@3485734857> Jimmy Maxwell
```