🏆 RankedSMPX

Arguably the best RankedSMP plugin available. A highly configurable competitive ranked SMP plugin for Minecraft. Players compete for 20 limited rank slots — kill to climb, survive to stay on top.

⚠️ Disclaimer: This is an unofficial fan-made recreation of the RankedSMP concept. Not affiliated with the original RankedSMP server or team.

⚙️ Configuration Preview

Click to view config.yml

# ██████╗  █████╗ ███╗   ██╗██╗  ██╗███████╗██████╗ ███████╗███╗   ███╗██████╗ ██╗  ██╗
# ██╔══██╗██╔══██╗████╗  ██║██║ ██╔╝██╔════╝██╔══██╗██╔════╝████╗ ████║██╔══██╗╚██╗██╔╝
# ██████╔╝███████║██╔██╗ ██║█████╔╝ █████╗  ██║  ██║███████╗██╔████╔██║██████╔╝ ╚███╔╝ 
# ██╔══██╗██╔══██║██║╚██╗██║██╔═██╗ ██╔══╝  ██║  ██║╚════██║██║╚██╔╝██║██╔═══╝  ██╔██╗ 
# ██║  ██║██║  ██║██║ ╚████║██║  ██╗███████╗██████╔╝███████║██║ ╚═╝ ██║██║     ██╔╝ ██╗
# ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═══╝╚═╝  ╚═╝╚══════╝╚═════╝ ╚══════╝╚═╝     ╚═╝╚═╝     ╚═╝  ╚═╝
#
# Author: mukulx
# Modrinth: https://modrinth.com/project/rankedsmpx
# Discord: https://discord.gg/Ec9r2Um7sz
# Issues: https://discord.gg/Ec9r2Um7sz

config-version: 4

# ███╗   ███╗███████╗███████╗███████╗ █████╗  ██████╗ ███████╗███████╗
# ████╗ ████║██╔════╝██╔════╝██╔════╝██╔══██╗██╔════╝ ██╔════╝██╔════╝
# ██╔████╔██║█████╗  ███████╗███████╗███████║██║  ███╗█████╗  ███████╗
# ██║╚██╔╝██║██╔══╝  ╚════██║╚════██║██╔══██║██║   ██║██╔══╝  ╚════██║
# ██║ ╚═╝ ██║███████╗███████║███████║██║  ██║╚██████╔╝███████╗███████║
# ╚═╝     ╚═╝╚══════╝╚══════╝╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚══════╝

# Small Caps Messages - Convert all messages to small caps font (ʜᴇʟʟᴏ)
# Colors and formatting are preserved
small-caps-messages: true

# ██████╗  █████╗ ████████╗ █████╗ ██████╗  █████╗ ███████╗███████╗
# ██╔══██╗██╔══██╗╚══██╔══╝██╔══██╗██╔══██╗██╔══██╗██╔════╝██╔════╝
# ██║  ██║███████║   ██║   ███████║██████╔╝███████║███████╗█████╗  
# ██║  ██║██╔══██║   ██║   ██╔══██║██╔══██╗██╔══██║╚════██║██╔══╝  
# ██████╔╝██║  ██║   ██║   ██║  ██║██████╔╝██║  ██║███████║███████╗
# ╚═════╝ ╚═╝  ╚═╝   ╚═╝   ╚═╝  ╚═╝╚═════╝ ╚═╝  ╚═╝╚══════╝╚══════╝

# Database Settings (for persistent storage)
database:
  # Type: sqlite or mysql
  type: sqlite
  # SQLite file name
  sqlite-file: rankedsmp.db
  # MySQL settings (if type is mysql)
  mysql:
    host: localhost
    port: 3306
    database: rankedsmp
    username: root
    password: password
    # HikariCP pool settings
    pool:
      maximum-pool-size: 10
      minimum-idle: 2
      connection-timeout: 30000
      idle-timeout: 600000
      max-lifetime: 1800000

# ██████╗  █████╗ ███╗   ███╗███████╗
# ██╔════╝ ██╔══██╗████╗ ████║██╔════╝
# ██║  ███╗███████║██╔████╔██║█████╗  
# ██║   ██║██╔══██║██║╚██╔╝██║██╔══╝  
# ╚██████╔╝██║  ██║██║ ╚═╝ ██║███████╗
#  ╚═════╝ ╚═╝  ╚═╝╚═╝     ╚═╝╚══════╝

# Season Settings
season:
  # Total number of ranks (1-20)
  total-ranks: 20
  
  # Rank stealing on player kill
  rank-stealing:
    enabled: true
    # Only allow stealing if rank difference is within this range (0 = unlimited)
    max-rank-difference: 0

# ██████╗  █████╗ ███╗   ██╗██╗  ██╗    ██████╗ ██╗███████╗██████╗ ██╗      █████╗ ██╗   ██╗
# ██╔══██╗██╔══██╗████╗  ██║██║ ██╔╝    ██╔══██╗██║██╔════╝██╔══██╗██║     ██╔══██╗╚██╗ ██╔╝
# ██████╔╝███████║██╔██╗ ██║█████╔╝     ██║  ██║██║███████╗██████╔╝██║     ███████║ ╚████╔╝ 
# ██╔══██╗██╔══██║██║╚██╗██║██╔═██╗     ██║  ██║██║╚════██║██╔═══╝ ██║     ██╔══██║  ╚██╔╝  
# ██║  ██║██║  ██║██║ ╚████║██║  ██╗    ██████╔╝██║███████║██║     ███████╗██║  ██║   ██║   
# ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═══╝╚═╝  ╚═╝    ╚═════╝ ╚═╝╚══════╝╚═╝     ╚══════╝╚═╝  ╚═╝   ╚═╝   

