DeathBan

DeathBan

A lightweight and simple plugin that bans players when they die. Perfect for hardcore survival servers!

Got ideas or suggestions? Join our Discord!

---

✨ Features

• Simple & Lightweight - Minimal resource usage
• Folia Support - Works on modern Folia servers
• PvP Mode - Ban only when killed by other players
• Colorful Ban Messages - Support for Adventure API with colors and formatting
• Flexible Timing - Customizable ban delay and duration
• Spectator Mode - Optional spectator mode after death
• IP Banning - Choose between player or IP bans

---

📋 Configuration

settings:
  banreason: "<bold><red>Game Over!</red></bold>\n\n<gray>You were banned for dying in combat.</gray>"
  ban-delay: 3                # Seconds after death until ban
  spectator-after-death: true # Enable spectator mode after death
  ban-time: 30                # Ban duration in minutes (0 = permanent)
  ban-ip: false               # Ban IP address instead of player name
  ignore-permission: false    # Ignore deathban.immune permission
  player-kill-only: false     # Only ban when killed by other players
  debug: false                # Enable debug logging

Color & Format Support

The banreason field supports Adventure API MiniMessage formatting:

Colors: <red>, <blue>, <green>, <yellow>, <aqua>, <light_purple>, <gold>, <gray>

Formatting: <bold>, <italic>, <underlined>, <strikethrough>

Example:

banreason: "<bold><red>BANNED!</red></bold>\n<yellow>Reason: <gray>Died in combat</gray></yellow>"

---

🔑 Permissions

---

📝 Changelog

Version 1.3.1

• Colored Ban Messages on Rejoin
• Custom PlayerLoginEvent Handler for formatted ban messages
• Improved ban message storage and display

Version 1.3.0

• Folia Support
• Player-Kill-Only Mode
• Better Ban Messages (Adventure API)
• Debug Mode
• Ban Timing Fixed
• Safer Teleportation

---

🚀 Installation

1. Download the latest DeathBan.jar
2. Place it in your plugins folder
3. Restart your server
4. Configure plugins/DeathBan/config.yml to your needs

Enjoy! 💀