Overview
Saro's Char System transforms your Minecraft server into a deep roleplay experience. It allows players to create and switch between multiple "Characters" on a single account. Each character has their own separate inventory, health, hunger, location, and potion effects.
Key Features
👤 Character Management
- Create Characters: Define a first name, last name, birth date, and gender for each persona.
- Seamless Switching: Swap between characters instantly with tab-complete support.
- Edit Characters: Modify character properties at any time.
- Character Info: View detailed information about other players' characters.
💾 Data Saved Per Character
When switching, the following data is saved and loaded separately for each character:
| Data | Description |
|---|---|
| Position | X/Y/Z coordinates - you're teleported when switching |
| Health | Current health points |
| Hunger | Hunger bar |
| Experience | XP level |
| Inventory | Main inventory + armor + offhand (including NBT data) |
| Effects | Active potion/status effects with duration and amplifier |
| Money | Account balance (with Money Mod integration) |
💰 Money Mod Compatibility
- Auto-Detection: Automatically checks if a Money Mod is installed.
- Separate Balances: Each character has their own money account.
- Starting Money: New characters automatically receive configured starting money (Default: 500).
🛠️ Admin Features
- Switch Character for Others: Admins (OP Level 2+) can use
/char <ID> <playername>. - View Character List: Shows all characters of a player with
/charinfo <player> list.
Commands
| Command | Usage | Description |
|---|---|---|
| /createchar | /createchar <first> <last> <date> <gender> |
Creates a new character slot. |
| /char | /char <ID> |
Switches to the specified character ID. |
| /char | /char <ID> <player> |
(Admin) Switches another player's character. |
| /editchar | /editchar <ID> |
Shows all properties of a character. |
| /editchar | /editchar <ID> firstname <value> |
Changes the first name. |
| /editchar | /editchar <ID> lastname <value> |
Changes the last name. |
| /editchar | /editchar <ID> birthdate <value> |
Changes the birth date. |
| /editchar | /editchar <ID> gender <value> |
Changes the gender. |
| /charinfo | /charinfo <player> |
Shows the current character of a player. |
| /charinfo | /charinfo <player> list |
Lists all characters of a player. |
| /charinfo | /charinfo <player> <ID> |
Shows details of a specific character. |
Configuration
All settings in config/saroscharsystem-common.toml:
| Option | Default | Description |
|---|---|---|
maxChars |
2 |
Maximum number of characters per player (1 - ∞) |
requireOpForCommands |
false |
Whether commands require OP permissions |
Data Storage
Character data is stored in the world folder:
world/data/chars/<player-uuid>/
├── current-char.json # Current character ID
├── 1.json # Character 1 data
├── 2.json # Character 2 data
└── ...
JSON Structure of a Character
{
"id": 1,
"first_name": "John",
"last_name": "Smith",
"birth_date": "01.01.2000",
"gender": "male",
"x": 100.5,
"y": 64.0,
"z": -200.3,
"health": 20.0,
"hunger": 20,
"experience": 30,
"money": 1500.0,
"effects": [...],
"inventory": [...]
}
Note: This wiki serves as documentation. For active discussion, please join the Discord Server.