# Rank Display in Messages
rank-display:
  # Show rank in join messages
  show-on-join: true
  # Show rank in leave messages
  show-on-leave: true
  # Show rank in death messages
  show-on-death: true
  # Rank format (use {rank} for rank number, {player} for player name)
  # Examples: "[#{rank}] {player}", "{player} [Rank {rank}]", "[R{rank}] {player}"
  format: "&b[&3#{rank}&b]&r {player}"
  # Format for unranked players
  unranked-format: "&7[Unranked]&r {player}"

# ██╗  ██╗███████╗ █████╗ ██╗  ████████╗██╗  ██╗
# ██║  ██║██╔════╝██╔══██╗██║  ╚══██╔══╝██║  ██║
# ███████║█████╗  ███████║██║     ██║   ███████║
# ██╔══██║██╔══╝  ██╔══██║██║     ██║   ██╔══██║
# ██║  ██║███████╗██║  ██║███████╗██║   ██║  ██║
# ╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝╚══════╝╚═╝   ╚═╝  ╚═╝

# Health System
health:
  # Rank 1 hearts
  max-hearts: 20.0
  # Rank 20 hearts
  min-hearts: 10.5
  # Unranked hearts
  unranked-hearts: 10.0
  # Apply health on respawn
  apply-on-respawn: true
  # Custom hearts per rank (overrides linear interpolation if set)
  custom-hearts:
    1: 20.0
    2: 19.5
    3: 19.0
    4: 18.5
    5: 18.0
    6: 17.5
    7: 17.0
    8: 16.5
    9: 16.0
    10: 15.5
    11: 15.0
    12: 14.5
    13: 14.0
    14: 13.5
    15: 13.0
    16: 12.5
    17: 12.0
    18: 11.5
    19: 11.0
    20: 10.5
    0: 10.0

# ██████╗  ██████╗ ████████╗██╗ ██████╗ ███╗   ██╗███████╗
# ██╔══██╗██╔═══██╗╚══██╔══╝██║██╔═══██╗████╗  ██║██╔════╝
# ██████╔╝██║   ██║   ██║   ██║██║   ██║██╔██╗ ██║███████╗
# ██╔═══╝ ██║   ██║   ██║   ██║██║   ██║██║╚██╗██║╚════██║
# ██║     ╚██████╔╝   ██║   ██║╚██████╔╝██║ ╚████║███████║
# ╚═╝      ╚═════╝    ╚═╝   ╚═╝ ╚═════╝ ╚═╝  ╚═══╝╚══════╝

# Potion Duration Multipliers
# How it works:
# - When a player drinks/gets hit by a potion, the duration is multiplied by their rank's multiplier
# - Example: Rank 1 with 2.0x drinks a 3-minute potion = 6 minutes
# - Custom multipliers override the linear interpolation between rank-1 and rank-20
# - To use custom multipliers: Set the value for each rank below
# - To use linear interpolation: Remove or comment out the custom-multipliers section
potions:
  # Rank 1 multiplier (2.0 = 200% duration)
  rank-1-multiplier: 2.0
  # Rank 20 multiplier (1.05 = 105% duration)
  rank-20-multiplier: 1.05
  # Unranked multiplier
  unranked-multiplier: 1.0
  # Extend custom effects from plugins/items (e.g., custom armor, enchanted items)
  # When enabled, potion effects from plugins will also be extended by the multiplier
  # When disabled, only vanilla potion sources (potions, arrows, beacons, etc.) are extended
  extend-custom-effects: true
  # Custom multipliers per rank (overrides linear interpolation if set)
  # To change: Edit the values below, then run /rsmp reload
  custom-multipliers:
    1: 2.0
    2: 1.96
    3: 1.91
    4: 1.86
    5: 1.81
    6: 1.76
    7: 1.71
    8: 1.66
    9: 1.61
    10: 1.56
    11: 1.51
    12: 1.46
    13: 1.41
    14: 1.36
    15: 1.31
    16: 1.26
    17: 1.21
    18: 1.16
    19: 1.11
    20: 1.05
    0: 1.0

# ██╗  ██╗██████╗ 
# ╚██╗██╔╝██╔══██╗
#  ╚███╔╝ ██████╔╝
#  ██╔██╗ ██╔═══╝ 
# ██╔╝ ██╗██║     
# ╚═╝  ╚═╝╚═╝     

