# --- Global PvP Settings ---
# Master switch for server-wide PvP.
# If set to false, no players can damage each other directly.
global_pvp_enabled: true
# --- Protections for when Global PvP is Disabled ---
pvp_protections:
# If true, prevents players from placing lava near other players when global PvP is off.
prevent_lava_placement_near_players: true
# The radius (in blocks) to check for nearby players when placing lava.
lava_check_radius: 3
# If true, prevents players from harming others with splash potions when global PvP is off.
prevent_harmful_splash_potions: true
# List of potion effects considered harmful and will be blocked.
# Effect names from: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/potion/PotionEffectType.html
harmful_potion_effects:
- HARM
- POISON
- SLOWNESS
- WEAKNESS
- WITHER
# --- Core Combat Settings ---
# Time in seconds that a player remains in combat after the last hit.
combat_duration_seconds: 10
# Show a countdown timer in the action bar while a player is in combat.
action_bar_timer: true
# If true, combat tags for both the victim and the attacker will be removed upon a player's death.
end_combat_on_death: true
# --- Custom Death Message ---
death_messages:
# If true, a custom message will be used when a player dies while in combat.
use_custom_when_in_combat: false
# --- Region Protections (Requires WorldGuard) ---
region_protections:
# Defines the method used to prevent players from entering safe zones while in combat.
# Available options:
# VISUAL_BORDER - (PERFORMANCE INTENSIVE) Shows a dynamic wall of fake blocks. Looks premium.
# PUSHBACK - Physically bounces the player back. Simpler and less resource-intensive. RECCOMENDED
# NONE - Disables this protection entirely.
entry_prevention_method: PUSHBACK
# --- Settings for the PUSHBACK method ---
# How strong the "bounce" effect is when a player is pushed back.
pushback_strength: 0.8
# --- Settings for the VISUAL_BORDER method ---
# How often (in server ticks, 20 ticks = 1 second) the plugin checks a player's position.
visualization_check_interval_ticks: 10
# The radius (in blocks) around the player in which region borders will be displayed.
# WARNING: High values can cause lag! Recommended: 10-15.
visualization_display_radius: 15
# The material of the visual wall.
visualization_wall_material: "RED_STAINED_GLASS"
# --- In-Combat Restrictions ---
combat_restrictions:
block_riptide: true
# This option is disabled by default because it can interfere with Mending.
damage_elytra_on_restrict: false
blocked_items_in_combat:
- ELYTRA
blocked_commands_in_combat:
- "home"
- "spawn"
- "tpa"
- "warp"
# --- Combat State Messages ---
enter_combat: "%prefix%&cYou have been attacked! You are in combat for %seconds% seconds."
exit_combat: "%prefix%&aYou are no longer in combat."
action_bar_combat_timer: "&cYou are in combat for &e%time%s"
# --- In-Combat Restriction Messages ---
combat_block_elytra: "%prefix%&cYou cannot use an elytra while in combat!"
combat_block_riptide: "%prefix%&cYou cannot use a Riptide trident while in combat!"
combat_block_firework_rocket: "%prefix%&cYou cannot use firework rockets to boost while in combat!"
combat_block_command: "%prefix%&cYou cannot use this command while in combat!"
ender_pearl_combat_cooldown_active: "%prefix%&cYou cannot use ender pearls while in combat! Cooldown will apply once combat ends."
# --- Post-Combat Cooldown Messages ---
elytra_cooldown_started: "%prefix%&cYour Elytra is disabled for %time% seconds because you left combat."
elytra_cooldown_active: "%prefix%&cYou cannot use your Elytra yet! Cooldown: &e%time%s"
# --- PvP & Region Protection Messages ---
pvp_is_disabled: "%prefix%&cYou cannot attack other players, PvP is currently disabled globally."
pvp_lava_blocked: "%prefix%&cYou cannot place lava near other players while global PvP is disabled."
pvp_potion_blocked: "%prefix%&cYou cannot use harmful splash potions on other players while global PvP is disabled."
cannot_enter_safe_zone: "%prefix%&cYou cannot enter a safe zone while in combat!"
# --- Punishment & Death Messages ---
combat_log_punishment: "%prefix%&c%player% combat logged! They were killed by the system."
# Placeholders: %victim%, %killer%
custom_combat_death_message: "&c%victim% &ewas slain by &c%killer% &ein the heat of battle!"
# --- Plugin & General Command Messages ---
plugin_enabled: "%prefix%&aVypnitoCombat has been enabled!"
plugin_disabled: "%prefix%&cVypnitoCombat has been disabled!"
no_permission: "%prefix%&cYou do not have permission to use this command."
plugin_reloaded: "%prefix%&aVypnitoCombat has been reloaded successfully!"
player_not_found: "%prefix%&cPlayer %player% is not online."
invalid_number: "%prefix%&cInvalid number provided for seconds."
command_unknown_subcommand: "&cUnknown subcommand. Use /vc help for a list of commands."
# --- /vc Command Messages ---
command_usage_main: "&eUsage: /vc <reload|help|status|tag|untag>"
command_help_header: "&8--- &6VypnitoCombat Help &8---"
command_help_reload: "&e/vc reload &7- Reloads the plugin configuration."
command_help_bypass_perm: "&evypnitocombat.bypass.combat &7- Bypass all combat rules."
command_help_footer: "&8-------------------"
command_usage_clv_status: "&eUsage: /vc status <player>"
command_usage_clv_tag: "eUsage: /vc tag <player> [seconds]"
command_usage_clv_untag: "&eUsage: /vc untag <player>"
status_in_combat: "%prefix%&e%player% &cis in combat for &e%time%s&c."
status_not_in_combat: "%prefix%&e%player% &ais not in combat."
player_tagged: "%prefix%&aYou have manually put &e%player% &ainto combat."
player_untagged: "%prefix%&aYou have manually removed &e%player% &afrom combat."
# --- /pvp Command Messages ---
pvp_globally_enabled: "%prefix%&aGlobal PvP has been enabled."
pvp_globally_disabled: "%prefix%&cGlobal PvP has been disabled."
command_usage_pvp: "&eUsage: /pvp global <on|off>"