OumProfile
Let your players create multiple profiles
1872обновлён 17 сент. 2026 г.
Описание
OumProfile
OumProfile is a multi-profile plugin for Paper servers (1.21+). It allows players to create and switch between different profile slots, each with their own inventory, status attributes, LuckPerms group, and Vault economy balance. This is useful for servers offering distinct loadouts or gameplay modes on a single account.
This plugin is built using the OumLib framework.
Features
Each player profile stores:
- Inventory State: Storage contents, armor contents, off-hand item, and ender chest.
- Attributes: Health, max health, food level, saturation, XP level, and XP progress.
- Status States: GameMode, active potion effects, fall distance, fire ticks, and remaining air bubbles.
- Movement States: Flight capabilities (
allowFlightandisFlyingstate). - Optional Features: Coordinate location (if
save-locationis enabled), Vault balance, LuckPerms group, mcMMO skills, AuraSkills, JobsReborn jobs, custom multi-currencies, playtime tracking, and vanilla Minecraft statistics. - Server Resilience: Non-blocking periodic auto-save to protect against sudden crashes, plus administrative stale profile pruning (
/profile admin prune <days>) to keep database storage compact.
Requirements
- Server: Paper 1.21 or newer
- Java: Java 21 or newer
- Library: OumLib (shaded within the jar)
Soft Dependencies
The plugin automatically integrates with the following if present on the server:
- LuckPerms: For per-profile permission groups.
- Vault & PlayerPoints: For per-profile economy balances.
- mcMMO: For per-profile skill level and experience synchronization.
- AuraSkills: For per-profile skill level and experience synchronization.
- JobsReborn: For per-profile job level and experience progression.
- CombatLogX / PvPManager / DeluxeCombat: Automatic combat tag detection for profile switch blocking.
- PlaceholderAPI & MiniPlaceholders: For displaying profile statistics in chats, scoreboards, and tablists.
Commands & Permissions
Player Commands
| Command | Description | Permission | Default |
|---|---|---|---|
/profile | Opens the profile selection GUI. | profiles.use | True |
/profile list | Lists all created profiles in chat. | profiles.use | True |
/profile current | Displays the active profile name. | profiles.use | True |
/profile create <name> | Creates a new profile with the given name. | profiles.create.<name> | OP |
/profile switch <name> | Switches to the specified profile. | profiles.use | True |
/profile delete <name> | Deletes the specified profile. | profiles.use | True |
/profile rename <old> <new> | Renames a profile. | profiles.use | True |
/profile alerts | Toggles receiving admin profile alerts. | profiles.alerts | OP |
Aliases: /profiles, /prof
Administrative Commands & Permissions
| Command / Permission | Description | Default |
|---|---|---|
/profile admin open <player> | Opens the profile GUI for the specified player. | OP (profiles.admin) |
/profile admin list <player> | Lists all profiles of the specified player. | OP (profiles.admin) |
/profile admin create <player> <profile> | Creates a profile for the specified player. | OP (profiles.admin) |
/profile admin switch <player> <profile> | Forces the specified player to switch to a profile. | OP (profiles.admin) |
/profile admin delete <player> <profile> | Deletes a profile for the specified player. | OP (profiles.admin) |
/profile admin rename <player> <old> <new> | Renames a profile for the specified player. | OP (profiles.admin) |
/profile admin export <player> <profile> | Exports a player's profile to a JSON file. | OP (profiles.admin) |
/profile admin import <player> <file> | Imports a profile from a JSON file for a player. | OP (profiles.admin) |
/profile admin prune <days> | Prunes inactive profiles older than the given days. | OP (profiles.admin) |
/profile debug | Toggles debug logging in console. | OP (profiles.admin) |
/profile reload | Reloads all configuration files. | OP (profiles.admin) |
profiles.admin | Access to administrative commands and config reload. | OP |
profiles.create.* | Permission to create profiles with any name. | OP |
profiles.max.unlimited | Bypasses all profile slot limits. | OP |
profiles.max.<number> | Sets the maximum profile slot limit (e.g. profiles.max.5). | False |
profiles.bypass.combat | Allows switching profiles while tagged in combat. | OP |
profiles.bypass.warmup | Bypasses the switch countdown warmup. | OP |
profiles.bypass.cooldown | Bypasses the switch cooldown. | OP |
profiles.alerts | Receives administrative alerts for profile actions. | OP |
Placeholders
Supported under the oumprofile namespace for PlaceholderAPI and MiniPlaceholders:
| Description | PlaceholderAPI | MiniPlaceholders |
|---|---|---|
| Active profile name | %oumprofile_active% | <oumprofile_active> |
| Total profiles created | %oumprofile_count% | <oumprofile_count> |
| Maximum allowed profiles | %oumprofile_max% | <oumprofile_max> |
| Saved Vault economy balance | %oumprofile_balance% | <oumprofile_balance> |
| Stored primary LuckPerms group | %oumprofile_group% | <oumprofile_group> |
| Profile playtime (seconds) | %oumprofile_playtime% | <oumprofile_playtime> |
| Formatted playtime (duration) | %oumprofile_playtime_formatted% | <oumprofile_playtime_formatted> |
| Stored skill level | %oumprofile_skill_<plugin>_<skill>_level% | <oumprofile_skill_<plugin>_<skill>_level> |
| Stored skill experience | %oumprofile_skill_<plugin>_<skill>_xp% | <oumprofile_skill_<plugin>_<skill>_xp> |
| Stored job level | %oumprofile_job_<job>_level% | <oumprofile_job_<job>_level> |
| Stored job experience | %oumprofile_job_<job>_xp% | <oumprofile_job_<job>_xp> |
| Custom economy balance | %oumprofile_currency_<name>% | <oumprofile_currency_<name>> |
Custom Items & Head Textures
GUI materials support OumLib's item resolution. Custom head textures (head:<base64>) and items from third-party plugins can be used directly:
head:<Base64>oraxen:custom_itemitemsadder:custom_itemnexo:custom_itemmmoitems:TYPE:IDmythicmobs:item_id
Support & Links
- Discord Support Server: https://discord.gg/maDcwPV6KB
- GitHub Repository: https://github.com/sun-mc-dev/oumprofile
Галерея
Последние версии
Все версии →release
OumProfile 1.2.1
1.2.117 сент. 2026 г.38Minecraft: 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.1.1, 26.1.2, 26.2, 26.3paper
Что нового
## Release v1.2.1
Quick patch fixing a couple of placeholder issues in chat messages and menus.
### Fixes
- Fixed the `<to>` placeholder showing up as literal text instead of the profile name in admin switch alerts.
- Added `<from>` and `<target>` placeholder support to switch alert messages for custom formats.
- Fixed `<max>` not parsing properly when players hit their profile limit in the menu.
- Internal cleanup and minor performance improvements.
**Full Changelog**: https://github.com/sun-mc-dev/oumprofile/compare/v1.2.0...v1.2.1
release
OumProfile 1.2.0
1.2.018 авг. 2026 г.11Minecraft: 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.1.1, 26.1.2, 26.2paper
Что нового
### 🚀 What's New in v1.2.0
* 📁 **Modular Multi-File Configuration**: The configuration is now cleanly split into 3 dedicated files supporting live auto-reloading:
* `config.yml` — Core engine settings, database storage, switching mechanics, and integrations.
* `menus.yml` — GUI layouts, slot patterns, custom head textures, and confirmation dialogs.
* `messages.yml` — Complete localization, chat strings, countdown titles, and error notifications.
* 🧹 **Stale Profile Pruning**: Added the `/profile admin prune <days>` command to purge old, unused profiles from database storage while automatically protecting all active online players.
* 💾 **Crash-Protection Auto-Save**: Added configurable periodic background auto-saving (`auto-save.interval-minutes: 5`) to flush live online profiles asynchronously without server lag.
* 🛡️ **Confirmation Dialogs**: Built-in confirmation menus for profile creation and deletion (`confirm-delete` & `confirm-create`).
* 🧼 **Code Deduplication & Cleanup**: Deduplicated skill handler logic, unified profile name validation, and updated to the latest OumLib engine with zero inline imports.
release
OumProfile 1.2-SNAPSHOT
1.2-SNAPSHOT8 июл. 2026 г.24Minecraft: 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.1.1, 26.1.2, 26.2paper
Что нового
feat: add rename, validations, active db tracking, and oumlib utilities
- Added profile rename command and ProfileRenameEvent.
- Implemented name validations (regex & max length).
- Track active profiles directly in DB with V2 migrations.
- Added profile import/export commands and JSON utils.
- Fixed shutdown saving to execute in parallel.
- Replaced custom location, potion, and statistics serializations with OumLib.
- Cleaned up comments and formatted SQL migration files.
release
OumProfile 1.1-RELEASE
1.1-RELEASE20 июн. 2026 г.13Minecraft: 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9folia, paper, purpur, spigot
Что нового
# Update Changelog v1.1
* Added compatibility for popular skill/job plugins (mcMMO, AuraSkills/AurelliumSkills, Jobs).
* The GUI now displays real-time profile updates.
* Optimized GUI rendering performance to prevent lag spikes.
release
OumProfile 1.0-HOTFIX
1.0-HOTFIX19 июн. 2026 г.7Minecraft: 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9paper
Что нового
- Swap Vault balance by difference (delta) instead of full withdraw/deposit to prevent VaultX rate-limit wipes
- Rewrite luckperms api in oumlib
release
OumProfile 1.0-SNAPSHOT
1.0-SNAPSHOT19 июн. 2026 г.8Minecraft: 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9paper
Что нового
# MASSIVE REWRITE
i rewrote this entire plugin with new api and tech, now it supports folia as well.
release
PlayerProfile 1.0.1
1.0.125 янв. 2026 г.65Minecraft: 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9bukkit, paper, purpur, spigot
Что нового
Minor improvements to codebase and Public API release.
release
PlayerProfile 1.0.0
1.0.018 янв. 2026 г.21Minecraft: 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9paper, spigot
Что нового
This is first upload!!