# XP Multipliers
# How it works:
# - When a player gains XP, the amount is multiplied by their rank's multiplier
# - Example: Rank 1 with 3.0x kills a mob that drops 5 XP = 15 XP
# - Custom multipliers override the linear interpolation between rank-1 and rank-20
# - To use custom multipliers: Set the value for each rank below
# - To use linear interpolation: Remove or comment out the custom-multipliers section
xp:
  # Rank 1 multiplier (3.0 = 300% XP)
  rank-1-multiplier: 3.0
  # Rank 20 multiplier (1.1 = 110% XP)
  rank-20-multiplier: 1.1
  # Unranked multiplier
  unranked-multiplier: 1.0
  # Custom multipliers per rank (overrides linear interpolation if set)
  # To change: Edit the values below, then run /rsmp reload
  # Smooth progression: 3.0 → 1.1 (decrease of 0.1 per rank)
  custom-multipliers:
    1: 3.0      # Rank 1
    2: 2.9      # Rank 2
    3: 2.8      # Rank 3
    4: 2.7      # Rank 4
    5: 2.6      # Rank 5
    6: 2.5      # Rank 6
    7: 2.4      # Rank 7
    8: 2.3      # Rank 8
    9: 2.2      # Rank 9
    10: 2.1     # Rank 10
    11: 2.0     # Rank 11
    12: 1.9     # Rank 12
    13: 1.8     # Rank 13
    14: 1.7     # Rank 14
    15: 1.6     # Rank 15
    16: 1.5     # Rank 16
    17: 1.4     # Rank 17
    18: 1.3     # Rank 18
    19: 1.2     # Rank 19
    20: 1.1     # Rank 20
    0: 1.0      # Unranked

# ██╗███╗   ██╗██╗   ██╗███████╗███╗   ██╗████████╗ ██████╗ ██████╗ ██╗   ██╗
# ██║████╗  ██║██║   ██║██╔════╝████╗  ██║╚══██╔══╝██╔═══██╗██╔══██╗╚██╗ ██╔╝
# ██║██╔██╗ ██║██║   ██║█████╗  ██╔██╗ ██║   ██║   ██║   ██║██████╔╝ ╚████╔╝ 
# ██║██║╚██╗██║╚██╗ ██╔╝██╔══╝  ██║╚██╗██║   ██║   ██║   ██║██╔══██╗  ╚██╔╝  
# ██║██║ ╚████║ ╚████╔╝ ███████╗██║ ╚████║   ██║   ╚██████╔╝██║  ██║   ██║   
# ╚═╝╚═╝  ╚═══╝  ╚═══╝  ╚══════╝╚═╝  ╚═══╝   ╚═╝    ╚═════╝ ╚═╝  ╚═╝   ╚═╝   

# Extra Inventory Slots (/inv command)
inventory:
  # Enable extra inventory for top 10 ranks
  enabled: true
  # Drop items on death
  drop-on-death: true
  # Combat tagging - prevent opening inventory during combat
  combat:
    # Disable opening extra inventory during combat
    disabled-during-combat: false
    # Combat tag duration in seconds (how long after taking/dealing damage)
    combat-duration: 10
  # Slots per rank (exact values - extra slots filled with barriers)
  # Note: Maximum 54 slots (6 rows) due to Minecraft limitations
  slots:
    1: 54   # 53 slots
    2: 54   # 54 slots
    3: 50   # 50 slots
    4: 45   # 45 slots
    5: 40   # 40 slots
    6: 35   # 35 slots
    7: 30   # 30 slots
    8: 25   # 25 slots
    9: 20   # 20 slots
    10: 15  # 15 slots

#     ██╗██╗   ██╗██████╗  ██████╗ ███████╗███╗   ███╗███████╗███╗   ██╗████████╗
#     ██║██║   ██║██╔══██╗██╔════╝ ██╔════╝████╗ ████║██╔════╝████╗  ██║╚══██╔══╝
#     ██║██║   ██║██║  ██║██║  ███╗█████╗  ██╔████╔██║█████╗  ██╔██╗ ██║   ██║   
#██   ██║██║   ██║██║  ██║██║   ██║██╔══╝  ██║╚██╔╝██║██╔══╝  ██║╚██╗██║   ██║   
#╚█████╔╝╚██████╔╝██████╔╝╚██████╔╝███████╗██║ ╚═╝ ██║███████╗██║ ╚████║   ██║   
# ╚════╝  ╚═════╝ ╚═════╝  ╚═════╝ ╚══════╝╚═╝     ╚═╝╚══════╝╚═╝  ╚═══╝   ╚═╝   
#                                                                                  
# ██╗  ██╗ █████╗ ███╗   ███╗███╗   ███╗███████╗██████╗                          
# ██║  ██║██╔══██╗████╗ ████║████╗ ████║██╔════╝██╔══██╗                         
# ███████║███████║██╔████╔██║██╔████╔██║█████╗  ██████╔╝                         
# ██╔══██║██╔══██║██║╚██╔╝██║██║╚██╔╝██║██╔══╝  ██╔══██╗                         
# ██║  ██║██║  ██║██║ ╚═╝ ██║██║ ╚═╝ ██║███████╗██║  ██║                         
# ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝     ╚═╝╚═╝     ╚═╝╚══════╝╚═╝  ╚═╝                         

# ⚠️ WARNING: WORK IN PROGRESS 
# The Judgement Hammer feature is still being refined and may have bugs.
# Miss detection and combo mechanics are being improved.
# Will be fully stable in a future update.

