HeavenBans

HeavenBans

Professional, high-performance moderation suite for Paper & Spigot servers.

---

⚡ What is HeavenBans?

HeavenBans is a streamlined, authoritative punishment management plugin designed for administrators who prioritize server stability and clean community standards. Built for modern Minecraft environments, HeavenBans ensures that every disciplinary action is executed with precision, keeping your server's performance (TPS) as its top priority.

Whether you are managing a private SMP or a growing public network, HeavenBans provides the professional toolkit necessary to maintain order and security.

---

🛡️ Core Functionality

Punishment Types

• Ban — Restrict player access to the server permanently.
• Mute — Silences a player's ability to communicate in global and local chat.
• Kick — Instantly removes a player from the current session.
• Warn — Logs a formal infraction against a player's record for future reference.
• Mercy (Unban/Unmute) — Revokes active punishments and restores player privileges.

Administrative Tools

• History Tracking — View a player's complete warning and punishment log with /warnlist.
• Active Checks — Monitor currently exiled players via the /banlist command.
• Management Hub — Use the /hb command for core administrative tasks and system reloads.

---

📋 Command Registry & Permissions

Command	Permission	Function
/ban <player> [reason]	heavenbans.ban	Permanently restricts server access.
/unban <player>	heavenbans.mercy	Grants mercy and revokes a ban.
/mute <player> [reason]	heavenbans.mute	Disables a player's chat privileges.
/unmute <player>	heavenbans.mercy	Restores a player's voice.
/warn <player> [reason]	heavenbans.warn	Issues a formal warning.
/unwarn <player>	heavenbans.warn	Removes a specific warning mark.
/kick <player> [reason]	heavenbans.admin	Forces a player to disconnect.
/hb reload	heavenbans.admin	Hot-reload the plugin configuration.

---

🔑 Hierarchical Permissions

HeavenBans utilizes a structured permission system for easy staff management:

• heavenbans.admin — Full administrative access and plugin control.
• heavenbans.ban — Authority to exile players.
• heavenbans.mute — Authority to silence players.
• heavenbans.warn — Authority to manage player warnings.
• heavenbans.mercy — Ability to revoke punishments.
• heavenbans.list — Permission to view punishment and warning logs.

---

⚙️ Technical Requirements

• Server: Paper, Spigot, or Purpur (1.20+)
• Java: 17 or higher
• Dependencies: None. This is a standalone, lightweight solution.

---

🚀 Why Choose HeavenBans?

• Performance-First: Optimized code designed to prevent main-thread lag during administrative actions.
• Clean Integration: Works seamlessly with standard permission managers like LuckPerms.
• Professional Identity: Provides a serious, standardized atmosphere for your moderation team.
• Minimalist Design: No unnecessary bloat—only the essential tools you need to manage your community effectively.

---

⚖️ License

This software is published under All Rights Reserved. Unauthorized distribution, modification, or commercial use of the compiled binary or source code is prohibited without explicit written consent from AngelClicker.

Developed by AngelClicker