🛡️ CrystallAdmin

Advanced administration toolkit for Minecraft servers with built-in anti-cheat, moderation tools, and monitoring systems.

---

✨ Features

🔨 Moderation System

• Custom Punishment Screens - Beautiful kick/ban/mute messages with server branding
• Punishment History - Full database tracking of all punishments
• Warnings System - Timed warns with auto-expiration
• Report System - Player reports with GUI, claim/close, teleport to location
• Freeze & Vanish - Staff utilities for moderation

🕵️ Anti-Cheat (Lightweight)

• Reach Detection - Lag-compensated with ping filtering
• FastPlace Detection - Block placement speed monitoring
• AutoClicker Detection - CPS threshold checking
• X-Ray Monitor - Smart ore/stone ratio analysis with server-wide statistics
• Client Detection - Identifies Fabric/Forge/cheat clients via brand packets
• Configurable Alerts - Toggle per-check alerts and auto-kick/ban thresholds

👤 Player Management

• Player Cards (/cp <player>) - Detailed info: UUID, IP, client, ping, alts, punishments, warns, staff notes
• Staff Notes - Internal annotations on players (/note <player> <text>)
• Screenshare Mode (/ss <player>) - Freeze player, show contact info, auto-ban on disconnect
• Inventory Inspection - View player inventory and ender chest in real-time
• Spy Mode - Monitor player commands

📊 Server Tools

• Statistics Dashboard - TPS, RAM, uptime, player count
• Lagg Clear - Auto-cleanup with configurable warnings and filters
• Admin Chat - Toggle mode or quick prefix #message
• Anonymous Messages - Send messages to players without revealing sender
• Broadcast System - Server-wide announcements with formatting

🌍 Localization

• Full i18n Support - English and Russian included
• Easy to Translate - Add your own language via messages_<lang>.yml
• Switch in Config - Change general.language: en or ru

🔗 Integrations

• Discord Webhooks - Log all admin actions, punishments, reports to Discord
• LuckPerms Integration - Quick group assignment via /adm class <player> <group>

---

📥 Installation

1. Download the latest .jar from Modrinth
2. Place in your server's plugins/ folder
3. Restart your server
4. Configure in plugins/CrystallAdmin/config.yml

Requirements

• Purpur/Paper 1.21.x (tested on Purpur 1.21.1)
• Java 21 or higher

---

🎮 Commands

Main Command

• /adm or /ca - Main command (alias)
• /adm help [page] - Command help (3 pages)

Quick Commands (No /adm prefix needed)

• /cp <player> - Player info card
• /checkore <player> - X-Ray statistics
• /ss <player> - Start screenshare check
• /note <player> <text> - Add staff note
• /invsee <player> - View inventory
• /ec <player> - View ender chest
• /ac - Toggle admin chat

Punishment Commands

All work without /adm prefix and override Essentials:

• /ban <player> <reason> - Permanent ban
• /tempban <player> <time> <reason> - Temporary ban
• /mute <player> <time/perm> <reason> - Mute player
• /warn <player> <time/perm> <reason> - Warn player
• /kick <player> <reason> - Kick with custom screen
• /unban <player>, /unmute <player>, /unwarn <player> <#>

Time formats: 30m, 1h, 12h, 1d, 7d, 30d, 1mo, perm

Admin Tools

• /adm bc <text> - Broadcast message
• /adm a <player> <text> - Anonymous message
• /adm reports - Open reports GUI
• /adm v or /adm vanish - Toggle vanish
• /adm freeze <player> - Freeze/unfreeze
• /adm spy <player> - Spy on commands
• /adm history <player> - Punishment history
• /adm alert <text> - Title to all players
• /adm tpo <player> - Silent teleport
• /adm stats - Server statistics
• /adm lc - Manual lagg clear
• /adm reload - Reload config

---

⚙️ Configuration

Anti-Cheat Fine-Tuning

anticheat:
  enabled: true
  show-alerts: true
  modules:
    reach:
      enabled: true
      max-distance: 3.5    # blocks
      min-violations: 5    # consecutive hits before flag
      max-ping: 300        # ignore high-ping players
    fast-place:
      enabled: true
      max-blocks-per-second: 15
    auto-clicker:
      enabled: true
      max-cps: 20
    xray:
      enabled: true
      notify-threshold: 3.0      # percent
      deviation-multiplier: 2.5  # flag if >2.5x server average

Language Switching

general:
  language: ru  # or 'en'

Discord Integration

discord:
  enabled: true
  webhook-url: "https://discord.com/api/webhooks/..."
  log-commands: true
  log-punishments: true
  log-anticheat: true

---

🔐 Permissions

• crystalladmin.admin - Full access (default: op)
• crystalladmin.report - Send reports (default: true)
• crystalladmin.anticheat.alerts - Receive AC alerts (default: op)
• crystalladmin.bypass.mute - Bypass mute (default: op)
• crystalladmin.bypass.freeze - Bypass freeze (default: op)
• crystalladmin.bypass.anticheat - Bypass AC checks (default: op)

---

📝 Support & Contributing

• Issues/Bugs: GitHub Issues
• Feature Requests: Open an issue or discussion
• Discord: Join our server

---

📜 License

This project is licensed under MIT License - free to use, modify, and distribute.

---

🙏 Credits

Developed by l1stok
Special thanks to all testers!

---

🌟 If you like this plugin, please like it.