Configurations

Version v4.0

config.yml

database:
  # Database type: SQLITE, MYSQL
  type: SQLITE
  # MySQL connection settings
  mysql:
    host: localhost
    port: 3306
    database: minecraft
    username: root
    password: password
  cross_server:
    # Enable cross-server functionality
    enabled: false
    # Unique server ID (must be different for each server)
    server_id: server1
    # Server display name (with color codes)
    server_name: '&#ea435cS&#e85965e&#e66f6er&#e58577v&#e39b80e&#e1b189r'
    # Redis connection settings
    redis:
      host: localhost
      port: 6379
      user: ''
      password: ''
      database: 0
      timeout: 2000
      client_name: SpacePvP
location_settings:
  # World for player spawn
  world: world
  # Radius from center (0,0) in blocks
  radius: 1000
  # Maximum number of attempts to find a safe location
  max_attempts: 10
  # Whether to check WorldGuard regions
  check_world_guard_regions: false
  # Check Towny regions (requires Towny)
  check_towny_regions: false
  # Blocks that cannot be used for spawning (material names)
  ignored_blocks:
  - LAVA
  - WATER
  - CACTUS
  # Biomes where players cannot be teleported
  # Use biome names from: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/block/Biome.html
  # Example: DESERT, ICE_SPIKES, BADLANDS
  ignored_biomes:
  - BADLANDS
  - ICE_SPIKES
queue_settings:
  # Close GUI when joining/leaving queue?
  close_on_queue_action: true
  # Enable automatic queue timeout
  # Players will be removed from queue after specified time
  queue_timeout_enabled: true
  # Time in seconds until automatic deletion from the queue (if enabled)
  queue_timeout: 600
  # Enable random location queue
  enable_random_queue: true
  # Enable arena queue
  enable_arena_queue: true
  # Type of queue interaction:
  # ARMOR_LMB_ANY_RMB - LMB: join with armor | RMB: join with any equipment
  # ANY_LMB_ARMOR_RMB - LMB: join with any equipment | RMB: join with armor
  # ARMOR_LMB_ARMOR_RMB - LMB: join with armor | RMB: join with armor
  # ANY_LMB_ANY_RMB - LMB: join with any equipment | RMB: join with any equipment

  # Conditions:
  # - 'With armor' = full set of diamond/netherite armor
  # - 'Any equipment' = no armor check
  interaction_type: ARMOR_LMB_ANY_RMB
  # Allowed armor materials (without suffixes)
  # Example: DIAMOND - checks DIAMOND_HELMET, DIAMOND_CHESTPLATE, etc.
  # Add your own materials (e.g., GOLD, IRON)
  armor_materials:
  - DIAMOND
  - NETHERITE
general_settings:
  # Enable the reward system
  enable_rewards: true
  # Statistics autosave interval in seconds
  auto_save_interval: 600
  # Show autosave messages in the console
  auto_save_console_messages: true
  # Enable playtime requirement for PvP commands
  # Players must have specified playtime to use PvP features
  enable_playtime_requirement: false
  # Required playtime in seconds to use PvP commands
  required_playtime: 3600
  # Time display format: SHORT, LONG, CUSTOM
  time_format_type: SHORT
  # Custom time format (use {days}, {hours}, {minutes}, {seconds})
  custom_time_format: '{days}d {hours}h {minutes}m {seconds}s'
  # Format settings for the LONG option
  long_time_format:
    # Label for days
    days: d
    # Label for hours
    hours: h
    # Label for minutes
    minutes: m
    # Label for seconds
    seconds: s
  # Enable inventory preview when clicking on players in PvP list
  enable_inventory_preview: true
  # Enable teleport to player's server from PvP list
  enable_server_teleport: true
  # Click type to accept a PvP challenge from the list
  # Available options:
  # LEFT_CLICK - Left click
  # RIGHT_CLICK - Right click
  # SHIFT_LEFT_CLICK - Shift + Left click
  # SHIFT_RIGHT_CLICK - Shift + Right click
  # LEFT_CLICK_AND_SHIFT_LEFT_CLICK - Any left click (normal or shift)
  # RIGHT_CLICK_AND_SHIFT_RIGHT_CLICK - Any right click (normal or shift)
  # ANY_CLICK - Any type of click
  pvp_accept_click_type: LEFT_CLICK
  # Type of click to preview player's inventory in PvP list
  # Available options:
  # LEFT_CLICK - Regular left click
  # RIGHT_CLICK - Regular right click
  # SHIFT_LEFT_CLICK - Shift + Left Click combination
  # SHIFT_RIGHT_CLICK - Shift + Right Click combination
  # LEFT_CLICK_AND_SHIFT_LEFT_CLICK - Any left click
  # RIGHT_CLICK_AND_SHIFT_RIGHT_CLICK - Any right click
  # ANY_CLICK - Any type of click
  inventory_preview_click_type: SHIFT_RIGHT_CLICK
  # Click type to teleport to player's server
  # Available options:
  # LEFT_CLICK - Left click
  # RIGHT_CLICK - Right click
  # SHIFT_LEFT_CLICK - Shift + Left click
  # SHIFT_RIGHT_CLICK - Shift + Right click
  # LEFT_CLICK_AND_SHIFT_LEFT_CLICK - Any left click
  # RIGHT_CLICK_AND_SHIFT_RIGHT_CLICK - Any right click
  # ANY_CLICK - Any type of click
  server_teleport_click_type: RIGHT_CLICK
  teleport_settings:
    # Disable flight mode on teleport
    # Works with EssentialsX and CMI
    disable_fly: true
    # Disable god mode on teleport
    disable_god: true
    # Disable vanish on teleport
    disable_vanish: true
    # Force player into Survival mode
    # Even if they were in Creative/Spectator
    force_gamemode: true
