Overview

UltProfile is a powerful all-in-one player profile and administration plugin built for modern Minecraft servers.

The plugin provides:

Advanced player tracking
Full moderation utilities
Interactive GUI-based management
Inventory and enderchest inspection/editing
Session history tracking
Configurable admin tools
Multiple database backends
Full GUI customization

Everything in UltProfile is configurable.

Every:

GUI
Button
Material
Lore
Slot
Message
Feature
Action
Toggle
Placeholder
Color
Layout

can be customized.

Nothing user-facing is hardcoded.

Features

Player Tracking

Track player IP addresses
Track exact join locations
Track exact leave locations
Track first join timestamps
Track latest join timestamps
Track leave timestamps
Track total joins
Track total playtime
Track worlds
Track gamemodes
Track health
Track food levels
Track XP levels
Track kills
Track deaths
Automatic KDR calculation
Full session history logging
Offline player support
Async database loading

GUI System

Fully Editable GUIs

Every GUI in the plugin is fully editable inside guis.yml.

You can customize:

GUI titles
Inventory sizes
Slots
Materials
Lore
Item names
Colors
Click actions
Decorative panes
Background layouts
Button permissions
Placeholder formatting

No GUI layout is hardcoded.

Included GUIs

Player Profile GUI
Admin Panel GUI
Inventory View GUI
Enderchest View GUI
Session History GUI
Confirmation GUI
Admin Config GUI

Player Profile GUI

Real-time player skull rendering
Online/offline status
Join/leave information
Statistics display
Playtime display
Health and XP display
Session history access
Inventory access
Enderchest access
Admin panel access

Admin Panel Features

Kick players
Permanently ban players
Temporarily ban players
IP ban players
Mute/unmute players
Warn players
Freeze/unfreeze players
Heal players
Feed players
Kill players
Toggle flight
Toggle god mode
Toggle vanish
Change gamemode
Teleport to players
Teleport players to you
Teleport to join locations
Teleport to leave locations
Clear inventories
View inventories
View enderchests

Inventory & Enderchest Viewing

View inventories live
Edit inventories live
View armor slots
View offhand slots
View enderchests
Shift-click support
Drag-and-drop support
Real-time synchronization
Read-only or editable modes

Session History

Paginated session viewer
Join timestamps
Leave timestamps
Session durations
Join locations
Leave locations
World tracking
IP tracking
Click-to-teleport actions

Moderation Systems

Freeze System

Configurable freeze system supporting:

Movement prevention
Chat prevention
Command blocking
Block break prevention
Block place prevention

Freeze state persists through relogs.

Mute System

Temporary mute support
Permanent mute support
Chat blocking
Command blocking
Configurable blocked commands

Mute state persists through relogs.

IP Ban System

Login-time IP enforcement
Database-backed storage
Native Minecraft IP ban support
Auto-kick online players after IP ban

Database Support

Supported databases:

SQLite
MySQL
MariaDB
PostgreSQL
H2
MongoDB

Performance Features

Async database operations
In-memory caching
Optimized GUI rendering
Efficient session storage
Folia compatibility
Thread-safe systems
Batched saves

Customization Features

Fully editable messages
Fully editable GUIs
Fully editable slots
Fully editable materials
Fully editable layouts
Feature toggles
Admin action toggles
Hex color support
In-game config GUI

Compatibility

Platform	Version	Status
Paper	1.21.x	✅ Supported
Spigot	1.21.x	✅ Supported
Purpur	1.21.x	✅ Supported
Folia	1.21.x	✅ Supported
Bukkit	1.21.x	⚠️ Untested

Java Requirement

Java 21 or higher is required.

Installation

Step 1

Download:

UltProfile-1.0.0.jar

Step 2

Move the jar file into:

/plugins/

Step 3

Restart your server.

Step 4

Edit generated configuration files:

plugins/UltProfile/

Step 5

Reload configs:

/upreload

Generated Files

plugins/UltProfile/
├── config.yml
├── messages.yml
├── guis.yml
├── data.db
└── admin-actions.log

Commands

Command	Aliases	Description	Permission
`/ultprofile`	`/up`, `/profile`	Open your own profile	`ultprofile.use`
`/ultprofile <player>`	`/up <player>`	Open another player's profile	`ultprofile.others`
`/upadmin`	`/upa`	Open admin configuration GUI	`ultprofile.admin`
`/upreload`	`/upr`	Reload plugin files	`ultprofile.reload`

Permissions

Core Permissions

Permission	Description
`ultprofile.use`	Use own profile
`ultprofile.others`	View others' profiles
`ultprofile.admin`	Access admin features
`ultprofile.reload`	Reload plugin

