mProfile
专为隐私设计的玩家档案、统计数据、隐私控制及社交集成,适用于 Paper、Purpur 和 Folia。
功能特性
- 为在线玩家及服务器曾见过的所有玩家提供原生的 26.3 版本档案对话框,并支持物品栏回退。
- 个人简介、可配置的颜色主题与封面,以及
PUBLIC(公开)、LIMITED(受限)或 PRIVATE(私有)可见性设置。
- 可选的整宽插图封面,由内置的 Minecraft 26.3 资源包提供,并支持自动文本回退。
- 针对统计数据、活动、集成及接收消息操作的个性化控制。
- 显示游戏时长、击杀数、死亡数、首次出现时间、最后出现时间及在线状态。
- 支持 Shift+右键访问,并配有短时间的可配置防骚扰冷却。
- 完全可配置的 GUI 大小、物品槽位、材质及主题强调色。
- 可选的消息、举报和忽略按钮。建议模式(Suggest mode)允许玩家在命令执行前确认或补全命令。
- 可选来自 mBadges、mReputation 和 mColor 的摘要信息,无硬性依赖。
- 可选的 mReputation 推荐功能,附带证据和滥用保护;负面投票默认单独禁用。
- 默认英文,并在
config.yml 中选择完整的俄语翻译。
- 异步本地 H2 存储及公开的 Bukkit Services API。
- 原生支持 Paper 和 Folia 调度器;玩家和物品栏操作保持在所属实体线程上运行。
要求与安装
- Java 25
- Paper、Purpur 或 Folia 26.3
- 将
mProfile-1.3.0.jar 放入服务器的 plugins 目录。
- 启动服务器一次。
- 根据需要编辑
plugins/mProfile/config.yml。
- 运行
/profile reload。
生成的默认配置无需其他插件即可正常工作。设置 language.default: ru_RU 并重新加载,即可将消息和 GUI 切换为俄语。缺失的翻译键会自动回退到内置的英文。
命令
| 命令 |
权限 |
描述 |
/profile |
mprofile.use |
打开你的档案 |
/profile <player> |
mprofile.use |
打开在线或已存储的玩家档案 |
/profile bio <text> |
mprofile.edit |
设置个人简介;省略文本以清除它 |
/profile visibility <PUBLIC|LIMITED|PRIVATE> |
mprofile.edit |
设置档案隐私级别 |
/profile theme <name> |
mprofile.edit |
选择已配置的主题 |
/profile settings |
mprofile.edit |
打开个人档案设置 |
/profile inventory [player] |
mprofile.use |
强制使用经典物品栏视图 |
/profile vote <player> <positive|negative> |
mprofile.vote |
为启用的 mReputation 投票打开证据表单 |
/profile reload |
mprofile.reload |
重新加载配置文件和语言文件 |
mprofile.view.private 允许受信任的管理员检查私有档案。mprofile.cooldown.bypass 可绕过查看冷却时间。mprofile.admin 授予管理员权限。
隐私模型
PUBLIC 允许其他玩家查看该档案及其统计数据。
LIMITED 允许打开档案,但隐藏详细统计数据。
PRIVATE 除非拥有明确的绕过权限,否则完全阻止其他玩家访问。
所有者始终可以查看自己的档案。各部分的开关可以隐藏统计数据、活动、集成或消息操作,而不会削弱主要的可见性模式。mProfile 仅存储 Minecraft UUID、最后登录名、个人简介、隐私/主题/封面偏好以及显示的 gameplay 统计数据。它不存储 IP 地址、聊天记录、物品栏内容或位置历史。
GUI 与交互
gui.mode: DIALOG 使用 Paper 的原生 26.3 对话框 API。将其设置为 INVENTORY,使用 /profile inventory,或保持 gui.fallback-to-inventory: true 以获得经典视图。config.yml 中的物品栏槽位使用从 1 到配置大小的易读编号。无效的材质和槽位会安全地回退或被跳过;重复槽位绝不会创建多个动作。
language:
default: en_US
access:
view-cooldown-millis: 750
right-click:
enabled: true
require-sneaking: true
interactions:
enabled: true
actions:
message:
enabled: true
slot: 47
material: PAPER
mode: SUGGEST
command: "msg {player} "
required-plugin: ""
SUGGEST 发送一个可点击的提示,用于准备命令。RUN 会立即执行命令,仅应用于那些已经执行自身权限和确认检查的命令。带有 required-plugin 的动作在该插件不可用时将被隐藏。
带插图的档案封面
1.3.0 版本包含五个原创全景封面:森林(Forest)、下界(Nether)、海洋(Ocean)、末地(End)和太空(Space)。它们以位图字体字形的方式实现,并集成在一个可选的 Minecraft 26.3 资源包中,因此原生对话框可以显示真实图片,而不仅仅是封面名称。
首次启动时,mProfile 会提取 plugins/mProfile/mProfile-resource-pack-1.3.0.zip。选择以下两种部署方式之一:
- 将 ZIP 文件随同
server.properties 中的 resource-pack 或现有的整合包管理器一起分发。然后设置 profile.cover-images.enabled: true 和 assume-loaded: true。
- 将该未修改的 ZIP 托管在直接的 HTTP(S) URL 上,设置
enabled: true、auto-send: true、url,以及通过 sha1sum mProfile-resource-pack-1.3.0.zip 获取的小写 SHA-1 值。
启用自动分发后,仅当客户端报告该资源包已成功加载时,mProfile 才会显示图片。被拒绝、加载失败、缺失、自定义以及 NONE 类型的封面仍保留配置的文本展示形式。该资源包为可选组件,绝不会更改已存储的个人资料数据。
存储与安全
个人资料数据保存在 plugins/mProfile/profiles.mv.db 中。数据库访问在专用的虚拟线程上串行执行,永远不会阻塞服务器主循环。写入失败不会回滚较新的缓存更新;损坏的隐私值会安全失效;关闭时会等待最多五秒,随后取消剩余的存储任务。
配置输入受到限制:传记内容符合数据库架构,控制字符会被移除,玩家名称和语言环境路径经过验证,冷却时间会被钳制,自定义动作命令会拒绝控制字符。动态玩家文本直接插入,不解析 MiniMessage 标签。
在服务器之间迁移数据前,请先备份插件目录。切勿在服务器运行时编辑数据库。
API
其他插件可以通过 Bukkit 的服务管理器加载 MProfileApi。读取个人资料返回 CompletableFuture<Optional<ProfileSnapshot>>;打开 GUI 返回 CompletableFuture<Boolean>,并会自动交由正确的玩家调度器处理。请针对 api/build/libs 中生成的轻量级 API JAR 进行编译。
遥测与更新
bStats 默认处于禁用状态,直到分配了公开的项目 ID。如果稍后启用,它不包含任何 UUID、名称、传记或个人资料统计数据。异步 Modrinth 更新检查是独立的,可通过设置 updates.enabled: false 来禁用。
构建
./gradlew clean build
插件 JAR 文件输出至 build/libs,独立的封面资源包输出至 build/distributions,API 构件输出至 api/build/libs。
本软件基于 MIT 许可证授权。
mProfile
Private-by-design player profiles, statistics, privacy controls, and social integrations for Paper, Purpur, and Folia.
Features
- Native 26.3 profile dialogs for online players and everyone previously seen by the server, with an inventory fallback.
- Biography, configurable color theme and cover, plus
PUBLIC, LIMITED, or PRIVATE visibility.
- Optional full-width illustrated dialog covers supplied by the bundled Minecraft 26.3 resource pack, with automatic text fallback.
- Personal controls for statistics, activity, integrations, and incoming message actions.
- Playtime, player kills, deaths, first-seen, last-seen, and online status.
- Shift-right-click access with a short configurable anti-spam cooldown.
- Fully configurable GUI size, item slots, materials, and theme accent colors.
- Optional message, report, and ignore buttons. Suggest mode lets the player confirm or complete a command before it runs.
- Optional summaries from mBadges, mReputation, and mColor, without hard dependencies.
- Opt-in mReputation endorsements with evidence and abuse protections; negative votes remain separately disabled by default.
- English by default and a complete Russian translation selected in
config.yml.
- Asynchronous local H2 storage and a public Bukkit Services API.
- Native Paper and Folia schedulers; player and inventory work stays on the owning entity thread.
Requirements and installation
- Java 25
- Paper, Purpur, or Folia 26.3
- Put
mProfile-1.3.0.jar in the server's plugins directory.
- Start the server once.
- Edit
plugins/mProfile/config.yml if desired.
- Run
/profile reload.
The generated defaults work without another plugin. Set language.default: ru_RU and reload to switch messages and the GUI to Russian. Missing translation keys fall back to bundled English automatically.
Commands
| Command |
Permission |
Description |
/profile |
mprofile.use |
Open your profile |
/profile <player> |
mprofile.use |
Open an online or stored profile |
/profile bio <text> |
mprofile.edit |
Set a biography; omit text to clear it |
/profile visibility <PUBLIC|LIMITED|PRIVATE> |
mprofile.edit |
Set profile privacy |
/profile theme <name> |
mprofile.edit |
Select a configured theme |
/profile settings |
mprofile.edit |
Open personal profile settings |
/profile inventory [player] |
mprofile.use |
Force the classic inventory view |
/profile vote <player> <positive|negative> |
mprofile.vote |
Open the evidence form for an enabled mReputation vote |
/profile reload |
mprofile.reload |
Reload configuration and language files |
mprofile.view.private lets trusted staff inspect private profiles. mprofile.cooldown.bypass bypasses the viewing cooldown. mprofile.admin grants the staff permissions.
Privacy model
PUBLIC allows other players to view the profile and its statistics.
LIMITED allows the profile to open but hides detailed statistics.
PRIVATE blocks other players entirely unless they have the explicit bypass permission.
The owner can always view their own profile. Per-section switches can hide statistics, activity, integrations, or the message action without weakening the main visibility mode. mProfile stores only the Minecraft UUID, last name, biography, privacy/theme/cover preferences, and displayed gameplay statistics. It does not store IP addresses, chat, inventory contents, or location history.
GUI and interactions
gui.mode: DIALOG uses Paper's native 26.3 dialog API. Set it to INVENTORY, use /profile inventory, or keep gui.fallback-to-inventory: true for the classic view. Inventory slots in config.yml use human-friendly numbering from 1 through the configured size. Invalid materials and slots fall back or are skipped safely; duplicate slots never create multiple actions.
language:
default: en_US
access:
view-cooldown-millis: 750
right-click:
enabled: true
require-sneaking: true
interactions:
enabled: true
actions:
message:
enabled: true
slot: 47
material: PAPER
mode: SUGGEST
command: "msg {player} "
required-plugin: ""
SUGGEST sends a clickable prompt that prepares the command. RUN executes it immediately and should only be used for commands that already perform their own permission and confirmation checks. Actions with required-plugin are hidden while that plugin is unavailable.
Illustrated profile covers
Version 1.3.0 includes five original panoramic covers: Forest, Nether, Ocean, End, and Space. They are implemented as bitmap font glyphs in an optional Minecraft 26.3 resource pack, so the native dialog can display a real image instead of only the cover name.
On first start, mProfile extracts plugins/mProfile/mProfile-resource-pack-1.3.0.zip. Choose one setup:
- Distribute that ZIP with
resource-pack in server.properties or an existing pack manager. Then set profile.cover-images.enabled: true and assume-loaded: true.
- Host the unchanged ZIP at a direct HTTP(S) URL, set
enabled: true, auto-send: true, url, and its lowercase SHA-1 from sha1sum mProfile-resource-pack-1.3.0.zip.
With automatic delivery, mProfile displays an image only after the client reports that this exact pack loaded successfully. Declined, failed, missing, custom, and NONE covers retain the configured text presentation. The pack is optional and never changes stored profile data.
Storage and safety
Profile data is kept in plugins/mProfile/profiles.mv.db. Database access is serialized on a dedicated virtual thread and never blocks a server tick. Failed writes cannot roll back a newer cached update, corrupted privacy values fail closed, and shutdown waits at most five seconds before cancelling remaining storage tasks.
Configuration input is bounded: biographies fit the database schema, control characters are removed, player names and locale paths are validated, cooldowns are clamped, and custom action commands reject control characters. Dynamic player text is inserted without MiniMessage tag interpretation.
Back up the plugin directory before moving data between servers. Do not edit the database while the server is running.
API
Other plugins can load MProfileApi from Bukkit's Services Manager. Profile reads return CompletableFuture<Optional<ProfileSnapshot>>; GUI opens return CompletableFuture<Boolean> and are automatically handed to the correct player scheduler. Compile against the lightweight API JAR produced in api/build/libs.
Telemetry and updates
bStats is disabled by default until a public project ID is assigned. If enabled later, it contains no UUIDs, names, biographies, or profile statistics. The asynchronous Modrinth update check is separate and can be disabled with updates.enabled: false.
Build
./gradlew clean build
The plugin JAR is written to build/libs, the standalone cover pack to build/distributions, and API artifacts to api/build/libs.
Licensed under the MIT License.
评论 0
登录后参与评分
还没有评论,来抢沙发吧