mProfile

插件

· 作者 miklires

适用于 Paper、Purpur 和 Folia 的隐私优先玩家档案、统计信息、隐私控制及社交集成。

0 本站下载 0 关注 更新于 1 个月前

最新 1.3.0 · 26.3 · Folia / Paper

一键开服(送7天)

mProfile

专为隐私设计的玩家档案、统计数据、隐私控制及社交集成,适用于 Paper、Purpur 和 Folia。

GitHub Modrinth

功能特性

  • 为在线玩家及服务器曾见过的所有玩家提供原生的 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
  1. 将 mProfile-1.3.0.jar 放入服务器的 plugins 目录。
  2. 启动服务器一次。
  3. 根据需要编辑 plugins/mProfile/config.yml。
  4. 运行 /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。选择以下两种部署方式之一:

  1. 将 ZIP 文件随同 server.properties 中的 resource-pack 或现有的整合包管理器一起分发。然后设置 profile.cover-images.enabled: true 和 assume-loaded: true。
  2. 将该未修改的 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 许可证授权。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源