RavenAdminSystem

Raven Admin System is a powerful, ready-to-use moderation tool for Minecraft servers running on Paper/Purpur cores. You don't need to spend hours configuring it, install dozens of additional plugins, or figure out complex configurations. Everything works immediately after installation.

The plugin includes:

• Question/Answer system for player support
• Player reporting system
• Complete punishment system: mute, kick, warnings, ban (temporary and permanent), IP-ban
• Jail with automatic movement control
• Admin chat
• Rank system (Helper → Moderator → Admin → Senior Admin)
• Vanish mode
• Player freeze
• Panic mode — mass freeze of violators in radius
• God mode
• And much more

---

🔥 Why is Raven Admin System?

Problem	Solution
Need to install 5-10 plugins	All-in-one — one plugin replaces an entire set
Hours of config tweaking	Ready to use — all default values are optimal
Complex permissions	Ready-made permission system — 5 ranks with pre-configured permissions
Data loss on reload	Auto-save — all punishments persist in YAML
Manual permission assignment	Rank promotion via command — /agiverank
Hard to track punishment history	Full punishment log — /history

---

⚙️ Features

👤 For players

• Ask helpers questions — /ask <question>
• Report violators — /report <player> <reason>

🛡️ For Helpers

• Answer questions — /ans <player> <answer>
• View question list — /ask list
• Use admin chat — /ac <message>
• View player punishment history — /history <player>

🔨 For Moderators

• Mute, kick, jail, vanish, teleportation
• View muted and jailed players lists
• Private messages, chat clear, spectate
• Work with reports — /reports

⚡ For Admins

• Warnings with auto-ban after 3 violations
• Ban (temporary/permanent), unban, ban list
• View inventory and ender chest
• Player teleportation, freeze, heal, set on fire
• Panic — freeze all players in radius

👑 For Senior Admins

• Assign helpers and promote ranks
• Admin warnings (7 days, 3 = ban)
• IP-ban, inventory clear, give items
• God mode, mass teleportation
• Complete player permission reset

---

📋 Commands

🔹 Common commands (visible to all)

Command	Description
/ask <question>	Ask a question to helpers
/report <player> <reason>	Report a player

🔹 Admin Chat

Command	Description
/ac <message>	Send a message to admin chat

🔹 Helper commands

Command	Description
/ahelp	Show all available commands
/ask list	List of questions (Helper+ only)
/ans <player> <answer>	Answer a question
/history [player]	Punishment history

🔹 Moderator commands

Command	Description
/mute <player> <minutes> [reason]	Mute a player
/unmute <player>	Unmute a player
/mutelist	List of muted players
/kick <player> [reason]	Kick a player
/tpto <player>	Teleport to a player
/vanish	Become invisible
/feed [player]	Feed a player
/jail <player> <minutes> <reason>	Jail a player
/unjail <player>	Unjail a player
/jaillist	List of jailed players
/pm <player> <message>	Private message
/clearchat	Clear the chat
/spec <player>	Spectate a player
/reports	List of reports

🔹 Admin commands

Command	Description
/warn <player> <days> <reason>	Issue a warning
/unwarn <player> <number>	Remove a warning
/warnlist	List of warnings
/ban <player> <days> <reason>	Ban a player (-1 = permanent)
/unban <player>	Unban a player
/banlist	List of banned players
/inv <player>	View inventory
/ec <player>	View ender chest
/tphere <player>	Teleport player to you
/tpp <player1> <player2>	Teleport player to player
/spawn [player]	Send to spawn
/freeze <player>	Freeze/unfreeze a player
/kill <player>	Kill a player
/heal [player]	Heal a player
/panic [radius]	Freeze all players in radius
/burn <player> <seconds>	Set a player on fire
/ext [player]	Extinguish a player

🔹 Senior Admin commands

Command	Description
/jailpoint	Set jail location
/sethelper <player>	Assign a helper
/agiverank <player>	Promote a player's rank
/awarn <player> <reason>	Issue an admin warning
/aunwarn <player> <number>	Remove an admin warning
/banip <player> <reason>	Ban IP address permanently
/unbanip <ip>	Unban IP address
/clear <player>	Clear inventory
/give <player> <item> <amount>	Give an item
/god	Toggle god mode
/tphereall	Teleport all players to you
/unadmin <player>	Reset all admin permissions
/admin reload	Reload configuration

---

🔐 Permissions

Basic permissions

Permission	Description	Default
adminsystem.use	Ask questions and send reports	All players

Staff permissions

Permission	Rank
adminsystem.helper	Helper
adminsystem.moderator	Moderator
adminsystem.admin	Admin
adminsystem.senior	Senior Admin

Important: All permissions are automatically assigned through the rank system. You don't need to manually configure them!

---

⭐ Advantages

✅ Ready "out of the box"

• Install → start → it works
• All settings are already optimal
• No need to spend hours tweaking configs

✅ All-in-one plugin

• Replaces 5-10 separate plugins
• No conflicts between modules
• Unified permission and command system

✅ Simple rank system

• Only 5 ranks
• Single command promotion — /agiverank
• Permissions assigned automatically

✅ Auto-save

• All punishments persist in YAML files
• Nothing is lost on server restart
• Automatic cleanup of expired punishments

✅ Bilingual support

• Full English language support
• Easy to switch to Other
• All messages are customizable

✅ Security

• Protection against muting/kicking/jailing staff members
• IP-ban for serious violators
• Complete punishment history

✅ Performance

• Asynchronous operations
• Optimized question and report queues
• Minimal server load

---

🎯 Who is this plugin for?

• Server owners — get a ready-made moderation system
• Admins — all tools in one place
• Moderators — clear commands and logic
• Players — quick help and protection from violators

---

📥 Installation

1. Download RavenAdminSystem.jar
2. Place it in your server's plugins folder
3. Restart your server
4. Done! The plugin is working.

Supported cores: Paper, Purpur, Spigot (versions 1.20+)

---

Raven Admin System — your reliable server management assistant! 🚀