OumProfile
OumProfile 是一个适用于 Paper 服务器(1.21+)的多配置文件插件。它允许玩家创建并在不同的配置档案槽位之间切换,每个槽位都拥有独立的物品栏、状态属性、LuckPerms 权限组和 Vault 经济余额。这对于在同一账号上提供不同装备配置或游戏模式的服务器非常有用。
本插件基于 OumLib 框架构建。
功能
每个玩家配置文件存储:
- 物品栏状态:储物箱内容、盔甲内容、副手物品以及末影箱。
- 属性:生命值、最大生命值、饥饿值、饱和度、经验等级和经验进度。
- 状态信息:游戏模式、激活的药水效果、摔落距离、燃烧刻数以及剩余气泡值。
- 移动状态:飞行能力(
allowFlight 和 isFlying 状态)。
- 可选功能:坐标位置(如果启用了
save-location)、Vault 余额、LuckPerms 权限组、mcMMO 技能、AuraSkills、JobsReborn 职业、自定义多货币、游戏时间追踪以及原版 Minecraft 统计数据。
- 服务器韧性:非阻塞式定期自动保存以防止意外崩溃,以及管理端的过期配置文件清理(
/profile admin prune <days>)以保持数据库存储紧凑。
依赖要求
- 服务器: Paper 1.21 或更高版本
- Java: Java 21 或更高版本
- 库: OumLib(已嵌入 jar 包中)
软依赖
如果服务器上安装了以下插件,该插件将自动集成:
- LuckPerms:用于按配置文件区分权限组。
- Vault & PlayerPoints:用于按配置文件区分经济余额。
- mcMMO:用于按配置文件同步技能等级和经验值。
- AuraSkills:用于按配置文件同步技能等级和经验值。
- JobsReborn:用于按配置文件推进职业等级和经验值。
- CombatLogX / PvPManager / DeluxeCombat:自动检测战斗标记,阻止在战斗中切换配置文件。
- PlaceholderAPI & MiniPlaceholders:用于在聊天、计分板和标签页中显示配置文件统计数据。
命令与权限
玩家命令
| 命令 |
描述 |
权限 |
默认值 |
/profile |
打开配置文件选择 GUI。 |
profiles.use |
True |
/profile list |
在聊天中列出所有已创建的配置文件。 |
profiles.use |
True |
/profile current |
显示当前活动的配置文件名称。 |
profiles.use |
True |
/profile create <name> |
使用给定名称创建一个新的配置文件。 |
profiles.create.<name> |
OP |
/profile switch <name> |
切换到指定的配置文件。 |
profiles.use |
True |
/profile delete <name> |
删除指定的配置文件。 |
profiles.use |
True |
/profile rename <old> <new> |
重命名一个配置文件。 |
profiles.use |
True |
/profile alerts |
切换是否接收管理员配置文件警报。 |
profiles.alerts |
OP |
别名:/profiles, /prof
管理命令与权限
| 命令 / 权限 |
描述 |
默认值 |
/profile admin open <player> |
为指定玩家打开配置文件 GUI。 |
OP (profiles.admin) |
/profile admin list <player> |
列出指定玩家的所有配置文件。 |
OP (profiles.admin) |
/profile admin create <player> <profile> |
为指定玩家创建一个配置文件。 |
OP (profiles.admin) |
/profile admin switch <player> <profile> |
强制指定玩家切换到某个配置文件。 |
OP (profiles.admin) |
/profile admin delete <player> <profile> |
删除指定玩家的某个配置文件。 |
OP (profiles.admin) |
/profile admin rename <player> <old> <new> |
重命名指定玩家的某个配置文件。 |
OP (profiles.admin) |
/profile admin export <player> <profile> |
将玩家的配置文件导出为 JSON 文件。 |
OP (profiles.admin) |
/profile admin import <player> <file> |
从 JSON 文件导入玩家的配置文件。 |
OP (profiles.admin) |
/profile admin prune <days> |
清理超过指定天数的不活跃配置文件。 |
OP (profiles.admin) |
/profile debug |
切换控制台中的调试日志记录。 |
OP (profiles.admin) |
/profile reload |
重新加载所有配置文件。 |
OP (profiles.admin) |
profiles.admin |
访问管理命令和配置重载。 |
OP |
profiles.create.* |
有权创建任何名称的配置文件。 |
OP |
profiles.max.unlimited |
绕过所有配置文件槽位限制。 |
OP |
profiles.max.<number> |
设置最大配置文件槽位限制(例如 profiles.max.5)。 |
False |
profiles.bypass.combat |
允许在战斗标记状态下切换配置文件。 |
OP |
profiles.bypass.warmup |
绕过切换倒计时预热。 |
OP |
profiles.bypass.cooldown |
绕过切换冷却时间。 |
OP |
profiles.alerts |
接收关于配置文件操作的管理员警报。 |
OP |
占位符
支持 PlaceholderAPI 和 MiniPlaceholders 下的 oumprofile 命名空间:
| 描述 |
PlaceholderAPI |
MiniPlaceholders |
| 当前配置文件名称 |
%oumprofile_active% |
<oumprofile_active> |
| 已创建的配置文件总数 |
%oumprofile_count% |
<oumprofile_count> |
| 允许的最大配置文件数量 |
%oumprofile_max% |
<oumprofile_max> |
| 保存的 Vault 经济余额 |
%oumprofile_balance% |
<oumprofile_balance> |
| 存储的主 LuckPerms 组 |
%oumprofile_group% |
<oumprofile_group> |
| 配置文件游戏时长(秒) |
%oumprofile_playtime% |
<oumprofile_playtime> |
| 格式化后的游戏时长(持续时间) |
%oumprofile_playtime_formatted% |
<oumprofile_playtime_formatted> |
| 存储的技能等级 |
%oumprofile_skill_<plugin>_<skill>_level% |
<oumprofile_skill_<plugin>_<skill>_level> |
| 存储的技能经验值 |
%oumprofile_skill_<plugin>_<skill>_xp% |
<oumprofile_skill_<plugin>_<skill>_xp> |
| 存储的职业等级 |
%oumprofile_job_<job>_level% |
<oumprofile_job_<job>_level> |
| 存储的职业经验值 |
%oumprofile_job_<job>_xp% |
<oumprofile_job_<job>_xp> |
| 自定义经济余额 |
%oumprofile_currency_<name>% |
<oumprofile_currency_<name>> |
自定义物品与头颅纹理
GUI 材质支持 OumLib 的物品解析。可以直接使用自定义头颅纹理(head:<base64>)以及来自第三方插件的物品:
head:<Base64>
oraxen:custom_item
itemsadder:custom_item
nexo:custom_item
mmoitems:TYPE:ID
mythicmobs:item_id
支持与链接
- Discord 支持服务器:
- GitHub 仓库:
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 (
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 <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_item
itemsadder:custom_item
nexo:custom_item
mmoitems:TYPE:ID
mythicmobs:item_id
Support & Links
- Discord Support Server:
- GitHub Repository:
评论 0
登录后参与评分
还没有评论,来抢沙发吧