Configuration - SPxTeam Duels Wiki

config.yml

The main configuration file for SPxTeam Duels.

# ╔═══════════════════════════════════════════════════════════╗
# ║              SPxTeam Duels Configuration                  ║
# ║              Author: SpokyDevelopment                     ║
# ╚═══════════════════════════════════════════════════════════╝

# Team Settings
team:
  max-players: 5          # Maximum players per team
  name-min-length: 3     # Minimum team name length
  name-max-length: 16    # Maximum team name length

# Duel Settings
duel:
  request-timeout: 60    # Seconds before a duel request expires
  countdown: 5            # Seconds countdown before duel starts (shown in title)
  drop-loot-on-death: true # Drop player's loot when they die

# Winner Loot Collection Settings
winner-loot-time:
  enabled: true          # Enable loot collection time for winners
  duration: 120         # Seconds (2 minutes) to collect loot
  show-title: true      # Show countdown in action bar

# Game Mode Settings
gamemodes:
  crystal:
    enabled: true        # Enable Crystal PVP mode
    allow-block-break: true
    allow-block-place: true
    arena-reset: true    # Reset arena after duel ends
  sword:
    enabled: true        # Enable Sword PVP mode
    allow-block-break: false
    allow-block-place: false
    arena-reset: false

# Enderpearl Cooldown Settings
enderpearl:
  cooldown-enabled: true  # Enable enderpearl cooldown
  cooldown: 5            # Cooldown in seconds
  apply-outside-duel: false # Apply outside of duels too

# Arena Settings
arena:
  teleport-delay: 3      # Seconds delay before teleporting

# GUI Settings
gui:
  accept-gui:
    title: "ᴛᴇᴀᴍ ᴅᴜᴇʟ ᴄᴏɴғɪʀᴍᴀᴛɪᴏɴ"
    rows: 6

Configuration Options Explained

Option	Description	Default
`team.max-players`	Maximum number of players allowed in a single team	5
`team.name-min-length`	Minimum characters required for team names	3
`team.name-max-length`	Maximum characters allowed for team names	16
`duel.request-timeout`	How long duel requests remain valid (seconds)	60
`duel.countdown`	Countdown duration before fight begins, shown in title (seconds)	5
`duel.drop-loot-on-death`	Whether players drop their loot when they die in a duel	true
`winner-loot-time.enabled`	Enable loot collection time for winning team	true
`winner-loot-time.duration`	Seconds winners can stay in arena to collect loot	120
`winner-loot-time.show-title`	Show countdown timer in action bar for winners	true
`arena.teleport-delay`	Delay before teleporting to arena (seconds)	3
`enderpearl.cooldown-enabled`	Enable/disable enderpearl cooldown during duels	true
`enderpearl.cooldown`	Cooldown duration in seconds between pearl uses	5
`enderpearl.apply-outside-duel`	Apply cooldown even when not in a duel	false
`gamemodes.crystal.enabled`	Enable Crystal PVP game mode	true
`gamemodes.crystal.arena-reset`	Reset arena after Crystal PVP duel ends	true
`gamemodes.sword.enabled`	Enable Sword PVP game mode	true

arenas.yml

Each arena can have a specific game mode assigned. After creating an arena, edit arenas.yml to set the game mode:

arenas:
  CrystalArena:
    data: "serialized-location-data"
    gamemode: "crystal"   # Only for Crystal PVP
  SwordArena:
    data: "serialized-location-data"
    gamemode: "sword"     # Only for Sword PVP
  MultiArena:
    data: "serialized-location-data"
    gamemode: "all"       # Supports both modes (default)

Arena Game Mode Options

Value	Description
`all`	Arena supports both Crystal and Sword PVP (default)
`crystal`	Arena only for Crystal PVP duels
`sword`	Arena only for Sword PVP duels

messages.yml

Customize all plugin messages. Supports color codes and hex colors!

# Plugin prefix with gradient colors
prefix: "&x&6&E&4&5&F&F&lS&x&8&3&4&9&F&F&lP&x&9&8&4&D&F&F&lx..."

# General Messages
no-permission: "&cʏᴏᴜ ᴅᴏɴ'ᴛ ʜᴀᴠᴇ ᴘᴇʀᴍɪꜱꜱɪᴏɴ ᴛᴏ ᴅᴏ ᴛʜɪꜱ!"
player-only: "&cᴛʜɪꜱ ᴄᴏᴍᴍᴀɴᴅ ᴄᴀɴ ᴏɴʟʏ ʙᴇ ᴜꜱᴇᴅ ʙʏ ᴘʟᴀʏᴇʀꜱ!"
player-not-found: "&cᴘʟᴀʏᴇʀ &f{player} &cɴᴏᴛ ꜰᴏᴜɴᴅ!"

# Team Messages
team-created: "&aꜱᴜᴄᴄᴇꜱꜱꜰᴜʟʟʏ ᴄʀᴇᴀᴛᴇᴅ ᴛᴇᴀᴍ &f{team}&a!"
team-not-found: "&cᴛᴇᴀᴍ &f{team} &cɴᴏᴛ ꜰᴏᴜɴᴅ!"
team-full: "&cᴛʜɪꜱ ᴛᴇᴀᴍ ɪꜱ ꜰᴜʟʟ! &7(ᴍᴀx: 5 ᴘʟᴀʏᴇʀꜱ)"

# And many more...

Color Code Reference

Type	Format	Example
Legacy Colors	`&[0-9a-f]`	`&a` = Green, `&c` = Red
Formatting	`&[k-o, r]`	`&l` = Bold, `&o` = Italic
Hex Colors	`&#RRGGBB`	`&#FF5500` = Orange
Spigot Hex	`&x&R&R&G&G&B&B`	`&x&F&F&5&5&0&0` = Orange

Available Placeholders

Placeholder	Description
`{player}`	Player's name
`{team}`	Team name
`{arena}`	Arena name
`{seconds}`	Countdown seconds
`{location}`	Location coordinates
`{usage}`	Correct command usage
`{status}`	Arena status (Free/In Use)

Small Caps Characters

The plugin uses small caps for a professional look. Here's the character mapping:

# Regular → Small Caps
a → ᴀ    b → ʙ    c → ᴄ    d → ᴅ    e → ᴇ
f → ғ    g → ɢ    h → ʜ    i → ɪ    j → ᴊ
k → ᴋ    l → ʟ    m → ᴍ    n → ɴ    o → ᴏ
p → ᴘ    q → ǫ    r → ʀ    s → ꜱ    t → ᴛ
u → ᴜ    v → ᴠ    w → ᴡ    x → x    y → ʏ
z → ᴢ

You can copy these characters directly into your messages.yml file!

Reloading Configuration

After making changes to configuration files, you can reload the plugin:

# Using PlugMan or similar
/plugman reload SPxTeamDuels

# Or restart the server
/stop

Note: It's recommended to restart the server for major configuration changes to ensure everything loads correctly.