# EloRanks<\/p>\n
A competitive 1v1 Elo-based ranking system for Minecraft 1.21 servers with matchmaking, auto-arena loading, and dynamic K-factor.<\/p>\n
## Features<\/p>\n
– **Elo Rating System**: Dynamic K-factor based on games played and Elo rating
\n– **Placement Matches**: 5 placement matches for new players with bonus Elo for beating higher-rated opponents
\n– **Matchmaking**: Queue-based matchmaking with expanding Elo range over time
\n– **Auto-Arena Loading**: FAWE-based arena system with automatic loading\/unloading
\n– **1v1 Duels**: UHC-style kits with custom countdown timers
\n– **Surrender**: Available after 30 seconds – instant loss (full Elo penalty)
\n– **Scoreboard & Bossbar**: Real-time rank, Elo, and opponent health display
\n– **Ranked Nametags**: Color-coded rank prefixes on nametags (#1-50)
\n– **Detailed Config**: Highly customizable with extensive options
\n– **Auto Update Checker**: Notifies server owners when a new version is available on Modrinth<\/p>\n
## Commands<\/p>\n
### Player Commands<\/p>\n
| Command | Aliases | Description | ### Admin Commands (`\/eradmin`)<\/p>\n | Command | Aliases | Description | ` | `resetp` | Reset specific player’s stats | ` | `cancelduel` | End a player’s active duel | ` | | Heal a player | ` | | Feed a player | **Permission**: `er.admin` (defaults to OP)<\/p>\n ## Permissions<\/p>\n | Permission | Description | ## Configuration<\/p>\n All configuration is stored in `config.yml` (generated on first run).<\/p>\n ### Elo Settings ### Duel Settings ### Surrender Settings ### Matchmaking Settings ### Countdown Settings ### Arena Settings ### Kit Settings ### Potion Effects ### World & Gameplay gameplay: ### Scoreboard & Bossbar bossbar: ### Chat Messages ### Debug Settings ## Requirements<\/p>\n – Minecraft Paper 1.21+ ## Installation<\/p>\n 1. Install **FastAsyncWorldEdit** on your server ## Arena Setup<\/p>\n 1. Build your arena in Minecraft using WorldEdit ## How It Works<\/p>\n ### Elo Calculation ### Matchmaking ### Duel Flow ### Surrender ## Building<\/p>\n “`bash The built JAR will be in `target\/EloRanks-{version}.jar`<\/p>\n ## License<\/p>\n MIT License<\/p>\n ## Changelog<\/p>\n ### v2.1.0 ### v2.0.1 ### v2.0.0  A competitive 1v1 Elo-based ranking system for Minecraft 1.21 servers with matchmaking, auto-arena loading, and dynamic K-factor.<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"eloranks","_minecraft_project_id":"KZHk8AqA","_minecraft_author":"i_c0de","_minecraft_license":"MIT","_minecraft_downloads":36,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"eloranks.zip","_minecraft_size_bytes":432342,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-15T21:46:37.064814Z","_minecraft_date_created":"2026-04-02T21:06:52.149391Z","_minecraft_date_modified":"2026-05-09T07:47:40.264665Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/eloranks","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-03T14:46:46+00:00","_minecraft_import_hash":"931bf5c3fa6fc25869b693f777104607","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[127],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-62382","mod","type-mod","status-publish","hentry","mod_category-paper","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|———|———|————-|
\n| `\/er` | `elo`, `elostats`, `erstats` | View your Elo stats and rank |
\n| `\/er
\n| `\/er top` | | View top players |
\n| `\/duel
\n| `\/duel accept
\n| `\/duel decline
\n| `\/duel match` | `queue`, `mm` | Enter matchmaking queue |
\n| `\/duel cancel` | `stop` | Cancel matchmaking |
\n| `\/surrender` | `forfeit`, `sq` | Surrender from active duel (30s min) |
\n| `\/leaderboard` | `lb` | View global Elo leaderboard |<\/p>\n
\n|———|———|————–|
\n| `makeduel
\n| `addarena` | `createarena` | Add new arena instance |
\n| `reload` | `rl` | Reload configuration |
\n| `resetall` | `wipedata` | Reset all player data |
\n| `resetplayer <\/p>\n
\n| `setelo <\/p>\n
\n| `adde <\/p>\n
\n| `arenainfo` | `arenastatus` | Show arena information |
\n| `forcereset
\n| `endduel <\/p>\n
\n| `tparena [p] [id]` | `arenatp` | Teleport to arena |
\n| `getpos
\n| `heal <\/p>\n
\n| `feed <\/p>\n
\n| `stats` | `plstats` | Show plugin statistics |
\n| `debug` | `diag` | Show debug information |<\/p>\n
\n|————|————-|
\n| `er.duel` | Allow dueling other players |
\n| `er.duel.request` | Allow sending duel requests |
\n| `er.duel.accept` | Allow accepting duel requests |
\n| `er.duel.matchmaking` | Allow using matchmaking queue |
\n| `er.duel.surrender` | Allow surrendering from duels |
\n| `er.stats.view` | Allow viewing own stats |
\n| `er.stats.view.others` | Allow viewing other players’ stats |
\n| `er.leaderboard` | Allow viewing the leaderboard |
\n| `er.admin` | Admin access |<\/p>\n
\n“`yaml
\nelo:
\n starting: 1000 # Starting Elo for new players
\n min: 0 # Minimum Elo
\n max: 10000 # Maximum Elo
\n k-factor:
\n win: 32 # Base K-factor for wins
\n draw: 16 # Base K-factor for draws
\n dynamic:
\n enabled: true # Enable dynamic K-factor
\n by-games:
\n enabled: true
\n threshold: 20 # Games before reducing K
\n new-player-k: 48 # K-factor for new players (first games)
\n by-elo:
\n enabled: true
\n threshold-1: 1500 # First Elo threshold
\n threshold-2: 2000 # Second Elo threshold
\n k-at-1500: 24 # K at first threshold
\n k-at-2000: 16 # K at second threshold
\n placement:
\n enabled: true
\n min-players: 5 # Players needed for placement system
\n match-count: 5 # Placement matches
\n k-factor-games: 5 # K-factor for placement games
\n bonus-beating-higher: true # Bonus Elo for beating higher-rated players
\n“`<\/p>\n
\n“`yaml
\nduel:
\n cooldown: 60 # Seconds between duels
\n request-timeout: 30 # Request expiration (seconds)
\n arena-world: “duel_arena” # World for arenas
\n allow-spectators: true
\n spectator-permission: “er.spectate”
\n“`<\/p>\n
\n“`yaml
\nsurrender:
\n enabled: true
\n min-duel-time-seconds: 30 # Must wait 30 seconds before surrendering
\n instant-loss: true # Full Elo penalty (not halved)
\n“`<\/p>\n
\n“`yaml
\nmatchmaking:
\n enabled: true
\n initial-elo-range: 50 # Starting Elo range
\n range-increase-per-second: 10 # Range increase per second
\n max-elo-range: 500 # Maximum range
\n bidirectional-check: true # Both players must be in range
\n check-interval-seconds: 1
\n“`<\/p>\n
\n“`yaml
\ncountdown:
\n teleport-seconds: 5 # Teleport countdown duration
\n duel-start-seconds: 20 # Duel start countdown duration
\n show-title: true # Show title
\n show-subtitle: true # Show subtitle
\n show-chat-messages: true # Show chat messages
\n colors:
\n seconds-20-to-6: “BLUE”
\n second-5: “DARK_RED”
\n second-4: “RED”
\n second-3: “GOLD”
\n second-2: “YELLOW”
\n second-1: “GREEN”
\n“`<\/p>\n
\n“`yaml
\narena:
\n initial-count: 10 # Initial arena count
\n spacing: 100 # Distance between arenas
\n schematic: “cloudy.schematic”
\n auto-expand: true # Auto-add arenas when needed
\n expand-count: 5 # Arenas to add when expanding
\n respawn-delay: 3 # Respawn delay (seconds)
\n load-timeout: 10 # Schematic load timeout
\n“`<\/p>\n
\n“`yaml
\nkit:
\n enabled: true
\n sword: “DIAMOND_SWORD”
\n bow: “BOW”
\n arrows: 64
\n helmet: “DIAMOND_HELMET”
\n chestplate: “DIAMOND_CHESTPLATE”
\n leggings: “DIAMOND_LEGGINGS”
\n boots: “DIAMOND_BOOTS”
\n offhand: “SHIELD”
\n food: “GOLDEN_APPLE:10”
\n blocks: “COBWEB:16,OAK_PLANKS:64”
\n buckets: “WATER_BUCKET,LAVA_BUCKET”
\n“`<\/p>\n
\n“`yaml
\neffects:
\n speed: true
\n speed-level: 2
\n speed-duration: 180 # 3 minutes in seconds
\n strength: true
\n strength-level: 2
\n strength-duration: 180
\n“`<\/p>\n
\n“`yaml
\nworld:
\n void-world: true # Arena is void world
\n spawn-protection: false
\n pvp-enabled: true<\/p>\n
\n fall-damage: false
\n fire-damage: false
\n hunger-depletion: false
\n keep-inventory: true
\n natural-regeneration: false
\n potion-effects-disabled: true
\n“`<\/p>\n
\n“`yaml
\nscoreboard:
\n enabled: true
\n show-title: true
\n title-animation: true
\n show-rank: true
\n show-elo: true
\n show-world: true
\n show-opponent-in-duel: true
\n update-interval: 2 # seconds<\/p>\n
\n enabled: true
\n show-opponent-health: true
\n health-update-interval: 5
\n“`<\/p>\n
\n“`yaml
\nchat:
\n duel-request: true
\n duel-start: true
\n duel-end: true
\n rank-up: true
\n matchmaking-search: true
\n pre-duel-instructions: true
\n“`<\/p>\n
\n“`yaml
\ndebug-mode: false
\ndebug:
\n show-elo-calculations: false
\n show-matchmaking: false
\n show-countdown: false
\n“`<\/p>\n
\n– FAWE (FastAsyncWorldEdit) for arena system
\n– WorldGuard (recommended for arena protection)<\/p>\n
\n2. Place `EloRanks-2.1.0.jar` in your `plugins` folder
\n3. Restart or reload the server
\n4. Configure `config.yml` as needed
\n5. Add your arena schematic to `plugins\/EloRanks\/arenas\/`<\/p>\n
\n2. Place **RED_WOOL** where you want player 1 to spawn
\n3. Place **BLUE_WOOL** where you want player 2 to spawn
\n4. Export the arena as a `.schematic` file (using FAWE: `\/schem save name`)
\n5. Name it `cloudy.schematic` (or match your config)
\n6. Place the schematic in `plugins\/EloRanks\/arenas\/`<\/p>\n
\n– K-factor starts at 48 for new players (first 5 placement games)
\n– K-factor reduces as players gain games and Elo
\n– Higher-rated players have less to gain, more to lose
\n– Bonus Elo for beating higher-rated players during placement<\/p>\n
\n– Players join queue with `\/duel match`
\n– Elo range starts at 50 and increases by 10 per second
\n– Maximum range is 500 Elo
\n– Both players must be in each other’s range to match<\/p>\n
\n1. Player A challenges Player B (or both use matchmaking)
\n2. Player B accepts the challenge (or auto-matched)
\n3. Both players see 5-second teleport countdown
\n4. 20-second countdown with color progression before fight:
\n – Seconds 20-6: Blue
\n – Second 5: Dark Red
\n – Second 4: Red
\n – Second 3: Orange
\n – Second 2: Yellow
\n – Second 1: Green
\n – Second 0: GO!
\n5. Fight until one player dies or surrenders (30s minimum)
\n6. Winner gains Elo, loser loses Elo<\/p>\n
\n– Available after 30 seconds of duel start
\n– Counts as instant loss – full Elo penalty applied
\n– Opponent receives full Elo reward (no halving)<\/p>\n
\n# Using the build script
\ncd EloRanks
\nmvn clean package
\n“`<\/p>\n
\n– Added automatic Modrinth update checker – notifies server owners when a new version is available<\/p>\n
\n– Minor bug fixes and improvements<\/p>\n
\n– Initial release with full Elo ranking system
\n– Matchmaking queue
\n– Auto-arena loading with FAWE
\n– 1v1 duels with UHC-style kits
\n– Dynamic K-factor based on games played and Elo rating
\n– Placement matches for new players
\n– Surrender feature
\n– Scoreboard and bossbar display<\/p>\n
\n<\/p>\n","protected":false},"excerpt":{"rendered":"