pvp_settings:
  # Enable item restrictions for random location battles
  enable_item_restrictions: false
  # List of restricted items. To add a custom item from customitems.yml, use customitems:ID under which it is saved.
  restricted_items:
  - material: BEDROCK
    name: '&fBedrock'
  # Whether to give a kit at the start of a fight
  enable_kit: false
  # Name of the kit to be used
  kit_name: default
  # Cancel fight if players take damage during countdown
  cancel_on_damage_during_countdown: true
  # List of damage causes that WON'T cancel the fight
  # Available types:
  # - Standard damage causes: FALL, ENTITY_ATTACK, PROJECTILE etc.
  # - Special keywords:
  #   SELF - damage caused by player to themselves
  #   MOB - damage from non-player entities (mobs, animals etc.)
  #   PLAYER_DAMAGE_WORLDGUARD - damage from players in WorldGuard regions
  #   PLAYER_DAMAGE_TOWNY - damage from players in Towny towns
  # Full list: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/entity/EntityDamageEvent.DamageCause.html
  damage_whitelist:
  - FALL
  - SELF
  - MOB
  # Enable join queue messages
  enable_join_messages: true
  # Enable victory messages for random location battles
  enable_victory_messages: true
  cross_server:
    # Broadcast join messages to all servers?
    broadcast_join: false
    # Broadcast victory messages to all servers?
    broadcast_victory: false
  # Time (in seconds) after the start of the fight during which a kill counts as a victory
  # If the kill happens later than this, no message will be sent
  victory_time_frame: 300
  # Prevent stats updates when players have the same IP address
  # true - block stats changes for same IP players
  # false - allow stats changes regardless of IP
  enable_ip_protection: true
  # Countdown duration before the battle starts (in seconds, -1 to disable)
  countdown_seconds: 5
  # Countdown display type:
  # TITLE - Title message
  # ACTION_BAR - Action bar
  # BOSS_BAR - Boss bar
  countdown_display_type: TITLE
  boss_bar_color: RED
  boss_bar_style: SOLID
  # Maximum distance between player spawns (in blocks)
  max_spawn_distance: 100
  # Countdown number colors (HEX format)
  countdown_colors:
    5: '&#a80000'
    4: '&#d20f0f'
    3: '&#df5911'
    2: '&#fdea1c'
    1: '&#97fd1c'
  # Countdown sound settings
  # Format: 'SOUND:VOLUME' (e.g., 'BLOCK_NOTE_BLOCK_HAT:1.0')
  # Available sounds: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
  countdown_sounds:
    5: BLOCK_NOTE_BLOCK_HAT:1.0
    4: BLOCK_NOTE_BLOCK_HAT:1.0
    3: BLOCK_NOTE_BLOCK_HAT:1.0
    2: BLOCK_NOTE_BLOCK_HAT:1.0
    1: BLOCK_NOTE_BLOCK_HAT:1.0
  # Sound played at the end of the countdown
  countdown_finish_sound: ENTITY_PLAYER_LEVELUP:1.0
  # Enable battle effects for random location fights
  enable_effects: true
  # Effects applied to players at the start of battle
  # type - effect type (e.g., GLOWING, JUMP_BOOST)
  # duration - duration in seconds
  # amplifier - effect level (0 = level I)
  effects:
  - type: GLOWING
    duration: 10
    amplifier: 0