# Judgement Hammer (Legendary Mace for Rank #1)
# - Only given ONCE to the first rank #1 player
# - After that, it drops on death/rank loss and must be found
# - Admins can manually give it with /rsmp give hammer <player>
judgement-hammer:
  enabled: true
  # Auto-give hammer to rank #1 at game start (disabled by default)
  # If false, admins must manually give it with /rsmp give hammer <player>
  auto-give-on-start: false
  # Item name
  name: "&6&lJudgement Hammer"
  # Lore
  lore:
    - "&7The ultimate weapon of judgment"
    - "&7Forged for the apex predator"
    - ""
    - "&e&l⚡ EXECUTIONER'S DASH"
    - "&7Dash forward to close the gap"
    - "&7Cooldown: &c8s"
    - ""
    - "&c&l⚔ DIVINE RETRIBUTION"
    - "&7Build combo: &e4 consecutive hits"
    - "&7Unleashes: &c2x damage &7+ &6explosion &7+ &dshockwave"
    - ""
    - "&8Miss = Combo Reset + Cooldown"
  # Dash distance in blocks (nerfed from 5.0 to 3.0)
  dash-distance: 3.0
  # Dash cooldown in seconds (nerfed from 3s to 8s)
  dash-cooldown: 8
  # Smash attacks needed for Verdict
  verdict-combo-required: 4
  # Verdict damage multiplier
  verdict-damage-multiplier: 2.0
  # Verdict explosion power (terrain destruction)
  verdict-explosion-power: 2.0
  # Combo reset time in seconds (if no hit within this time)
  combo-reset-time: 5
  # Miss cooldown in seconds
  miss-cooldown: 10
  
  # Dash Effects & Sound
  dash-effects:
    # Sound when dashing
    sound:
      enabled: true
      sound: ENTITY_ENDER_DRAGON_FLAP
      volume: 1.0
      pitch: 1.5
    # Particle effects during dash
    particles:
      enabled: true
      # Particle type (CLOUD, FLAME, SOUL_FIRE_FLAME, DRAGON_BREATH, etc.)
      type: SOUL_FIRE_FLAME
      # Number of particles
      count: 30
      # Particle spread
      spread: 0.3
    # Additional trail particles
    trail-particles:
      enabled: true
      type: FLAME
      count: 20
    # Speed boost particles
    speed-particles:
      enabled: true
      type: CRIT
      count: 15
  
  # Verdict Effects (when 4-hit combo is achieved)
  verdict-effects:
    # Sound when verdict activates
    sound:
      enabled: true
      sound: ENTITY_WITHER_DEATH
      volume: 1.0
      pitch: 1.0
    # Particle effects on verdict
    particles:
      enabled: true
      type: EXPLOSION_LARGE
      count: 10
    # Circle particle effect around victim
    circle-particles:
      enabled: true
      type: FLAME
      radius: 3.0
      points: 32
      height: 0.5
    # Shockwave particles
    shockwave-particles:
      enabled: true
      type: SWEEP_ATTACK
      count: 20
  
  # Death Effect (when player is killed by hammer)
  death-effect:
    enabled: true
    # Duration in seconds
    duration: 5
    # Skull particle effect
    skull:
      enabled: true
      # Particle types for skull (grey, white, black smoke)
      particles:
        - ASH
        - WHITE_ASH
        - SMOKE_NORMAL
      # Particles per second
      density: 20
      # Skull size (radius in blocks)
      size: 1.0

# ██████╗ ██████╗  █████╗  ██████╗  ██████╗ ███╗   ██╗    ███████╗ ██████╗  ██████╗ 
# ██╔══██╗██╔══██╗██╔══██╗██╔════╝ ██╔═══██╗████╗  ██║    ██╔════╝██╔════╝ ██╔════╝ 
# ██║  ██║██████╔╝███████║██║  ███╗██║   ██║██╔██╗ ██║    █████╗  ██║  ███╗██║  ███╗
# ██║  ██║██╔══██╗██╔══██║██║   ██║██║   ██║██║╚██╗██║    ██╔══╝  ██║   ██║██║   ██║
# ██████╔╝██║  ██║██║  ██║╚██████╔╝╚██████╔╝██║ ╚████║    ███████╗╚██████╔╝╚██████╔╝
# ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝  ╚═════╝ ╚═╝  ╚═══╝    ╚══════╝ ╚═════╝  ╚═════╝ 

# Dragon Egg Locator (Experimental - 1.21.6+)
dragon-egg-locator:
  enabled: true
  # Update interval in ticks (20 = 1 second)
  update-interval: 20
  # Show distance in blocks
  show-distance: true

# ████████╗ █████╗ ██████╗ 
# ╚══██╔══╝██╔══██╗██╔══██╗
#    ██║   ███████║██████╔╝
#    ██║   ██╔══██║██╔══██╗
#    ██║   ██║  ██║██████╔╝
#    ╚═╝   ╚═╝  ╚═╝╚═════╝ 

