Switching characters takes the whole state with it: position, inventory, health, hunger, XP, active effects, and the bank balance if the Money Mod is installed. Built for roleplay servers, where the same player is a police officer on Monday and a mechanic on Tuesday and should not be carrying the same backpack in both jobs.
Character management
Create a character with /createchar <first> <last> <date> <gender>. Each character gets an ID starting at 1. Switch with /char <ID> and you land where that character last stood.
Tab completion works for all commands.
Data saved per character
| Data | Details |
|---|---|
| Position | X/Y/Z coordinates |
| Health | Current health points |
| Hunger | Hunger bar |
| Experience | XP level |
| Inventory | Main + armor + offhand (with NBT) |
| Effects | Active effects with duration and amplifier |
| Money | Account balance (requires Money Mod) |
Money Mod integration
The mod detects the Money Mod on its own. Each character gets a separate balance. New characters start with a configurable amount (default: 500).
Commands
| Command | Usage | Description |
|---|---|---|
/createchar |
<first> <last> <date> <gender> |
Creates a new character slot |
/char |
<ID> |
Switches to the specified character |
/char |
<ID> <player> |
(OP level 2) Switches another player's character |
/editchar |
<ID> |
Shows all properties of a character |
/editchar |
<ID> firstname <value> |
Changes the first name |
/editchar |
<ID> lastname <value> |
Changes the last name |
/editchar |
<ID> birthdate <value> |
Changes the birth date |
/editchar |
<ID> gender <value> |
Changes the gender |
/charinfo |
<player> |
Shows the current character of a player |
/charinfo |
<player> list |
Lists all characters of a player |
/charinfo |
<player> <ID> |
Shows details of a specific character |
Configuration
config/saroscharsystem-common.toml:
| Option | Default | Description |
|---|---|---|
maxChars |
2 |
Maximum characters per player (1 to unlimited) |
requireOpForCommands |
false |
Restrict commands to OP |
Data storage
Character data lives in the world folder:
world/data/chars/<player-uuid>/
├── current-char.json
├── 1.json
├── 2.json
└── ...
Note: This wiki is the documentation. Questions and bug reports are faster on the Discord server.
