Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!

RankedSMPX

A highly configurable competitive ranked SMP plugin with rank-based perks

🏆 RankedSMPX

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.

✨ 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.

Hierarchy Hammer — Custom legendary mace weapon exclusive to Rank #1 with special dash and combat abilities. Fully configurable effects and cooldowns.

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. Configurable ignored effects list.

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.

Rank Management GUI — Intuitive GUI (/rsmp manage) to view and manage all ranks. Set, remove, or blacklist players with visual feedback. Left-click to promote, right-click to demote, shift-click for quick actions.

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.

Dragon Egg Locator — Real-time boss bar showing distance to nearest Dragon Egg holder. Configurable update interval and distance display. Prevents Dragon Egg storage in containers.

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. Full backup/restore system.

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 or /rsmp (both 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 the old RankedSMP plugin
`/rsmp manage`	`rankedsmp.gui`	Open the rank management GUI
`/rsmp rank set <player> <rank>`	`rankedsmp.set`	Set a player's rank directly
`/rsmp rank remove <player>`	`rankedsmp.remove`	Remove a player's rank
`/rsmp give hammer <player>`	`rankedsmp.admin`	Give Hierarchy 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
`/backup`	`rankedsmp.admin`	Create full database backup
`/restore <filename>`	`rankedsmp.admin`	Restore from backup file
`/rankfix`	`rankedsmp.admin`	Fix invalid ranks in the 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
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 <rank> [player] [username]`	Admin	Set a player's rank via Discord
`/rankrandom <rank> [include_ranked] [include_offline]`	Admin	Randomly assign rank with roulette animation
`/setchannel <type>`	Admin	Set leaderboard or updates channel
`/rankexport` / `/rankimport`	Admin	Export/import rank data as JSON

🏷️ 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

🔗 Discord Integration

Full-featured Discord bot with:

Account Linking: Link Minecraft accounts with 6-digit codes (/linkdiscord in-game, /link <code> in Discord)
Live Leaderboard: Auto-updating leaderboard with rank changes, hearts, and multipliers
Rank Notifications: DM players when they gain/lose ranks
Role Sync: Automatic Discord role assignment based on Minecraft rank
Slash Commands: All Discord commands use modern slash command interface
Updates Channel: Broadcast rank changes to a dedicated channel
Admin Commands: Manage ranks directly from Discord

Setup:

Configure discord.yml with your bot token
Enable desired features (linking, leaderboard, notifications, role sync)
Set channel IDs for leaderboard and updates
Configure role IDs for role sync (optional)
Reload plugin with /rsmp reload

⚠️ 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 & Bug Reports

Bug Reports & Feature Requests:

GitHub Issues: Create an issue - Preferred for detailed bug reports and feature requests
Discord Server: Join here - Quick support and community discussions
Support Development: Ko-fi - Buy me a coffee to support development

⚙️ Configuration Preview

Click to view config.yml

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

config-version: 7

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

# 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
  
  # Visual effects on death
  death-effects:
    # Lightning strike at victim's location when killed in PvP
    lightning-on-kill: false

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

# 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#{rank} &r{player}"
  # Format for unranked players
  unranked-format: "&7Unranked &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
  
  # Ignored Effects - Effects that should NOT be modified by the multiplier
  # Add negative/harmful effects here so they don't last longer
  # Effect names must match Minecraft's internal names
  ignored-effects:
    - DARKNESS
    - POISON
    - WITHER
    - HUNGER
    - WEAKNESS
    - SLOWNESS
    - MINING_FATIGUE
    - NAUSEA
    - BLINDNESS
    - INSTANT_DAMAGE
    - UNLUCK
    - BAD_OMEN
    - RAID_OMEN
    - LEVITATION
  
  # 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

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

# Hierarchy Hammer
# - Admins can manually give it with /rsmp give hammer <player>
# NOTE: The Hierarchy Hammer is still a bit buggy but functional. Will be improved in future versions.
hierarchy-hammer:
  enabled: true
  # Auto-give hammer at game start (disabled by default)
  # If false, admins must manually give it with /rsmp give hammer <player>
  auto-give-on-start: false
  # Only allow hitting players
  players-only: true
  # Item name 
  name: "§x§f§2§b§c§4§5§lʜ§x§f§2§b§f§4§b§lɪ§x§f§2§c§1§5§1§lᴇ§x§f§2§c§4§5§6§lʀ§x§f§2§c§6§5§c§lᴀ§x§f§2§c§9§6§2§lʀ§x§f§2§c§c§6§8§lᴄ§x§f§2§c§e§6§e§lʜ§x§f§2§d§1§7§3§lʏ §x§f§2§d§6§7§f§lʜ§x§f§2§d§9§8§5§lᴀ§x§f§2§d§b§8§b§lᴍ§x§f§2§d§e§9§0§lᴍ§x§f§2§e§0§9§6§lᴇ§x§f§2§e§3§9§c§lʀ"
  # Lore
  lore:
    - "&7A powerful hammer that manifested"
    - "&7as a result of improper judgement"
    - ""
    - "&6SENTENCING &fRMB"
    - "&7Launch forward, allowing you to initiate"
    - "&7hits with the weapon. This dash will stop"
    - "&7cooldown when a successful hit is initiated."
    - "&7Missing an attack will put it on cooldown."
    - ""
    - "&6VERDICT"
    - "&7After hitting 3 consecutive hits without"
    - "&7missing, your next hit is empowered."
  # Dash distance in blocks
  dash-distance: 5.0
  # Dash cooldown in seconds (0 = no cooldown, only limited by landing requirement)
  dash-cooldown: 0
  # Item cooldown after dash in seconds (disables the mace like chorus fruit/ender pearl)
  # This prevents using the mace immediately after dashing
  dash-item-cooldown: 10
  # Dash air time (how long player stays airborne, in ticks - 20 ticks = 1 second)
  dash-air-time: 15
  # Dash slow fall strength (0-5, higher = slower fall for better aiming)
  dash-slow-fall-strength: 3
  # Dash speed multiplier (how fast the player dashes forward)
  dash-speed: 0.9
  # Require landing before next dash (true = must land to dash again, false = unlimited air dashes)
  require-landing: true
  # Smash attacks needed for combo 
  combo-required: 3
  # Combo damage multiplier
  combo-damage-multiplier: 2.0
  # Combo explosion power (terrain destruction)
  combo-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
  
  # Mace smash bonus damage (when falling with hammer)
  mace-smash:
    # Enable mace smash bonus damage
    enabled: true
    # Damage multiplier (2.0 = 2x damage)
    damage-multiplier: 2.0
    # Minimum fall distance required (blocks)
    min-fall-distance: 1.5
  
  # Prevent storing Hierarchy Hammer in containers (enabled by default)
  # Blocks: chests, ender chests, barrels, shulker boxes, hoppers, extra inventory, etc.
  prevent-storage: true
  # Prevent dropping Hierarchy Hammer (disabled by default)
  # When enabled, hammer cannot be dropped with Q key
  prevent-drop: false

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

# 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
  # Prevent storing Dragon Egg in containers
  # Blocks: chests, ender chests, barrels, shulker boxes, hoppers, extra inventory, etc.
  prevent-storage: true
  # Prevent dropping Dragon Egg (disabled by default)
  # When enabled, Dragon Egg cannot be dropped with Q key
  prevent-drop: 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 Diamond Spear in containers
  # Blocks: chests, ender chests, barrels, shulker boxes, hoppers, extra inventory, etc.
  prevent-storage: true
  # Prevent dropping Diamond Spear (disabled by default)
  # When enabled, spear cannot be dropped with Q key
  prevent-drop: false
  # 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

# 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
  # Prevent storing Dragon Egg in containers
  # Blocks: chests, ender chests, barrels, shulker boxes, hoppers, extra inventory, etc.
  # Also prevents dropping the Dragon Egg
  prevent-storage: false

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

# 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%❤ "
#
tab-integration:
  enabled: true
  
  # Unranked player prefix (no rank assigned)
  # Format: &e[&8UNRANKED&e] = yellow brackets with dark gray text
  unranked-prefix: '&e[&8UNRANKED&e] '
  unranked-suffix: ''
  
  # Blacklisted player prefix (cannot receive ranks)
  blacklisted-prefix: '&0[&8BLACKLISTED&0] '
  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.)
  # 
  # DEFAULT: Original style (legacy colors)
  # - Ranked players: &e[#X] (Yellow)
  # - Unranked: &7[Unranked] (Gray)
  #
  # To change to modern gradients: Use /rsmp modern (requires TAB plugin)
  # To revert to original: Use /rsmp original
  #
  # Modern gradient examples (requires TAB plugin):
  #   Ranks 1-5: &#FFD700[&#FFAA00#1&#FFD700] (Gold to Orange)
  #   Ranks 6-10: &#C0C0C0[&#A4D7E8#6&#C0C0C0] (Silver to Light Blue)
  #   Ranks 11-15: &#32CD32[&#5FE47E#11&#32CD32] (Green to Lime)
  #   Ranks 16-20: &#8A2BE2[&#C21FB7#16&#8A2BE2] (Purple to Pink)
  rank-prefixes:
    1: '&e[#1] '
    2: '&e[#2] '
    3: '&e[#3] '
    4: '&e[#4] '
    5: '&e[#5] '
    6: '&e[#6] '
    7: '&e[#7] '
    8: '&e[#8] '
    9: '&e[#9] '
    10: '&e[#10] '
    11: '&e[#11] '
    12: '&e[#12] '
    13: '&e[#13] '
    14: '&e[#14] '
    15: '&e[#15] '
    16: '&e[#16] '
    17: '&e[#17] '
    18: '&e[#18] '
    19: '&e[#19] '
    20: '&e[#20] '
  
  # 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

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

# Extra Settings - Additional options
extra:
  # Show extra pointless messages on startup 
  extra-pointless-messages: true

Made by mukulx (heckerx on Discord)

Information

Category	Gameplay
Published on	May 4, 2026
License	Unspecified
Downloads	66
Stars	0
Watchers	0

Pinned Versions

2.1.3
Release
1.21-26.1.2

Pages

Resource Page

Members

mukulx

Owner