# 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](https://github.com/sun-mc-dev/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 (`allowFlight` and `isFlying` state). * **Optional Features**: Coordinate location (if `save-location` is 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 `) 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 ` | Creates a new profile with the given name. | `profiles.create.` | OP | | `/profile switch ` | Switches to the specified profile. | `profiles.use` | True | | `/profile delete ` | Deletes the specified profile. | `profiles.use` | True | | `/profile rename ` | 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 ` | Opens the profile GUI for the specified player. | OP (`profiles.admin`) | | `/profile admin list ` | Lists all profiles of the specified player. | OP (`profiles.admin`) | | `/profile admin create ` | Creates a profile for the specified player. | OP (`profiles.admin`) | | `/profile admin switch ` | Forces the specified player to switch to a profile. | OP (`profiles.admin`) | | `/profile admin delete ` | Deletes a profile for the specified player. | OP (`profiles.admin`) | | `/profile admin rename ` | Renames a profile for the specified player. | OP (`profiles.admin`) | | `/profile admin export ` | Exports a player's profile to a JSON file. | OP (`profiles.admin`) | | `/profile admin import ` | Imports a profile from a JSON file for a player. | OP (`profiles.admin`) | | `/profile admin prune ` | 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.` | 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%` | `` | | Total profiles created | `%oumprofile_count%` | `` | | Maximum allowed profiles | `%oumprofile_max%` | `` | | Saved Vault economy balance | `%oumprofile_balance%` | `` | | Stored primary LuckPerms group | `%oumprofile_group%` | `` | | Profile playtime (seconds) | `%oumprofile_playtime%` | `` | | Formatted playtime (duration) | `%oumprofile_playtime_formatted%` | `` | | Stored skill level | `%oumprofile_skill___level%` | `__level>` | | Stored skill experience | `%oumprofile_skill___xp%` | `__xp>` | | Stored job level | `%oumprofile_job__level%` | `_level>` | | Stored job experience | `%oumprofile_job__xp%` | `_xp>` | | Custom economy balance | `%oumprofile_currency_%` | `>` | --- ## Custom Items & Head Textures GUI materials support OumLib's item resolution. Custom head textures (`head:`) and items from third-party plugins can be used directly: * `head:` * `oraxen:custom_item` * `itemsadder:custom_item` * `nexo:custom_item` * `mmoitems:TYPE:ID` * `mythicmobs:item_id` --- ## Support & Links * **Discord Support Server:** [https://discord.gg/maDcwPV6KB](https://discord.gg/maDcwPV6KB) * **GitHub Repository:** [https://github.com/sun-mc-dev/oumprofile](https://github.com/sun-mc-dev/oumprofile)

OumProfile

1.0-SNAPSHOT

Information

Platforms

Dependencies