📖 Overview

CaragAdminManager is a comprehensive administration plugin for Minecraft Paper servers (1.21.8) that provides advanced rank management, player homes, random teleportation, timers, and a unique slave system. Designed for server administrators who need robust player management tools with customizable features.

✨ Key Features

🏆 Advanced Rank System
Four distinct ranks with visual indicators in tablist and chat

Automatic OP permissions for privileged ranks

Color-coded display with brackets

Persistent rank storage across server restarts

Available Ranks:

[ADMIN] 🔴 - Red color, full OP rights

[DEVELOPER] 🔵 - Blue color, OP rights

[USER] ⚪ - Gray color, no OP rights

[SLAVE] 🟤 - Brown color, slave permissions

⛓️ Unique Slave System
Player claiming with copper block economy (5 blocks required)

Punishment mechanics with temporary bedrock cages

Forced teleportation for slave obedience

Master-slave relationships with persistent data storage

🏠 Home Management
Personal homes with up to 10 locations per player

Simple commands for setting and teleporting

Cross-world support for versatile home locations

Persistent storage ensuring homes survive restarts

🎯 Random Teleport (RTP)
Smart queue system with 10-second delays between teleports

Safe location detection avoiding dangerous areas

Fair access preventing teleport spam

Automatic processing with position tracking

⏰ Advanced Timer & Stopwatch
Animated gradient display in action bar (black to green)

Smooth color wave animation moving left to right

Multiple control options start, stop, reset, hide, show

Precise time tracking with minute-second formatting

🎮 Commands

Rank Management
Command Description Example
/rank set Sets player's rank /rank set Steve ADMIN
/rank list Shows available ranks /rank list
Slave System
Command Description Example
/slave claim Claims player as slave (costs 5 copper blocks) /slave claim Alex
/slave punish Punishes slave with 10-minute bedrock cage /slave punish Alex
/slave tp here Teleports your slave to you /slave tp here
Home System
Command Description Example
/sethome Sets home location (max 10) /sethome castle
/home Teleports to home location /home castle
Random Teleport
Command Description Queue
/rtp Random teleportation 10-second queue
Timer System (Animated Gradient)
Command Description Example
/timer start Starts animated gradient timer /timer start 5
/timer stop Stops timer /timer stop
/timer reset Resets timer /timer reset
/timer hide Hides timer display /timer hide
/timer show Shows timer display /timer show
Stopwatch System (Animated Gradient)
Command Description Example
/stopwatch start Starts animated gradient stopwatch /stopwatch start
/stopwatch stop Stops stopwatch /stopwatch stop
/stopwatch reset Resets stopwatch /stopwatch reset
/stopwatch hide Hides stopwatch display /stopwatch hide
/stopwatch show Shows stopwatch display /stopwatch show

🔧 Technical Features

🎨 Visual Enhancements
Animated gradient text with smooth color transitions

Action bar displays for non-intrusive time tracking

Color-coded chat and tablist for immediate rank recognition

Sinus wave animations for premium visual experience

💾 Data Management
YAML-based storage for easy configuration

Automatic data saving on server shutdown

Efficient data loading on server startup

UUID-based player tracking for name change support

⚡ Performance Optimizations
Async task handling for minimal server impact

Efficient queue processing for RTP system

Smart location validation for safe teleports

Optimized event handling for better performance

🛠️ Installation
Requirements
Minecraft Paper 1.21.8

Java 17 or higher

Bukkit/Spigot compatible server

Setup Steps
Download the CaragAdminManager.jar file

Place in your server's plugins folder

Restart the server

Configure permissions as needed

The plugin creates necessary data files automatically

🔐 Permissions
The plugin uses OP-based permissions by default:

caragadminmanager.* - Full access to all features

caragadminmanager.rank - Access to rank management commands