🛡️ ShitterList

Fabric client mod for Hypixel Skyblock
Auto-kick unwanted players from your Party Finder group

---

What it does

When a player joins your dungeon group via Party Finder, ShitterList looks up their UUID and checks it against your local ban list. If matched — it warns the party and kicks the player automatically.

Party Finder > SomePlayer joined the dungeon group! (Mage Level 50)
[SL] SomePlayer is a shitter. Reason: cheater

---

Features

• 🔍 Auto-detect — reads Party Finder join messages in real time
• ⚡ Auto-kick — sends /pc warning then /p kick with a safe delay
• 📋 Local ban list — stored in config/shitters.txt, survives updates
• 🔄 Bulk resolve — /sl parse converts all Unknown UUIDs to nicknames
• 🛡️ Cooldown — 5s per player to prevent double-kick
• 📄 Pagination — /sl list shows 10 players per page

---

Commands

Command	Alias	Description
/sl add <nick> [reason]	/sla	Add player to ban list
/sl remove <nick>	/slr	Remove player from ban list
/sl list [page]	/sll	Show ban list (10 per page)
/sl parse	—	Resolve all Unknown nicknames
/sl help	—	Show command reference
/shitter	—	Full alias for /sl

---

Ban list format

The config/shitters.txt file uses standard JSON — you can edit it manually or import an existing list:

[
  {"uuid": "c328d843adbd440bab3afca74469bae5", "reason": "cheater"},
  {"uuid": "29a5ab7f9c2b4e4fad0cdc3328a6eb9c", "reason": "1"}
]

The nickname field is optional — if missing, it will show as Unknown until you run /sl parse.

---

Installation

1. Install Fabric Loader
2. Download and place in your .minecraft/mods/ folder:
   • Fabric API
   • Fabric Language Kotlin
   • ShitterList .jar
3. Launch Minecraft and join Hypixel

---

Requirements

Dependency	Version
Minecraft	1.21.11
Fabric Loader	≥ 0.15.0
Fabric API	≥ 0.141.4
Fabric Language Kotlin	≥ 1.13.0

---

Building from source

git clone https://github.com/yourname/shitterlist
cd shitterlist
./gradlew remapJar

Output: build/libs/shittermod-2.0.0.jar

---

How it works

Party Finder message received
        ↓
Strip §X color codes
        ↓
Extract nickname (no regex)
        ↓
Fetch UUID from api.mojang.com
        ↓
Check against shitters.txt
        ↓
Match found → wait 800ms → /pc warning → wait 300ms → /p kick

---

Made by qwertycry • MIT License