pvp_arena_settings:
  # Enable item restrictions for arena battles
  enable_item_restrictions: false
  # List of restricted items. To add a custom item from customitems.yml, use customitems:ID under which it is saved.
  restricted_items:
  - material: BEDROCK
    name: '&fBedrock'
  # Whether to give a kit at the start of a fight
  enable_kit: false
  # Name of the kit to be used
  kit_name: default
  # Clear players' inventory after an arena fight
  # Works only if enable_kit = true
  clear_inventory_after_battle: false
  # Determines whether a player will automatically die if they leave the server during arena combat
  auto_kill_on_quit: true
  # Block commands execution while in arena combat
  block_commands_in_arena: true
  # List of commands that are allowed even during arena combat
  allowed_commands:
  - tell
  - msg
  # Time in seconds until the arena auto-closes when inactive
  auto_regen_timeout: 300
  # Teleport delay when arena status is OPENING (seconds)
  regen_teleport_delay: 30
  # Time format type for regeneration countdown: SHORT, LONG, CUSTOM
  regen_time_format: LONG
  # Custom time format (use {days}, {hours}, {minutes}, {seconds})
  custom_regen_time_format: '{days}d {hours}h {minutes}m {seconds}s'
  # Cancel fight if players take damage during countdown
  cancel_on_damage_during_countdown: true
  # List of damage causes that WON'T cancel the fight
  # Available types:
  # - Standard damage causes: FALL, ENTITY_ATTACK, PROJECTILE etc.
  # - Special keywords:
  #   SELF - damage caused by player to themselves
  #   MOB - damage from non-player entities (mobs, animals etc.)
  #   PLAYER_DAMAGE_WORLDGUARD - damage from players in WorldGuard regions
  #   PLAYER_DAMAGE_TOWNY - damage from players in Towny towns
  # Full list: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/entity/EntityDamageEvent.DamageCause.html
  damage_whitelist:
  - FALL
  - SELF
  - MOB
  # Enable join queue messages
  enable_join_messages: true
  # Enable victory messages for arena battles
  enable_victory_messages: true
  cross_server:
    # Broadcast join messages to all servers?
    broadcast_join: false
    # Broadcast victory messages to all servers?
    broadcast_victory: false
  # Enable automatic arena regeneration via WorldEdit
  enable_regeneration: true
  # Prevent stats updates when players have the same IP address
  # true - block stats changes for same IP players
  # false - allow stats changes regardless of IP
  enable_ip_protection: true
  # Countdown duration before the battle starts (in seconds, -1 to disable)
  countdown_seconds: 5
  # TITLE - Title message
  # ACTION_BAR - Action bar
  # BOSS_BAR - Boss bar
  # Countdown display type (can be combined using commas):
  # Example: TITLE,ACTION_BAR
  countdown_display_type: TITLE
  boss_bar_color: RED
  boss_bar_style: SOLID
  # Countdown number colors (HEX format)
  countdown_colors:
    5: '&#a80000'
    4: '&#d20f0f'
    3: '&#df5911'
    2: '&#fdea1c'
    1: '&#97fd1c'
  # Countdown sound settings
  # Format: 'SOUND:VOLUME' (e.g., 'BLOCK_NOTE_BLOCK_HAT:1.0')
  # Available sounds: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
  countdown_sounds:
    5: BLOCK_NOTE_BLOCK_HAT:1.0
    4: BLOCK_NOTE_BLOCK_HAT:1.0
    3: BLOCK_NOTE_BLOCK_HAT:1.0
    2: BLOCK_NOTE_BLOCK_HAT:1.0
    1: BLOCK_NOTE_BLOCK_HAT:1.0
  # Sound played at the end of the countdown
  countdown_finish_sound: ENTITY_PLAYER_LEVELUP:1.0
  # Enable battle effects for arena fights
  enable_effects: true
  # Effects applied to players at the start of battle
  # type - effect type (e.g., GLOWING, JUMP_BOOST)
  # duration - duration in seconds
  # amplifier - effect level (0 = level I)
  effects:
  - type: GLOWING
    duration: 10
    amplifier: 0
