Built for roleplay servers — lets each player account hold multiple distinct characters. Switching characters saves and restores everything: position, inventory, health, hunger, XP, effects, and money (if the Money Mod is installed).
Character Management
Create a character with /createchar <first> <last> <date> <gender>. Each character gets an ID starting at 1. Switch with /char <ID> — the game teleports you to 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
Automatically detects if the Money Mod is present. 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 – ∞) |
requireOpForCommands |
false |
Restrict commands to OP |
Data Storage
Character data is stored in the world folder:
world/data/chars/<player-uuid>/
├── current-char.json
├── 1.json
├── 2.json
└── ...
Note: This wiki serves as documentation. For active discussion, please join the Discord Server.
