# Badges

## Description

Badges in r4nkt are given to a player when an achievement has been earned.  That is to say, when an achievement's criteria have been met, then a badge is awarded.

## Properties

Badges have the following properties:

| Name                    |   Type  | Default |
| ----------------------- | :-----: | :-----: |
| custom\_achievement\_id |  string |    -    |
| custom\_player\_id      |  string |    -    |
| points                  | integer |    -    |
| custom\_session\_id     |  string |    -    |

### Achievement

A badge is given to a player to show that they have met the criteria for a given [achievement](https://docs.r4nkt.com/concepts/achievements). It is represented by the badge's `custom_achievement_id` property, which corresponds to the achievement's `custom_id`.

### Player

The [player](https://docs.r4nkt.com/concepts/players) that has earned the badge is represented by the badge's `custom_player_id` property, which is the player's `custom_id`.

### Custom Session ID

If a badge was earned within the context of a session, then that custom session ID will be provided.