// Discord Bot — Minecraft PvP Tier Testing

MC TIER
SYSTEM

Skill-based tier testing and ranked matchmaking for Minecraft PvP. Testers evaluate players across 10 combat categories, assigning them tiers from LT5 to HT1 — a full 15-tier ranking system.

Discord.js v14 SQLite (sql.js) Node.js MIT License 10 Categories 15 Tiers 150 Roles
Get Started How It Works

// Tier Rankings

15-Tier System

Level
High Tier
Mid Tier
Low Tier
1 — Best
HT1
MT1
LT1
2
HT2
MT2
LT2
3
HT3
MT3
LT3
4
HT4
MT4
LT4
5 — Lowest
HT5
MT5
LT5

Tester Requirement

Players must reach LT3 or better in a category to become a tester for it. LT = Low Tier (worst of that number), MT = Mid Tier, HT = High Tier (best).

// Combat Categories

10 Categories

Dia SMP
Cart
Sword
Axe
UHC
SMP
Dia Pot
Nethop
Mace
CPVP

// Explore

Bot Features

⌨️

Commands

Full slash command reference — player, tester, staff, and prefix commands with detailed descriptions.

Quick Start

5-step setup guide, environment variables, role customization, and deploy instructions.

🔄

Queue System

Self-training wait time estimation, conflict-of-interest checks, 30-second matching cycle.

⚔️

Challenge System

Player-vs-player challenges with 48-hour expiry, dual submission, and dispute handling.

🏆

Ladder & Bridge

Ranked ladder with W/L tracking per category. Bridge requests to advance tiers by beating opponents.

⚖️

Appeals & Probation

24-hour appeal window, senior panel review, tester probation system with strike tracking.

📢

Announcements

Schedule message reposts with CST timezone support. Missed announcement recovery via DM.

🗄️

Architecture

15+ database tables, modular code structure, pure-JS SQLite with sql.js — zero native dependencies.

// By the Numbers

At a Glance

📊

150 Roles

15 tiers × 10 categories = 150 Discord roles auto-created by /setup run.

⏱️

30s Cycle

Queue processor checks every 30 seconds. Minimum 4 players before matching begins.

🔒

14-Day Cooldown

Players get a 14-day retest cooldown per category after being placed.

📋

5 Tests/Day

Testers capped at 5 tests per day total to prevent burnout.