!PerPlayerProfiles Official Banner

PerPlayerProfiles

One Account. Multiple Profiles. Independent Progress.

PerPlayerProfiles allows multiple independent player profiles under a single Minecraft account.

Each profile has its own inventory, experience, location, statistics, security PIN, and play-time settings, all managed through an intuitive in-game GUI.

Perfect for shared accounts, roleplay characters, family servers, and players who want completely separate experiences.

🖥️ Compatibility

Supported Minecraft Versions

!Minecraft 1.20.X !Minecraft 1.21.X !Minecraft 26.1.X !Minecraft 26.2 !Minecraft 26.3

Supported Server Platforms

!Paper !Spigot !Bukkit

✨ Everything You Need, In One Plugin

!PerPlayerProfiles Features

• 🧑 Multiple Profiles — Create separate identities under one Minecraft account.
• 🎒 Independent Progress — Separate inventories, XP, Ender Chests, locations, and player states.
• 👑 Master Profile — Manage profile creation, deletion, PINs, and restrictions.
• 🔐 PIN Protection — Protect profiles using an interactive numeric keypad.
• ⏱️ Play-Time Limits — Configure maximum play time with automatic renewal.
• 🎨 Custom Icons — Personalize profiles with configurable Minecraft heads.
• 🌐 Multilingual Support — English, Spanish, German, and French.
• 🛡️ Login Compatibility — Works alongside supported GUI-based authentication systems.

🎒 Your Profile. Your Progress.

!Independent Player Data

!Independent Data !Clean Profiles

Every profile maintains its own saved player state.

New profiles start completely fresh: empty inventory, zero XP, full health, and an initial location at the world spawn.

No copying another profile's inventory or progress.

👑 Master Profile System

!Master Profile Management

!Master

The first profile becomes the Master Profile, responsible for managing the account.

It can create and delete profiles, manage PINs, configure restrictions, and customize profile settings.

The Master Profile cannot be deleted, always appears first, and retains its permissions even when renamed.

🔐 Visual PIN Protection

!PIN Protection GUI

!PIN !GUI !Master

Keep individual profiles protected with a visual numeric PIN system.

• Configurable PIN length from 4 to 9 digits.
• Interactive keypad with custom Minecraft heads.
• Visual feedback for incorrect PINs.
• Change or remove personal PINs.
• Separate Master PIN for sensitive actions.
• Master-controlled PIN resets.

Everything is managed directly in-game.

⏱️ Smart Play-Time Management

!Play-Time Management

!Limits !Renewal !Expiration

The Master Profile can assign individual play-time restrictions to other profiles.

Example: Allow 60 minutes of gameplay every 24 hours.

Players receive visual ActionBar warnings as their time runs out:

• 🟠 5 minutes: Orange countdown.
• 🔴 1 minute: Red countdown.
• 🚨 30 seconds: Blinking red countdown.

When the limit is reached, the player is automatically disconnected.

!Play-Time Limit Reached

The kick screen displays the affected profile and its renewal time.

🎨 Customization & Languages

!Language Selection

Customize profile icons using Minecraft heads, with support for additional Base64 skull textures.

Available Languages

!English !Spanish !German !French

All language files are separately configurable.

🛡️ Optional Security Integration

PerPlayerProfiles supports integration with Server Password, allowing players to complete server authentication before opening the profile selector.

How it works

• Players authenticate through Server Password first.
• PerPlayerProfiles waits for authentication to finish.
• The profile selector opens afterward without interrupting the login process.

Server Password is optional and not required to use PerPlayerProfiles.

View Server Password on Modrinth

⚙️ Installation & Commands

Quick Installation

1. Download the plugin .jar.
2. Place it inside your server's plugins/ folder.
3. Restart your server.
4. Customize plugins/PerPlayerProfiles/config.yml.

Main Command

/profiles

Opens the main profile-management interface.

Aliases: /ppp · /pprofile · /perfil · /perfiles

/profiles list
/profiles create <name> [pin]
/profiles use <name> [pin]
/profiles delete <name> [masterPin]
/profiles lock <name> <pin>
/profiles unlock <name> <currentPin>
/profiles setmasterpassword <pin>
/profiles setlimit <profile> <maxMinutes> <renewEveryHours> [masterPin]

profiles:
  max-per-account: 3

profiles:
  open-selector-on-join: true

security:
  pin:
    min-length: 4
    max-length: 9

profiles:
  selector-auth-wait-seconds: 60

compatibility:
  server-password:
    wait-for-auth: true

🚀 One Account. Your Own Experience.

Multiple profiles. Independent progress. Complete control.

PerPlayerProfiles makes managing multiple Minecraft identities simple, organized, and accessible — all from inside the game.