Download the MCProfiles plugin
The Paper plugin bridges your Minecraft server to the MCProfiles website. It handles player verification, role syncing, heartbeats, and the /claimprofile flow.
Paper 1.21.4+
Java 21 runtime
MCProfiles API key
LuckPerms (optional)
Version
1.0.0
File size
28.6 KB
Paper
1.21.4+
SHA-256
0d37f8171a27dda0813d580139c405e6544f99ac95418874099bb295f63a2eaf
Six steps from download to verified player claims.
The plugin registers with MCProfiles on startup using your API key and server slug.
Download the plugin JAR
Click the download button above to get the latest MCProfiles Paper plugin.
Drop it into your plugins folder
Copy the downloaded JAR into your Paper server's plugins/ directory. Restart to generate the default config.
Create a server page
Go to the dashboard and create a new server page. Choose your slug carefully.
Generate an API key
In the server dashboard, generate a new API key. Copy it immediately — it won't be shown again.
Configure the plugin
Open plugins/MCProfiles/config.yml and fill in the base-url, api-key, and server-slug fields.
Restart and verify
Restart the server or run /mcprofiles reload, then /mcprofiles status to confirm registration.
Minimal config. Three required fields.
After the plugin generates its default config, open config.yml and set these values.
# plugins/MCProfiles/config.yml
mcprofiles:
base-url: "https://mcprofiles.me"
api-key: "mcprf_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
server-slug: "your-server"
public-ip: "play.example.net"
sync-interval-seconds: 300
sync-luckperms-groups: true
Signed HTTP, LuckPerms-aware, push-model sync.
Every request from the plugin is signed with HMAC SHA-256. No polling from the website side.
/claimprofile
Generates a short-lived claim token for the player. They redeem it on the website to link their Minecraft identity.
Player & role sync
Periodically pushes player data and LuckPerms groups. Profiles, badges, and staff flags stay current automatically.
Heartbeat
Reports online player counts on a regular interval. The dashboard shows real-time connection status.
Ready to connect?
Create a server page, generate an API key, and start verifying players.