CrystallAdmin

🛡️ CrystallAdmin

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

Modrinth Downloads

Version

Minecraft

---

✨ Features

🔨 Moderation System

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

🕵️ Anti-Cheat (Lightweight)

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

👤 Player Management

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

📊 Server Tools

- Broadcast System - TPS, RAM, uptime, player count - Broadcast System - Auto-cleanup with configurable warnings and filters - Broadcast System - Toggle mode or quick prefix `#message` - Broadcast System - Send messages to players without revealing sender - Broadcast System - Server-wide announcements with formatting

🌍 Localization

- Switch in Config - English and Russian included - Switch in Config - Add your own language via `messages_<lang>.yml` - Switch in Config - Change `general.language: en` or `ru`

🔗 Integrations

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

---

📥 Installation

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

Requirements

- Java 21 (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

```yaml 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

```yaml general: language: ru # or 'en' ```

Discord Integration

```yaml 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

- Discord: Discord: - Discord: Open an issue or discussion - Discord: %%MD1%%

---

📜 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.