Configuration

The configuration file for Nexal Duels. Located at plugins/Nexal Duels/config.yml.

config.yml

# =========================================
#       Nexal Duels Configuration
# =========================================

# Storage settings
storage:
  # Storage type: "json" or "sql"
  type: "json"

  # SQL settings (only used if type is "sql")
  sql:
    host: "localhost"
    port: 3306
    database: "minecraft"
    username: "root"
    password: ""

# Match history retention. Old casual and ranked match records are deleted at startup and after
# every finished duel. Player stats (wins, losses, streaks, ranked LP and rank) are kept either way.
# Both 0 by default: every match is kept.
history:
  # Delete match records older than this many days (0 = keep forever)
  max-age-days: 0

  # Keep only the newest this many casual matches, and as many ranked matches (0 = unlimited)
  max-matches: 0

# Duel settings
duel:
  # Countdown duration in seconds before fight starts
  countdown: 5

  # Grace period in seconds after duel ends before teleporting back
  ending-duration: 2

  # Request timeout in seconds
  request-timeout: 30

  # Maximum fight duration in seconds (0 = no limit). When it runs out the duel is a draw and bets are refunded
  max-duration: 300

  # Allow block breaking during duels
  allow-block-break: false

  # Allow block placing during duels (placed blocks are cleaned up with the arena)
  allow-block-place: true

  # Allow item dropping during duels
  allow-item-drop: false

  # Enable hunger during duels
  enable-hunger: false

  # Command blocking during duels (players can only use /duel and /duels)
  block-commands: true
  command-whitelist:
    - "msg"
    - "r"
    - "tell"

# Queue settings
queue:
  # Check interval in ticks (40 = 2 seconds)
  match-interval: 40

# Betting settings
betting:
  # Enable betting
  enabled: true

  # Minimum bet amount
  min-bet: 10.0

  # Maximum bet amount (0 = no limit)
  max-bet: 10000.0

  # Tax percentage on winnings (0.0 - 100.0)
  tax-percent: 5.0

# Spectator settings
spectator:
  # Allow spectating
  enabled: true

# Leaderboard hologram (top players by wins)
hologram:
  # Show the hologram. Place it with /duels admin hologram set; the location is stored below
  # as "location" (world, x, y, z) and removed with /duels admin hologram remove
  enabled: true

  # Refresh interval in seconds
  refresh-interval: 30

  # Number of entries to show
  entries: 10

# Fireworks on win
fireworks:
  enabled: true
  count: 3

# Ranked system settings
ranked:
  # Enable the ranked system
  enabled: true

  # Starting MMR for new players
  starting-mmr: 1000

  # Lowest MMR a player can drop to
  min-mmr: 100

  # Number of placement games required before receiving a rank
  placement-games: 5

  # Placement games move MMR this many times faster than normal games, so the tier a player is
  # placed into reflects their placement results
  placement-multiplier: 2.0

  # Number of demotion shield games after a promotion
  demotion-shield-games: 3

  # LP (League Points) per win or loss. The base amount is scaled by how likely the result was,
  # then kept between min-lp-change and max-lp-change
  base-lp: 20
  min-lp-change: 10
  max-lp-change: 35

  # LP needed to move up one division (e.g. Gold III to Gold II)
  lp-per-division: 100

  # LP a player keeps after being demoted a division
  demotion-lp: 75

  # How fast the hidden MMR moves (Elo K-factor): k-new for a player's first
  # new-player-games ranked matches, k-medium until medium-player-games, k-veteran after
  k-factor:
    new-player-games: 10
    medium-player-games: 30
    k-new: 40
    k-medium: 30
    k-veteran: 20

  # Rank tiers, lowest to highest. After placements a player lands in the tier whose MMR range
  # holds their MMR, at its lowest division. LP then moves them through the divisions (IV to I)
  # and on to the next tier.
  #   display-name: the name shown in chat, menus and placeholders
  #   color:        a color code in front of the name
  #   divisions:    divisions in the tier (0 = none: LP has no cap, like Master)
  #   min-mmr / max-mmr: the MMR range used for placement
  # Challenger cannot be reached by MMR or LP: it goes to the top Master players (see top-tier).
  # Edit these in-game with /duels admin ranked, Rank Tiers.
  tiers:
    iron:
      display-name: "Iron"
      color: "&8"
      divisions: 4
      min-mmr: 0
      max-mmr: 799
    bronze:
      display-name: "Bronze"
      color: "&6"
      divisions: 4
      min-mmr: 800
      max-mmr: 949
    silver:
      display-name: "Silver"
      color: "&7"
      divisions: 4
      min-mmr: 950
      max-mmr: 1099
    gold:
      display-name: "Gold"
      color: "&e"
      divisions: 4
      min-mmr: 1100
      max-mmr: 1249
    platinum:
      display-name: "Platinum"
      color: "&b"
      divisions: 4
      min-mmr: 1250
      max-mmr: 1399
    diamond:
      display-name: "Diamond"
      color: "&9"
      divisions: 4
      min-mmr: 1400
      max-mmr: 1599
    master:
      display-name: "Master"
      color: "&5"
      divisions: 0
      min-mmr: 1600
      max-mmr: 99998
    challenger:
      display-name: "Challenger"
      color: "&c"
      divisions: 0
      min-mmr: 99999
      max-mmr: 99999

  # Matchmaking settings
  matchmaking:
    # Check interval in ticks (40 = 2 seconds)
    match-interval: 40

    # Initial MMR search range
    base-range: 100

    # Expand search range every N seconds while waiting
    expansion-interval: 10

    # How much to expand the range each interval
    expansion-step: 50

    # The widest the search grows to: players further apart than this are never matched
    max-range: 500

  # What a player in the ranked queue sees while waiting
  queue-display:
    # "bossbar" or "actionbar"
    type: "bossbar"

    # Placeholders for both: %time% (time waited), %rank%, %range% (MMR search range), %mmr%
    bossbar:
      title: "<gradient:#9B59B6:#A569BD><bold>RANKED</bold></gradient> <gray>|</gray> <yellow>%time%</yellow>"
      # PINK, BLUE, RED, GREEN, YELLOW, PURPLE or WHITE
      color: "PURPLE"
      # SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12 or SEGMENTED_20
      style: "SOLID"

    actionbar:
      message: "<gradient:#9B59B6:#A569BD><bold>RANKED</bold></gradient> <gray>|</gray> <yellow>%time%</yellow>"

  # Top-tier recalculation (e.g. promoting top Master players to Challenger)
  top-tier:
    # Enable the top-tier recalculation task
    enabled: true

    # How often to recalculate top-tier promotions (in seconds)
    recalculate-interval: 300

    # Tier to promote from (must be one below the top tier)
    promote-from: "master"

    # The top tier to promote to
    promote-to: "challenger"

    # Minimum LP in promote-from tier to be eligible (0 = use top-player-count instead)
    min-lp: 0

    # Number of top players in promote-from tier to receive the top tier (used when min-lp is 0)
    top-player-count: 10

Configuration Options

Below is a reference of the main configuration sections:

storage

========================================= Nexal Duels Configuration

Storage settings

history

Match history retention. Old casual and ranked match records are deleted at startup and after every finished duel. Player stats (wins, losses, streaks, ranked LP and rank) are kept either way. Both 0 by default: every match is kept.

duel

Duel settings

queue

Queue settings

betting

Betting settings

spectator

Spectator settings

hologram

Leaderboard hologram (top players by wins)

fireworks

Fireworks on win

ranked

Ranked system settings