cabins:
  # Enable item restrictions for cabin battles
  enable_item_restrictions: false
  # List of restricted items. To add a custom item from customitems.yml, use customitems:ID under which it is saved.
  restricted_items:
  - material: BEDROCK
    name: '&fBedrock'
  # Whether to give a kit at the start of a cabin fight
  enable_kit: false
  # Name of the kit to be used in cabin battles
  kit_name: default
  # Clear players' inventory after a cabin fight
  # Works only if enable_kit = true
  clear_inventory_after_battle: false
  # Enable automatic regeneration (item clearing) after battles
  enable_regeneration: false
  # Automatically kill players who quit during cabin combat
  auto_kill_on_quit: true
  # Enable points and stats system for cabin battles
  # Requires general points system to be enabled
  enable_stats_system: true
  # Prevent players with same IP from getting stats/points
  enable_ip_protection: true
  # Enable victory messages for cabin battles
  enable_victory_messages: true
  cross_server:
    # Broadcast victory messages to all servers?
    broadcast_victory: false
  # Enable playtime requirement for entering the cabin
  # Players must have a specified playtime to enter the cabin.
  enable_playtime_requirement: true
  # Required playtime in seconds to enter the cabin.
  required_playtime: 3600
  # Maximum duration of a fight (in seconds)
  battle_duration: 300
  # Time before the cabin opens after the player's death (in seconds)
  opening_duration: 25
  # Blocked commands that do not affect fighting players in the cabin from the side of other players.
  blocked_commands:
  - cmi heal
  - cmi feed
  - brush
  - heal
  - feed
  # Time display format:
  # SHORT - 00:00:00, LONG - 1d 2h 3m, CUSTOM - custom format
  time_format_type: LONG
  # Custom time format (use {days}, {hours}, {minutes}, {seconds})
  custom_time_format: '{days}d {hours}h {minutes}m {seconds}s'
  checks:
    # Allow players in Gamemode 1 (Creative) to join cabins
    allow_gamemode_1: false
    # Allow players in Gamemode 3 (Spectator) to join cabins
    allow_gamemode_3: false
    # Allow players in God mode to join cabins
    allow_god_mode: false
    # Allow vanished players to join cabins
    allow_vanished: false
    # Allow flying players to join cabins
    allow_flying: false
  # Enable battle effects for cabin fights
  enable_effects: true
  # Effects applied to players at cabin fight start
  # type - effect type (e.g., GLOWING, JUMP_BOOST)
  # duration - duration in seconds
  # amplifier - effect level (0 = level I)
  effects:
  - type: GLOWING
    duration: 10
    amplifier: 0
lobby_settings:
  # Lobby location coordinates
  x: 0.0
  y: 64.0
  z: 0.0
  # Lobby world name
  world: world
  # Lobby rotation angles
  yaw: 0.0
  pitch: 0.0
points_settings:
  # Enable the points system for PvP kills
  enable_points_system: true
  # Prevent players with same IP from getting points
  enable_ip_protection: true
  # Points awarded per kill
  points_per_kill: 4
  # Enable win streak bonus points system
  enable_win_streak_bonus: true
  # Win streak bonus configuration
  # Default tiers (can be modified/removed):
  #   bronze: 3 wins → +1 point/kill
  #   silver: 5 wins → +2 points/kill
  #   gold: 10 wins → +5 points/kill
  # Customization options:
  #   1. Remove existing tiers: Simply delete the tier block
  #   2. Modify values: Change required_streak/bonus_points numbers
  #   3. Add new tiers: Copy-paste tier block with unique name
  # Example custom config:
  #   win_streak_bonuses:
  #     bronze:
  #       required_streak: 2 # Modified value
  #       bonus_points: 1
  #     platinum: # New tier
  #       required_streak: 15
  #       bonus_points: 10
  #     # silver tier removed
  #     gold:
  #       required_streak: 8 # Modified value
  #       bonus_points: 4
  win_streak_bonuses:
    bronze:
      required_streak: 3
      bonus_points: 1
    silver:
      required_streak: 5
      bonus_points: 2
    gold:
      required_streak: 10
      bonus_points: 5
queue_checks:
  # Allow players in Gamemode 1 (Creative) to join the queue
  allow_gamemode_1: false
  # Allow players in Gamemode 3 (Spectator) to join the queue
  allow_gamemode_3: false
  # Allow players in God mode to join the queue
  allow_god_mode: false
  # Allow vanished players to join the queue
  allow_vanished: false

menu.yml

messages.yml

rewards.yml

webhook.yml

sounds.yml

PreviousLinksNextSetup Cross server

Last updated