A highly customizable Profile UI library for Minecraft.

Profile API is more than just a stats viewer—it's a polished, modular UI framework for Minecraft. By right-clicking any player, you gain access to a beautifully structured profile screen showing real-time character models, equipment, and dynamic data from across the modding ecosystem.

• 👤 Real-time 3D Preview: See players in their full glory with high-resolution, centered 3D model rendering.
• 🛡️ Interactive Equipment: View equipped armor slots with hoverable tooltips showing names, enchantments, and stats.
• 📊 Structured Data: Information is organized into clean, row-based layouts with subtle highlights.
• 🎨 Premium Visuals:
  • Fancy Panels: Framed UI elements for a professional, "embedded" feel.
  • Conditional Coloring: Health is Red, Experience is Green, and Titles match Team colors.
  • Dynamic Icons: Automatic icons for Health, Hunger, and XP (with custom Icon support for developers).
• ⚙️ Ultra Configurable: Toggle almost every visual element—from the 3D model to the "Fancy" panel styling.
• 🧩 Modular API: Developers can register custom "Profile Components" in seconds.

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() { 
        // Can be dynamic colored text
        return Component.literal("Lv. 99").withStyle(ChatFormatting.GOLD); 
    }
    
    @Override
    public ResourceLocation getIcon() {
        return new ResourceLocation("yourmod", "textures/gui/strength_icon.png");
    }
});

1. Download the latest version from Modrinth or CurseForge.
2. Drop the .jar file into your Minecraft mods folder.
3. Ensure you have the correct version of Mod Loader installed.

• Right-Click any player to view their profile.
• Command: /profile view <player> (supports self-view and others).

You are absolutely free to include Profile API in any modpack! No explicit permission is required, though a link back to this page is always appreciated.

We encourage other developers to use Profile API as a dependency! Since it is licensed under LGPL 3.0, you can build mods that depend on this library without having to license your own mod under LGPL, as long as you don't modify the Profile API source code itself.

• 📚 Wiki & Documentation
• 🐞 Issue Tracker
• 📖 Modrinth Project
• 📖 CurseForge Project
• 💬 Discord Community
• 🛠️ Source Code

If you find this library useful, please consider:

• ⭐ Starring the repository!
• 👤 Following me on GitHub, Modrinth, and CurseForge.
• 🛠️ Building Mods: Create new mods that depend on Profile API to grow the ecosystem.
• 🚀 Server Hosting: Use our link to buy a server via BisectHosting with 25% OFF using our link: Get 25% Off Here!