Profile API

Profile API

媒体库添加了玩家档案界面;包含右键交互、开发者 API 和完整命令支持。

基础库

Profile API Banner

Modrinth Downloads CurseForge Downloads GitHub Issues GitHub Stars Discord License

一个高度可定制的 Minecraft 个人资料 UI 库。


🌟 概述

Profile API 不仅仅是一个统计数据查看器——它是一个为 Minecraft 打造的精致、模块化 UI 框架。右键点击任意玩家,你就能打开一个结构精美的个人资料界面,展示实时角色模型、装备以及来自整个模组生态系统的动态数据。

✨ 主要特性

  • 👤 实时 3D 预览:以高分辨率、居中的 3D 模型渲染,让玩家全貌尽收眼底。
  • 🛡️ 交互式装备:查看已装备的盔甲槽位,悬停提示可显示名称、附魔和属性。
  • 📊 结构化数据:信息以简洁的基于行的布局组织,并带有细微高亮。
  • 🎨 高级视觉效果:
    • 精美面板:带边框的 UI 元素,营造专业、"嵌入式"的观感。
    • 条件着色:生命值为红色,经验值为绿色,头衔与队伍颜色一致。
    • 动态图标:自动为生命值、饥饿值和经验值显示图标(开发者可自定义图标)。
  • ⚙️ 高度可配置:几乎可以开关每一个视觉元素——从 3D 模型到"精美"面板样式。
  • 🧩 模块化 API:开发者可在几秒内注册自定义"资料组件"。

🛠️ 面向开发者

添加到你的项目(Gradle)

repositories {
    maven {
        name = "GitHubPackages"
        url = uri("https://maven.pkg.github.com/yigit-guven/Profile-API")
    }
}

dependencies {
    implementation "net.yigitguven.profile:profile:VERSION"
}

注册组件

ProfileRegistry.register(player -> new ProfileComponent() {
    @Override
    public ResourceLocation getId() { 
        return new ResourceLocation("yourmod", "example_stat"); 
    }

    @Override
    public Component getTitle() { 
        return Component.literal("Strength"); 
    }

    @Override
    public Component getValue() { 
        // 可以是动态彩色文本
        return Component.literal("Lv. 99").withStyle(ChatFormatting.GOLD); 
    }
    
    @Override
    public ResourceLocation getIcon() {
        return new ResourceLocation("yourmod", "textures/gui/strength_icon.png");
    }
});

📦 游玩方法

安装

  1. 从 Modrinth 或 CurseForge 下载最新版本。
  2. 将 .jar 文件放入 Minecraft 的 mods 文件夹。
  3. 确保已安装正确版本的 模组加载器。

操作方式

  • 右键点击任意玩家即可查看其个人资料。
  • 命令:/profile view <player>(支持查看自己或他人)。

许可证与使用

整合包

你完全可以将 Profile API 包含在任何整合包中!无需明确许可,不过如果能链接回本页面,我们将不胜感激。

使用 Profile API 进行开发

我们鼓励其他开发者将 Profile API 作为依赖项使用!由于它采用 LGPL 3.0 许可,你可以构建依赖此库的模组,而无需将自己的模组也以 LGPL 许可,前提是你不修改 Profile API 本身的源代码。


🔗 项目链接


❤️ 支持项目

如果你觉得这个库有用,请考虑:

  • ⭐ 为仓库加星!
  • 👤 在 GitHub、Modrinth 和 CurseForge 上关注我。
  • 🛠️ 构建模组:创建依赖 Profile API 的新模组,壮大生态系统。
  • 🚀 服务器托管:使用我们的链接通过 BisectHosting 购买服务器,享受 25% 折扣:在此获取 25% 折扣!

由 Yigit Guven 用 ❤️ 制作