⚔️ Danger Log

Combat logging protection for Minecraft Paper 1.21+ servers

📖 Overview

Danger Log is a powerful combat logging protection plugin that prevents players from escaping PvP situations by disconnecting. When a player logs out during combat, a zombie NPC spawns in their place — if the zombie dies, so does the player!

✨ Features

🎯 Combat Timer System

Players within a configurable radius receive a combat timer in their action bar
Timer displays as 20/20 and stays at max while enemies are nearby
Timer counts down when players leave combat range
Logging out with an active timer = combat logging

🧟 Combat Log Protection

Mode	Description
ZOMBIE	Spawns a zombie NPC with the player's name. If killed, drops all loot.
INSTANT	Immediately kills the player upon combat logging.

🤝 Ally System

Team up with friends to avoid triggering each other's combat timers
Clickable invite system with expiration
Configurable max allies per player

💾 Persistence

Zombies survive server restarts
Player inventories are safely stored
All data saved to files

🚫 Combat Restrictions

Disable Tridents (Riptide) while in combat — no flying away!
Disable Elytras while in combat — stay and fight!
Disable/Cooldown Ender Pearls — configurable cooldown or full disable
Disable/Cooldown Firework Rockets — prevent elytra boosting

🎮 Smart Detection

Only affects Survival mode players
Creative, Spectator, and Adventure players are ignored
Bypass permission available for staff

📋 Commands

🔧 Admin Commands

Requires dangerlog.admin permission (default: OP)

Command	Description
`/dangerlog on`	Enable the plugin
`/dangerlog off`	Disable the plugin
`/dangerlog reload`	Reload configuration

👥 Ally Commands

Available to all players

Command	Description
`/ally invite <player>`	Send an ally request
`/ally accept [player]`	Accept a pending invite
`/ally remove <player>`	Remove an ally
`/ally list`	View your allies

🔑 Permissions

Permission	Description	Default
`dangerlog.admin`	Access admin commands	OP
`dangerlog.bypass`	Bypass combat log system	false

⚙️ Configuration

# ===========================================
#         DANGER LOG CONFIGURATION
# ===========================================

# Combat detection radius (in blocks)
radius: 50

# Combat timer duration (seconds)
timer-duration: 45

# ------ DEATH TYPE ------
# ZOMBIE = Spawns NPC zombie
# INSTANT = Kills player immediately
death-type: ZOMBIE

# ------ ZOMBIE SETTINGS ------
# How long before zombie auto-expires (-1 or 0 = never)
# Minimum: 10 seconds
zombie-log-timer-max: -1

# ------ ALLY SYSTEM ------
# Enable/disable allies
allow-allies: true

# Max allies per player (-1 or 0 = unlimited)
max-allies: 6

# Ally invite duration (seconds)
invite-duration: 120

# ------ COMBAT RESTRICTIONS ------
# Disable tridents (Riptide) while in combat
disable-tridents: true

# Trident cooldown in combat (seconds, 0 = no cooldown)
# Only applies if disable-tridents is false
trident-cooldown: 10

# Disable elytras while in combat
disable-elytras: true

# Disable ender pearls while in combat
disable-pearls: false

# Disable firework rockets while in combat
disable-fireworks: false

# Pearl cooldown in combat (seconds, 0 = no cooldown)
pearl-cooldown: 10

# Firework cooldown in combat (seconds, 0 = no cooldown)
firework-cooldown: 10

# ------ GENERAL ------
# Plugin enabled state
enabled: true

🎬 How It Works

1️⃣  Two players enter combat range (30 blocks)
         ↓
2️⃣  Both see combat timer: [20/20]
         ↓
3️⃣  Timer stays at max while in range
         ↓
4️⃣  Player leaves range → timer counts down
         ↓
5️⃣  Player logs out with active timer
         ↓
    ┌─────────────────────────────────────┐
    │  ⚠️ COMBAT LOG DETECTED!            │
    │  Zombie spawns at logout location   │
    │  Chat: "Player has logged out in    │
    │         combat."                    │
    └─────────────────────────────────────┘
         ↓
6️⃣  If zombie is killed → loot drops
         ↓
7️⃣  Player rejoins → DEATH SCREEN

🧟 Zombie NPC Details

Property	Value
Name	Player's name (bold red)
AI	Disabled
Burns in Sun	No
Health	Same as player at logout
Drops	Player's full inventory
Despawns	Never (unless configured)

📁 Data Files

File	Purpose
`config.yml`	Plugin configuration
`allies.yml`	Stored ally relationships
`zombies.yml`	Active combat log zombies

💡 Tips

For SMP servers: Set zombie-log-timer-max to -1 so zombies stay forever
For minigames: Use INSTANT death-type for immediate punishment
For teams: Enable allies with a reasonable max-allies limit
For staff: Give dangerlog.bypass permission to moderators
Anti-escape: Keep tridents and elytras disabled to prevent flying away
Pearl cooldown: Set pearl-cooldown to 10+ seconds to limit pearl spam

📞 Support

Having issues? Contact the developer!

Made with ❤️ by CrystalPT

Danger Log