Configuration
The configuration file for Nexal Combat Log. Located at plugins/Nexal Combat Log/config.yml.
config.yml
# ============================================
# Nexal Combat Log - Configuration
# ============================================
# Storage settings
storage:
# Storage type: json or sql
type: json
sql:
host: localhost
port: 3306
database: minecraft
username: root
password: ""
# ============================================
# Combat Tag Settings
# ============================================
combat:
# Duration of combat tag in seconds
duration: 15
# Enable PvE combat tagging (mobs attacking player)
pve-enabled: false
# Entities that trigger PvE combat (if pve-enabled is true)
pve-entities:
- ZOMBIE
- SKELETON
- CREEPER
- SPIDER
- CAVE_SPIDER
- ENDERMAN
- WITCH
- BLAZE
- WITHER_SKELETON
- PIGLIN_BRUTE
- VINDICATOR
- PILLAGER
- RAVAGER
- VEX
# Reset combat timer on each hit (true) or only extend if less than max (false)
reset-on-hit: true
# ============================================
# Combat Indicators
# ============================================
indicators:
# Boss bar countdown
boss-bar:
enabled: true
# Color: RED, BLUE, GREEN, YELLOW, PURPLE, PINK, WHITE
color: RED
# Style: SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20
style: SOLID
# Placeholders: %seconds% (time left), %attacker% (who or what hit the player last)
title: "<gradient:#C0392B:#E74C3C><bold>IN COMBAT</bold></gradient> <gray>-</gray> <white>%seconds%s remaining</white>"
# Action bar display
action-bar:
enabled: true
# Placeholders: %seconds%, %attacker%
message: "<gradient:#C0392B:#E74C3C><bold>!</bold></gradient> <gradient:#E74C3C:#EC7063>COMBAT</gradient> <gray>|</gray> <white>%seconds%s</white> <gray>|</gray> <gradient:#FF5252:#FF7070>Do not log out!</gradient>"
# Scoreboard indicator (shows sidebar scoreboard during combat)
scoreboard:
enabled: false
title: "<gradient:#C0392B:#E74C3C><bold>COMBAT</bold></gradient>"
# Placeholders in lines: %seconds%, %attacker%
lines:
- ""
- "<gray>Time remaining:</gray>"
- "<white>%seconds%s</white>"
- ""
- "<gradient:#FF5252:#FF7070>Do not log out!</gradient>"
# ============================================
# NPC Settings (Combat Log NPC)
# ============================================
npc:
# How long the NPC stays alive in seconds
duration: 10
# Reset timer when NPC is damaged
reset-on-damage: true
# Name shown above the NPC (%player% = player name)
name: "<red>%player%'s Logger</red>"
# NPC health settings
# If true, the NPC gets the player's current and maximum health.
# If false, it gets custom-health (which may be above 20).
use-player-health: true
custom-health: 20.0
# Hologram settings (native support, no external plugin required)
# Lines accept MiniMessage (<gradient>, <bold>) and legacy & codes
# Placeholders: %player%, %seconds%, %health%, %max_health%
hologram:
enabled: true
lines:
- "<gradient:#C0392B:#E74C3C><bold>%player%'s Combat Logger</bold></gradient>"
- "<gray>Time remaining:</gray> <white>%seconds%s</white>"
- "<gray>Health:</gray> <color:#E74C3C>%health%</color><gray>/</gray><color:#E74C3C>%max_health%</color>"
# Vertical offset above NPC
offset-y: 2.5
# Broadcast when NPC is spawned
broadcast-spawn: true
# Broadcast when NPC is killed
broadcast-kill: true
# ============================================
# Punishment Settings
# ============================================
punishment:
# What happens when a tagged player disconnects: NPC, INSTANT_DEATH, NONE
# NPC: Spawns an NPC holding their items (uses NPC settings above). If it is killed,
# the items drop; if not, the player gets them back when they rejoin.
# INSTANT_DEATH: Player dies immediately on disconnect and their items drop
# NONE: No punishment for disconnecting
mode: NPC
# The temp ban, fine and custom commands below come on top of the mode when the
# player is punished: on disconnect in INSTANT_DEATH mode, when the NPC is killed
# in NPC mode (the fine and commands then apply when the player rejoins).
# Nothing is applied in NONE mode or when the NPC survives.
# Temporary ban for combat logging (needs a plugin with a tempban command, such
# as EssentialsX or LiteBans)
temp-ban:
enabled: false
# Duration in seconds
duration: 300
# Command to execute (%player% = player name, %duration% = duration in seconds)
command: "tempban %player% %duration%s Combat logging"
# Economy fine for combat logging (requires Vault)
fine:
enabled: false
# Amount to deduct
amount: 1000.0
# Custom commands to execute when player combat logs
# Available placeholders: %player%
commands: []
# Example:
# commands:
# - "broadcast &c%player% combat logged!"
# ============================================
# Command Blocking
# ============================================
commands:
# Block mode: BLACKLIST or WHITELIST
# BLACKLIST: Block listed commands, allow all others
# WHITELIST: Allow only listed commands, block all others
# An entry matches the command name exactly, with or without a plugin prefix
# (/essentials:home counts as home), and a plugin command's aliases count too.
# End an entry with * to match every command starting with it (tp* = tp, tpa, tphere).
mode: BLACKLIST
# Commands to block (without /)
blacklist:
- home
- sethome
- spawn
- tp
- tpa
- tpahere
- tpaccept
- tpdeny
- warp
- warps
- back
- logout
- quit
- rtp
- wild
- randomtp
- randomteleport
- pay
- baltop
- ah
- auction
- shop
- market
- enderchest
- ec
- pv
- playervault
# Commands to allow (used when mode is WHITELIST)
whitelist:
- msg
- message
- tell
- whisper
- r
- reply
- helpop
# ============================================
# Safe Zone Settings (WorldGuard Integration)
# ============================================
safe-zones:
# Enable safe zone features (requires WorldGuard)
enabled: true
# Prevent entering safe zones during combat
prevent-entry: true
# Regions that are considered safe zones (PVP deny flag or custom)
# If empty, uses WorldGuard's PVP flag
custom-regions: []
# Example:
# custom-regions:
# - spawn
# - safezone
# - market
# ============================================
# Admin Exempt System
# ============================================
exempt:
# Warning interval in minutes (0 to disable)
# Sends a reminder to online admins about exempted players
warning-interval: 10
# ============================================
# Death Log Settings
# ============================================
death-log:
# Maximum death inventory snapshots to keep per player (0 = unlimited)
max-snapshots: 0
Configuration Options
Below is a reference of the main configuration sections:
storage
============================================ Nexal Combat Log - Configuration
Storage settings
combat
============================================ Combat Tag Settings
indicators
============================================ Combat Indicators
npc
============================================ NPC Settings (Combat Log NPC)
punishment
============================================ Punishment Settings
commands
Block mode: BLACKLIST or WHITELIST BLACKLIST: Block listed commands, allow all others WHITELIST: Allow only listed commands, block all others An entry matches the command name exactly, with or without a plugin prefix (/essentials:home counts as home), and a plugin command's aliases count too. End an entry with * to match every command starting with it (tp* = tp, tpa, tphere).
safe-zones
============================================ Safe Zone Settings (WorldGuard Integration)
exempt
Warning interval in minutes (0 to disable) Sends a reminder to online admins about exempted players