# TAB Integration (Works with TAB plugin OR vanilla Minecraft tab)
# - If TAB plugin is installed: Uses TAB's advanced features (RGB colors, gradients, etc.)
# - If TAB plugin is NOT installed: Uses vanilla Minecraft scoreboard teams (legacy colors only)
# No setup command needed - works automatically!
#
# Supports MiniMessage RGB format with TAB plugin: <gradient:#FF0000:#00FF00>Text</gradient>, <#FF5555>Text
# Vanilla tab only supports legacy color codes: &a, &b, &l, &o, etc.
# You can use PlaceholderAPI placeholders in prefix/suffix!
# Example: "&7[&bVIP&7] &b[&3#%rank%&b] &c%rankedsmp_hearts%❤ "
# See PLACEHOLDERS.md for available placeholders
#
tab-integration:
  enabled: true
  
  # Unranked player prefix (no rank assigned)
  unranked-prefix: '&7[Unranked] '
  unranked-suffix: ''
  
  # Blacklisted player prefix (cannot receive ranks)
  blacklisted-prefix: '&0[Blacklisted] '
  blacklisted-suffix: ''
  
  # Rank Prefixes - Customize each rank's prefix individually
  # With TAB plugin: Supports legacy color codes (&a, &b) and MiniMessage format (<#FF5555>, <gradient>)
  # Without TAB plugin: Only supports legacy color codes (&a, &b, &l, &o, etc.)
  # Examples:
  #   - "&6&l⭐ &e#1 &r" - Gold star for rank 1
  #   - "<gradient:#FFD700:#FFA500>#2</gradient> " - Gold gradient (TAB only)
  #   - "<#FF5555>[<#FFAA00>#3<#FF5555>] " - RGB colors (TAB only)
  # Default colors match the chat gradient system:
  #   Ranks 1-5: Gold to Orange gradient
  #   Ranks 6-10: Silver to Light Blue gradient
  #   Ranks 11-15: Green to Lime gradient
  #   Ranks 16-20: Purple to Pink gradient
  rank-prefixes:
    1: '&#FFD700[&#FFAA00#1&#FFD700] '      # Gold to Orange
    2: '&#FFD700[&#FFAA00#2&#FFD700] '      # Gold to Orange
    3: '&#FFD700[&#FFAA00#3&#FFD700] '      # Gold to Orange
    4: '&#FFD700[&#FFAA00#4&#FFD700] '      # Gold to Orange
    5: '&#FFD700[&#FFAA00#5&#FFD700] '      # Gold to Orange
    6: '&#C0C0C0[&#A4D7E8#6&#C0C0C0] '      # Silver to Light Blue
    7: '&#C0C0C0[&#A4D7E8#7&#C0C0C0] '      # Silver to Light Blue
    8: '&#C0C0C0[&#A4D7E8#8&#C0C0C0] '      # Silver to Light Blue
    9: '&#C0C0C0[&#A4D7E8#9&#C0C0C0] '      # Silver to Light Blue
    10: '&#C0C0C0[&#A4D7E8#10&#C0C0C0] '    # Silver to Light Blue
    11: '&#32CD32[&#5FE47E#11&#32CD32] '    # Green to Lime
    12: '&#32CD32[&#5FE47E#12&#32CD32] '    # Green to Lime
    13: '&#32CD32[&#5FE47E#13&#32CD32] '    # Green to Lime
    14: '&#32CD32[&#5FE47E#14&#32CD32] '    # Green to Lime
    15: '&#32CD32[&#5FE47E#15&#32CD32] '    # Green to Lime
    16: '&#8A2BE2[&#C21FB7#16&#8A2BE2] '    # Purple to Pink
    17: '&#8A2BE2[&#C21FB7#17&#8A2BE2] '    # Purple to Pink
    18: '&#8A2BE2[&#C21FB7#18&#8A2BE2] '    # Purple to Pink
    19: '&#8A2BE2[&#C21FB7#19&#8A2BE2] '    # Purple to Pink
    20: '&#8A2BE2[&#C21FB7#20&#8A2BE2] '    # Purple to Pink
  
  # Rank Suffixes (optional - leave empty if not needed)
  rank-suffixes:
    1: ''
    2: ''
    3: ''
    4: ''
    5: ''
    6: ''
    7: ''
    8: ''
    9: ''
    10: ''
    11: ''
    12: ''
    13: ''
    14: ''
    15: ''
    16: ''
    17: ''
    18: ''
    19: ''
    20: ''

# ███████╗ ██████╗ ██╗   ██╗███╗   ██╗██████╗ ███████╗
# ██╔════╝██╔═══██╗██║   ██║████╗  ██║██╔══██╗██╔════╝
# ███████╗██║   ██║██║   ██║██╔██╗ ██║██║  ██║███████╗
# ╚════██║██║   ██║██║   ██║██║╚██╗██║██║  ██║╚════██║
# ███████║╚██████╔╝╚██████╔╝██║ ╚████║██████╔╝███████║
# ╚══════╝ ╚═════╝  ╚═════╝ ╚═╝  ╚═══╝╚═════╝ ╚══════╝

# Sound Effects
# Get full list of sounds: https://www.digminecraft.com/lists/sound_list_pc.php
sounds:
  # Sound when season starts (all players hear)
  season-start:
    enabled: true
    sound: ENTITY_ENDER_DRAGON_GROWL
    volume: 1.0
    pitch: 1.0
  
  # Sound when player receives their rank
  rank-reveal:
    enabled: true
    sound: ENTITY_PLAYER_LEVELUP
    volume: 1.0
    pitch: 1.2
  
  # Sound for rank assignments broadcast
  rank-broadcast:
    enabled: true
    sound: BLOCK_NOTE_BLOCK_PLING
    volume: 0.5
    pitch: 1.5
  
  # Sound when season stops
  season-stop:
    enabled: true
    sound: ENTITY_WITHER_DEATH
    volume: 0.8
    pitch: 1.0