Admin Action Permissions

Permission
`ultprofile.action.kick`
`ultprofile.action.ban`
`ultprofile.action.tempban`
`ultprofile.action.ipban`
`ultprofile.action.tp`
`ultprofile.action.tphere`
`ultprofile.action.mute`
`ultprofile.action.warn`
`ultprofile.action.freeze`
`ultprofile.action.inventory`
`ultprofile.action.enderchest`
`ultprofile.action.clearinventory`
`ultprofile.action.heal`
`ultprofile.action.feed`
`ultprofile.action.kill`
`ultprofile.action.gamemode`
`ultprofile.action.fly`
`ultprofile.action.god`
`ultprofile.action.vanish`
`ultprofile.action.tpjoin`
`ultprofile.action.tpleave`

Configuration

config.yml

Controls:

Feature toggles
Database settings
Logging
Freeze settings
Mute settings
Cache settings
Admin actions
Permissions
Formatting

messages.yml

Controls:

Plugin messages
Action messages
Error messages
GUI text
Notifications
Placeholder formatting

Supports:

Hex colors
Legacy colors
Placeholders

guis.yml

Controls every GUI inside the plugin.

Fully Editable GUI Components

GUI titles
Inventory sizes
Item slots
Item materials
Item names
Item lore
Actions
Permissions
Decorative panes
Buttons
Layouts
Backgrounds
Pagination buttons
Navigation buttons

No GUI elements are hardcoded.

GUI System

Player Profile GUI

Displays:

Player head
Join info
Leave info
Statistics
Playtime
XP
Health
Inventory access
Enderchest access
Admin tools

Admin Panel GUI

Contains:

Moderation actions
Teleportation actions
Inventory management
Gamemode controls
Toggle systems

Only enabled actions appear.

Inventory View GUI

Supports:

Full inventory editing
Armor editing
Offhand editing
Shift-click support
Real-time syncing

Enderchest View GUI

Supports:

Enderchest editing
Live synchronization
Read-only mode
Editable mode

Session History GUI

Features:

Pagination
Teleportation
Detailed session lore
Join/leave history
World tracking

Confirmation GUI

Used before:

Kicks
Bans
Inventory clearing
Kill actions
Other destructive actions

Admin Config GUI

Allows toggling:

Features
Admin actions
Systems
Tracking options

All changes save instantly.

Database Setup

SQLite

Default setup:

database:
  type: SQLITE

MySQL

database:
  type: MYSQL
  host: localhost
  port: 3306
  database: ultprofile
  username: root
  password: password

MariaDB

database:
  type: MARIADB

PostgreSQL

database:
  type: POSTGRESQL

database:
  type: H2

MongoDB

database:
  type: MONGODB

Feature Toggles

All features can be enabled or disabled:

In config.yml
Through /upadmin

Disabled features:

Stop collecting data
Hide GUI buttons
Disable actions automatically

Placeholders

Placeholder	Description
	Player name
	Player IP
	Join time
	Leave time
	Total playtime
	Player world
	Gamemode
	Health
	Food
	XP level
	Kill count
	Death count
	KDR ratio
	Enabled/Disabled

FAQ

Does UltProfile support offline players?

Yes.

Are GUIs editable?

Yes. Every GUI is fully editable in guis.yml.

Can inventories be edited live?

Yes.

Does freeze persist through relogs?

Yes.

Can multiple admins edit inventories simultaneously?

Yes.

Does the plugin support Folia?

Yes.

Is PlaceholderAPI supported?

Not currently.

Troubleshooting

Plugin won't load

Ensure Java 21+
Ensure Minecraft 1.21.x
Check console errors

Database connection issues

Verify credentials
Verify database exists
Enable debug logging

GUI issues

Reload configs
Check YAML formatting
Verify feature toggles

Inventory editing not working

Ensure target is online
Ensure editing is enabled
Verify permissions

Contributing

Contributions are welcome.

Please:

Fork the repository
Create a feature branch
Test properly
Submit a pull request

License

All Rights Reserved

Copyright (c) 2026 UltProfile

This software and all associated files are proprietary.

You may not:
- Redistribute this software
- Resell this software
- Modify and redistribute this software
- Claim this software as your own
- Upload this software anywhere without permission

Purchasing or downloading this software grants usage rights only.

All rights remain reserved by the original author.

Support

Need help? Join the Discord server for support, bug reports, and updates.

Discord: https://discord.com/invite/xctckUQukB

Made with ❤️ for the Minecraft community