#NEW README

AdminToolkitPlugin

AdminToolkit is a comprehensive server administration plugin for Paper (Minecraft 1.21.1). It provides a sleek graphical user interface (GUI) triggered by a single command, allowing administrators to manage world properties, player actions, and personal settings without memorizing complex commands.

🚀 Features

Centralized Admin GUI

• Main Command: Access all tools via the /admin command.
• Quick Navigation: Use /admin [player] with tab-completion to jump directly to a specific player's action menu.

🌍 World Management

• Time Control: Instantly switch between Day and Night.
• Weather Control: Toggle between Clear, Rain, and Storm.
• Maintenance Mode: Toggle server access; only admins can join when active.
• Global Actions: Teleport all players to spawn or send server-wide broadcast messages.
• Chat Management: Clear global chat or toggle a Global Mute to stop all non-admin chat.

👥 Player Management

• Punishments: Kill, Kick, and Ban with predefined or custom reason support.
• Control: Freeze/Unfreeze movement and Smite (lightning strike).
• Utility: View inventories, Ender Chests, Teleport to players, or Bring players to you.
• Messaging: Send direct admin messages to players via the GUI.
• Permissions: Manage player OP status directly or use the Fake OP prank.
• Gamemode: Set specific players to Survival, Creative, Adventure, or Spectator.
• History: View a player's X-Ray History to see all valuable ores mined this session.
• Restoration: Instantly Heal, Feed, or Starve players for testing/admin purposes.

🛡️ Anti-Cheat System

• X-Ray Alerts: Real-time, global monitoring for suspicious mining activity.
• Tracked Ores: Fully customizable menu to select exactly which blocks (Diamonds, Ancient Debris, etc.) trigger alerts.
• Interactive Notifications: Chat alerts are clickable; clicking an alert instantly opens the mining player's X-Ray history and coordinates.

🛡️ Self Management

• Gamemode: Quickly toggle between Survival, Creative, Adventure, and Spectator.
• Vanish Mode: Become completely invisible to other players on the server.
• Admin Essentials: Self-heal and self-feed.

📊 System & Persistence

• Live Health Monitor: Real-time TPS and Memory usage tracking within the GUI.
• Smart Persistence: Maintenance mode, Global Mute, Vanish, Freeze, and Tracked Ore settings are automatically saved and restored across server restarts.

🛠️ Installation & Usage

1. Download the latest JAR from the Releases page (or build it yourself).
2. Place the JAR in your Paper server's plugins/ folder.
3. Restart your server.
4. Use /admin in-game to open the toolkit.

Permissions

• admintoolkit.admin: Required for all admin features (defaults to OP).

🔨 Development

Prerequisites

• Java 21
• Gradle

📜 Technical Details

• Platform: Paper API (1.21.1)
• Text Engine: Adventure API (Component-based)
• Build System: Gradle (Kotlin DSL)

---

Created for Paper Minecraft administrators.