# ██████╗  █████╗ ███╗   ██╗██╗  ██╗    ████████╗██████╗  █████╗ ███╗   ██╗███████╗███████╗███████╗██████╗ 
# ██╔══██╗██╔══██╗████╗  ██║██║ ██╔╝    ╚══██╔══╝██╔══██╗██╔══██╗████╗  ██║██╔════╝██╔════╝██╔════╝██╔══██╗
# ██████╔╝███████║██╔██╗ ██║█████╔╝        ██║   ██████╔╝███████║██╔██╗ ██║███████╗█████╗  █████╗  ██████╔╝
# ██╔══██╗██╔══██║██║╚██╗██║██╔═██╗        ██║   ██╔══██╗██╔══██║██║╚██╗██║╚════██║██╔══╝  ██╔══╝  ██╔══██╗
# ██║  ██║██║  ██║██║ ╚████║██║  ██╗       ██║   ██║  ██║██║  ██║██║ ╚████║███████║██║     ███████╗██║  ██║
# ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═══╝╚═╝  ╚═╝       ╚═╝   ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═══╝╚══════╝╚═╝     ╚══════╝╚═╝  ╚═╝

# Rank Transfer Settings
# Note: For Discord integration settings, see discord.yml
rank-transfer:
  # Enable rank transfer feature
  enabled: false
  # Allow transferring to offline players
  allow-offline: false

# ██████╗ ███████╗██████╗ ██╗   ██╗ ██████╗ 
# ██╔══██╗██╔════╝██╔══██╗██║   ██║██╔════╝ 
# ██║  ██║█████╗  ██████╔╝██║   ██║██║  ███╗
# ██║  ██║██╔══╝  ██╔══██╗██║   ██║██║   ██║
# ██████╔╝███████╗██████╔╝╚██████╔╝╚██████╔╝
# ╚═════╝ ╚══════╝╚═════╝  ╚═════╝  ╚═════╝ 

# Debug Mode - Enable detailed logging for troubleshooting
debug:
  # Enable debug logging
  enabled: false
  # Log death events (rank stealing)
  log-death-events: false
  # Log chat events (formatting)
  log-chat-events: false
  # Log XP multiplier calculations
  log-xp-events: false
  # Log potion multiplier calculations
  log-potion-events: false

# ███████╗██████╗ ███████╗ █████╗ ██████╗ 
# ██╔════╝██╔══██╗██╔════╝██╔══██╗██╔══██╗
# ███████╗██████╔╝█████╗  ███████║██████╔╝
# ╚════██║██╔═══╝ ██╔══╝  ██╔══██║██╔══██╗
# ███████║██║     ███████╗██║  ██║██║  ██║
# ╚══════╝╚═╝     ╚══════╝╚═╝  ╚═╝╚═╝  ╚═╝

# Diamond Spear (1.21.11+ only)
# Only works on servers running Minecraft 1.21.11 or higher
# The spear is always diamond material - no other types available
spear:
  # Enable spear features (auto-disabled if server version doesn't support spears)
  enabled: true
  # Make spear unbreakable (infinite durability)
  unbreakable: true
  # Prevent storing Judgement Hammer and Diamond Spear in containers
  # Blocks: chests, ender chests, barrels, shulker boxes, hoppers, extra inventory, etc.
  # Also prevents dropping these items
  prevent-storage: true
  # Enchantments to apply to the spear
  # Format: ENCHANTMENT_NAME: level
  # Available enchantments: LUNGE, SHARPNESS, KNOCKBACK, UNBREAKING, MENDING, etc.
  # Note: LUNGE is spear-specific and provides dash ability
  # Examples:
  #   LUNGE: 3          - Dash ability (spear-specific)
  #   SHARPNESS: 5      - Extra damage
  #   KNOCKBACK: 2      - Knock enemies back
  #   UNBREAKING: 3     - Durability (if unbreakable is false)
  #   MENDING: 1        - Repair with XP (if unbreakable is false)
  enchantments:
    LUNGE: 3
    # SHARPNESS: 5
    # KNOCKBACK: 2

✨ Features

Random Rank Assignment — When the game starts, all online players receive a random rank from 1-20. Late joiners remain unranked until manually assigned.

Judgement Hammer — Custom legendary mace with Executioner's Dash (dash forward 3 blocks) and Divine Retribution (4-hit combo unleashes 2x damage + explosion + shockwave). Miss penalty resets combo. Fully configurable effects and cooldowns.

Diamond Spear (1.21.11+) — Configurable diamond spear with custom enchantments (default: Lunge III). Unbreakable option available. Version-detected, auto-disabled on older servers.

Progressive Heart System — Rank 1 has 20 hearts, Rank 20 has 10.5 hearts, Unranked has 10 hearts. Each rank adds roughly half a heart. Fully customizable per rank.

Potion Duration Multipliers — Higher ranks get longer-lasting potion effects. Rank 1 gets 2x duration, Rank 20 gets 1.05x boost. Custom multipliers per rank supported.

XP Multipliers — Earn XP faster based on your rank. Rank 1 earns 3x XP, Rank 20 earns 1.1x XP. Smooth progression with per-rank customization.

Extra Inventory (Ranks 1-10) — Top 10 ranks unlock extra inventory slots via /inv command. Rank 1-2 get 54 slots (full double chest), Rank 10 gets 15 slots. Combat tag protection optional.

Rank Stealing — Kill a player with a better rank to swap positions. Climb to #1 through PvP combat. Configurable rank difference limits and cooldowns.

Rank Management GUI — Intuitive GUI (/rsmp manage) to view and manage all ranks. Set, remove, or blacklist players with visual feedback.

Random Rank Roulette — /rankrandom command with 5-6 second animation (20 spins). Supports flags: -i (include ranked players), -o (include offline players). Blacklist protection and downgrade prevention built-in.

