UltProfile

---

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

---

H2

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:

1. Fork the repository
2. Create a feature branch
3. Test properly
4. 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

---