CrystallAdmin
This plugin adds extensive capabilities for server administration.
7
Quick challenge
How far can you run before the mobs catch you?
Minecraft check
Confirm your run
Complete the quick check to get your code.
CrystallAdmin
🛡️ CrystallAdmin
Advanced administration toolkit for Minecraft servers with built-in anti-cheat, moderation tools, and monitoring systems.
---
✨ 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!
---
