Configuration

config.yml

# CombatSystem Plugin Configuration

# Time in seconds that players remain in combat after hitting someone with a sword, axe, or ranged weapon
combat-duration: 15

# Whether to lock containers during combat
# true = Players cannot open containers during combat (default behavior)
# false = Players can open containers during combat, but actions are still logged
lock-containers: true

# Plugin Information
plugin-info:
name: "CombatSystem"
version: "1.0.0"
description: "Prevents players from accessing containers during combat"
Configuration Options
Option Type Default Description

combat-duration Integer 15 Combat duration in seconds

lock-containers Boolean true Whether to block container access during combat

Usage
For Players
Entering Combat:

• Hit another player with a sword, axe, bow, or crossbow
• Both players will see: "You are now in combat!"
• Combat timer starts (default: 15 seconds)

During Combat:

• Cannot access storage containers (if lock-containers: true)
• Attempting to access containers shows: "You're In Combat. You Can't Restock for X seconds"
• Taking or dealing damage resets the combat timer

Exiting Combat:

• Wait for the combat timer to expire without taking/dealing damage
• Combat ends automatically upon death
• Players see: "You are no longer in combat!"

For Administrators
Monitoring:

• All container access attempts are logged to console
• Logs include player name, container type, and remaining combat time
• Example: Player Steve tried to interact with container (CHEST) while in combat (12 seconds remaining)

Enforcement Modes:

1. Strict Mode (lock-containers: true):
   • Blocks all container access during combat
   • Shows denial messages to players
   • Logs all attempts
2. Monitor Mode (lock-containers: false):
   • Allows container access during combat
   • Logs all attempts for analysis
   • No denial messages to players

Combat Mechanics
Weapons That Trigger Combat
Melee Weapons:

• Wooden/Stone/Iron/Gold/Diamond/Netherite Swords

• Wooden/Stone/Iron/Gold/Diamond/Netherite Axe

• Mace/Tridents

Ranged Weapons:

• Bows shooting arrows
• Crossbows shooting arrows
• Crossbows shooting firework rockets

Combat Duration

• Default: 15 seconds (configurable)
• Timer resets on each hit taken or dealt
• Players must avoid combat for the full duration to exit combat mode
• Death immediately removes combat status