TAB Integration — Automatic integration with TAB plugin (RGB colors, MiniMessage) OR vanilla Minecraft tab (legacy colors). Same config for both. Automatic sorting by rank.

PlaceholderAPI Support — 8 placeholders for rank, hearts, multipliers, and prefixes. Use in chat plugins, scoreboards, holograms, and more.

Discord Bot Integration — Full-featured Discord bot with account linking, live leaderboard, rank notifications, role sync, and slash commands. Configurable channels and permissions.

(Experimental) Dragon Egg Locator — Players holding a Dragon Egg can see all other players on the locator bar. (1.21.6+ required)

Migration Tool — Import ranks and inventories from old RankedSMP plugin (by Lusik21556). Preview before import, click confirmation, instant migration.

Database Support — SQLite (default, zero-config) or MySQL/MariaDB with HikariCP connection pooling. JSON export/import for backups and transfers.

Admin Tools — Extra inventory viewer (/einvsee), rank history tracking, blacklist system, rank fix utility, debug logging, and comprehensive permission system.

📈 Rank Buffs

🏆Rank	❤️ Hearts	🧪 Potion	⭐ XP	📦 Inv Slots
#1	20.0	2.00×	3.0×	54
#2	19.5	1.96×	2.9×	54
#3	19.0	1.91×	2.8×	50
#4	18.5	1.86×	2.7×	45
#5	18.0	1.81×	2.6×	40
#6	17.5	1.76×	2.5×	35
#7	17.0	1.71×	2.4×	30
#8	16.5	1.66×	2.3×	25
#9	16.0	1.61×	2.2×	20
#10	15.5	1.56×	2.1×	15
#11	15.0	1.51×	2.0×	—
#12	14.5	1.46×	1.9×	—
#13	14.0	1.41×	1.8×	—
#14	13.5	1.36×	1.7×	—
#15	13.0	1.31×	1.6×	—
#16	12.5	1.26×	1.5×	—
#17	12.0	1.21×	1.4×	—
#18	11.5	1.16×	1.3×	—
#19	11.0	1.11×	1.2×	—
#20	10.5	1.05×	1.1×	—
Unranked	10.0	1.00×	1.0×	—

All values are fully configurable in config.yml.

📋 Commands

👤 Player Commands

Command	Aliases	Description
`/rankinfo [player]`	`/ri`, `/myrank`	Check rank info and active buffs
`/ranktop`	`/rt`, `/topranks`	View the top ranked players
`/rank [player]`	—	View rank and buffs for any player
`/ranks`	—	Open the ranked players GUI
`/ranktransfer <player>`	`/transfer`, `/giverank`	Give your rank to another player (must be enabled in config)
`/linkdiscord`	`/discordlink`	Link your Minecraft account to Discord
`/unlinkdiscord`	`/discordunlink`	Unlink your Discord account
`/extrainventory`	`/inv`, `/ei`, `/einv`	Open extra inventory (Ranks 1–10 only)

🔧 Admin Commands

Note: Commands can be used with /rankedsmp, /rsmp, or /rtr (all are aliases)

Command	Permission	Description
`/rsmp start`	`rankedsmp.admin`	Start the game and assign ranks
`/rsmp stop`	`rankedsmp.admin`	Stop the game and clear all ranks
`/rsmp reload`	`rankedsmp.admin`	Reload all config files
`/rsmp migrate`	`rankedsmp.admin`	Import data from old RankedSMP plugin
`/rsmp manage`	`rankedsmp.admin`	Open the rank management GUI
`/rsmp set <player> <rank\|unranked\|blacklisted>`	`rankedsmp.admin`	Set a player's rank directly
`/rsmp rank remove <player>`	`rankedsmp.admin`	Remove a player's rank
`/rsmp spear`	`rankedsmp.admin`	Get a Diamond Spear (1.21.11+ only)
`/rsmp give spear <player>`	`rankedsmp.admin`	Give Diamond Spear to a player
`/rsmp give hammer <player>`	`rankedsmp.admin`	Give Judgement Hammer to a player
`/rankrandom <rank> [-i] [-o]`	`rankedsmp.admin`	Randomly assign rank with roulette animation
`/einvsee <player>`	`rankedsmp.extrainvsee`	View/edit player's extra inventory (supports offline)
`/rankblacklist <add\|remove\|list> <player>`	`rankedsmp.blacklist`	Manage the rank blacklist
`/rankhistory <player>`	`rankedsmp.history`	View a player's rank change history
`/rankhistorywipe <player\|all>`	`rankedsmp.historywipe`	Wipe rank history
`/rankexport`	`rankedsmp.export`	Export all ranks to JSON
`/rankimport <filename>`	`rankedsmp.import`	Import ranks from JSON
`/rankfix`	`rankedsmp.admin`	Fix any invalid ranks in database

Migration from Old RankedSMP Plugin

The /rsmp migrate command allows you to import data from the old RankedSMP plugin (by Lusik21556).

How to use:

Stop your server
Remove/disable the old RankedSMP plugin
Install RankedSMPX
Start your server
Run /rsmp migrate (or /rtr migrate)
Click the confirmation message
Done! Changes apply instantly

`/rankrandom` Flags

The /rankrandom command randomly selects a player and assigns them a specific rank with a 5-6 second roulette animation.

