> For the complete documentation index, see [llms.txt](https://changelog.matrixemulator.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://changelog.matrixemulator.com/welcome/server/muserver/data/custom/customrankuser.md).

# CustomRankUser

<mark style="color:green;">Registers the "ranks" (titles) for the player ranking by reset range (or master reset, or level+master level, depending on the server configuration), with a currency prize upon reaching each range for the first time. Maximum of 50 lines, all inside block</mark> <mark style="color:green;"></mark><mark style="color:green;">`0`</mark><mark style="color:green;">.</mark>

```
0
//#RI	#RN			#MNR	#MXR	#C1	#C2	#C3
0	"Soldier"		0	9	0	0	5
1	"Recruit"		10	19	0	0	10
...
19	"Supreme"		190	-1	100	100	100
end
```

| **Column**   | **Accepted values**              | **What it is**                                                                                                                          |
| ------------ | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| RI           | Number, in sequence (0, 1, 2...) | Position of the rank in the list (also the order in which the ranking progresses).                                                      |
| RN           | Text in quotation marks          | Name of the rank displayed to the player.                                                                                               |
| MNR          | Number                           | Minimum value of the range (resets, master resets, or level+master level — depends on the server's `CustomRankUserType` configuration). |
| MXR          | Number, or `-1`                  | Maximum value of the range. `-1` = no maximum limit (mandatory for the last rank in the list).                                          |
| C1 / C2 / C3 | Number                           | WCoinC / WCoinP / Goblin Points given to the player the first time they enter this range.                                               |

### <mark style="color:yellow;">Notes</mark>

* The reward (`C1`/`C2`/`C3`) is only given once, exactly when the player's value matches the `MNR` of this range (e.g., upon completing reset 10, if a line has `MNR 10`) — it is not given again if the player has already passed this range.
* The last range in the list must have `MXR = -1`, otherwise players above the highest registered value will be left without a rank.
* What exactly `MNR`/`MXR` compare (resets, master resets, or level+master level combined) depends on a general server setting (`CustomRankUserType`) — it is not fixed in this file.