Flag	Description
`-i` or `--include-ranked`	Include ranked players (can only win better ranks)
`-o` or `--offline`	Include offline players in selection pool

Default Behavior: Only unranked online players are eligible
Blacklist Protection: Blacklisted players are never selected
Downgrade Prevention: With -i flag, ranked players can only win better ranks (no downgrades)
Offline Support: With -o flag, offline players receive perks when they join

Examples:

/rankrandom 5 - Give rank #5 to a random unranked online player
/rankrandom 1 -i - Give rank #1 to any online player (ranked or unranked)
/rankrandom 10 -i -o - Give rank #10 to any player (online/offline, ranked/unranked)

Animation: 20 spins over 5-6 seconds with sound effects and visual feedback

💬 Discord Commands

Command	Who	Description
`/help`	Everyone	Show all available Discord commands
`/rank [player]`	Everyone	Check rank for yourself or another player
`/link <code>`	Everyone	Link Minecraft account with 6-digit code
`/unlink`	Everyone	Unlink your Minecraft account
`/rankset <player> <rank>`	Admin	Set a player's rank via Discord
`/rankrandom <rank> [-i] [-o]`	Admin	Randomly assign rank with roulette animation
`/setchannel <type>`	Admin	Set leaderboard or updates channel
`/rankexport` / `/rankimport`	Admin	Export/import rank data as JSON

Special Items

Judgement Hammer (Custom Mace)

Executioner's Dash: Dash forward 3 blocks (8s cooldown)
Divine Retribution: 4-hit combo unleashes 2× damage + explosion + shockwave
Miss Penalty: Missing resets combo and adds 10s cooldown
Storage Prevention: Cannot be stored in containers or dropped
Command: /rsmp give hammer <player> to give the hammer

Diamond Spear (1.21.11+)

Version: Only works on Minecraft 1.21.11 or higher
Material: Diamond only (no other types)
Enchantments: Fully configurable (default: Lunge III)
Unbreakable: Configurable (enabled by default)
Storage Prevention: Cannot be stored in containers or dropped
Commands: /rsmp spear or /rsmp give spear <player>

Both items are protected from storage in chests, ender chests, barrels, shulker boxes, hoppers, extra inventory, and cannot be dropped on the ground.

🏷️ TAB Integration

RankedSMPX automatically integrates with your tab list to display rank prefixes:

With TAB Plugin

RGB Colors: Full MiniMessage support (<#FF5555>, <gradient>)
PlaceholderAPI: Use placeholders in prefixes/suffixes
Advanced Features: Sorting, animations, and more via TAB

Without TAB Plugin (Vanilla)

Automatic Fallback: Uses Minecraft's built-in scoreboard teams
Legacy Colors: Supports &a, &b, &l, &o, etc.
Automatic Sorting: Rank #1 at top, unranked/blacklisted at bottom
No Setup Required: Works out of the box

Note: Both TAB plugin and vanilla mode use the same configuration. If TAB is not installed, the plugin automatically uses vanilla scoreboard teams.

Fully customizable per rank with prefixes and suffixes!

📊 PlaceholderAPI Placeholders

Placeholder	Description	Example
`%rankedsmp_rank%`	Player's rank or "Unranked"	`5` / `Unranked`
`%rankedsmp_rank_number%`	Rank as a number (0 if unranked)	`5` / `0`
`%rankedsmp_hearts%`	Player's max hearts	`24.0`
`%rankedsmp_potion_multiplier%`	Potion duration multiplier	`1.85`
`%rankedsmp_xp_multiplier%`	XP gain multiplier	`2.50`
`%rankedsmp_extra_slots%`	Extra inventory slot count	`18`
`%rankedsmp_rank_prefix%`	Rank prefix for TAB	`[#5]`
`%rankedsmp_rank_suffix%`	Rank suffix for TAB

⚠️ First Startup Note

On first launch, the plugin downloads required dependencies (JDA, Gson, MySQL connector, SQLite, HikariCP) from Maven Central. This only happens once — subsequent startups are instant. Make sure your server has internet access on first run.

💬 Support

For bug reports and feature requests, please use the Discord server.

📚 Wiki/Docs: Coming soon!

Made by mukulx (heckerx on Discord)

RankedSMPX

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details

🏆 RankedSMPX

⚙️ Configuration Preview

✨ Features

📈 Rank Buffs

📋 Commands

👤 Player Commands

🔧 Admin Commands

Migration from Old RankedSMP Plugin

`/rankrandom` Flags

💬 Discord Commands

Special Items

Judgement Hammer (Custom Mace)

Diamond Spear (1.21.11+)

🏷️ TAB Integration

With TAB Plugin

Without TAB Plugin (Vanilla)

📊 PlaceholderAPI Placeholders

⚠️ First Startup Note

💬 Support

RankedSMPX

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details

🏆 RankedSMPX

⚙️ Configuration Preview

✨ Features

📈 Rank Buffs

📋 Commands

👤 Player Commands

🔧 Admin Commands

Migration from Old RankedSMP Plugin

/rankrandom Flags

💬 Discord Commands

Special Items

Judgement Hammer (Custom Mace)

Diamond Spear (1.21.11+)

🏷️ TAB Integration

With TAB Plugin

Without TAB Plugin (Vanilla)

📊 PlaceholderAPI Placeholders

⚠️ First Startup Note

💬 Support

`/rankrandom` Flags